Очистка аудитории
Убирает все контакты из аудитории одной транзакцией. Аудитория остаётся, со своим идентификатором, именем и описанием, а каждый контакт остаётся в адресной книге, в аудитории по умолчанию и в своих других аудиториях.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
POST /audiences/{id}/empty
Убирает все контакты из аудитории одной транзакцией. Аудитория остаётся, со своим идентификатором, именем и описанием, а каждый контакт остаётся в адресной книге, в аудитории по умолчанию и в своих других аудиториях.
Пример
Требует 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.