API
오디언스 비우기
한 트랜잭션으로 오디언스에서 모든 연락처를 뺍니다. 오디언스는 ID, 이름, 설명과 함께 남고, 각 연락처는 주소록, 기본 오디언스, 다른 오디언스에 그대로 남습니다.
POSTapi.openemail.uk/audiences/{id}/empty
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /audiences/{id}/empty
한 트랜잭션으로 오디언스에서 모든 연락처를 뺍니다. 오디언스는 ID, 이름, 설명과 함께 남고, 각 연락처는 주소록, 기본 오디언스, 다른 오디언스에 그대로 남습니다.
예시
audiences:write가 필요합니다. 본문은 없습니다.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/empty" -H "$AUTH"{ "object": "audience", "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "description": "Customers who asked to hear about releases", "builtin": null, "contactCount": 0, "lastContactAt": null, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z", "removed": 3}응답은 현재 상태의 오디언스에 뺀 멤버십 수인 removed를 더한 것입니다. 이미 비어 있는 오디언스를 비우면 removed: 0이 반환됩니다.
되돌릴 수 없으며, 누가 목록에 있었는지 어디에도 기록되지 않습니다. 나중에 되돌리고 싶을 수 있다면 먼저 GET /audiences/{id}/contacts를 끝까지 읽어 두세요. 앱은 목록을 비우기 전에 본인 확인을 요구하지만 키에는 그런 단계가 없으므로, audiences:write는 신중하게 부여하세요.
기본 제공 기본 오디언스는 비울 수 없습니다. 그 호출은 409 audience_immutable로 거부됩니다.