Kalo te dokumentacioni
API

Zbrazni një audiencë

Heq çdo kontakt nga audienca në një transaksion të vetëm. Audienca mbetet, me id-në, emrin dhe përshkrimin e saj, dhe çdo kontakt mbetet në librin e adresave, në audiencën e parazgjedhur dhe në audiencat e tjera të veta.

POSTapi.openemail.uk/audiences/{id}/empty

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

POST /audiences/{id}/empty

Heq çdo kontakt nga audienca në një transaksion të vetëm. Audienca mbetet, me id-në, emrin dhe përshkrimin e saj, dhe çdo kontakt mbetet në librin e adresave, në audiencën e parazgjedhur dhe në audiencat e tjera të veta.

Shembull

Kërkon audiences:write. Nuk ka trup.

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/empty" -H "$AUTH"
Përgjigje
{  "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}

Përgjigjja është audienca siç është tani, plus removed, numri i anëtarësimeve të hequra. Zbrazja e një audience që është tashmë bosh jep removed: 0.

Nuk ka kthim pas, dhe asgjë nuk regjistron kush ishte në listë. Përshkoni fillimisht GET /audiences/{id}/contacts nëse mund ta doni përsëri. Aplikacioni i kërkon personit të konfirmojë kush është para se të zbrazë një listë, ndërsa një çelës nuk e ka këtë hap, prandaj jepeni audiences:write me kujdes.

Audienca e parazgjedhur e integruar nuk mund të zbrazet. Kjo thirrje refuzohet me 409 audience_immutable.