Vider une audience
Retire tous les contacts de l'audience en une seule transaction. L'audience reste, avec son identifiant, son nom et sa description, et chaque contact reste dans le carnet d'adresses, dans l'audience par défaut et dans ses autres audiences.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /audiences/{id}/empty
Retire tous les contacts de l'audience en une seule transaction. L'audience reste, avec son identifiant, son nom et sa description, et chaque contact reste dans le carnet d'adresses, dans l'audience par défaut et dans ses autres audiences.
Exemple
Nécessite audiences:write. Il n'y a pas de corps.
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}La réponse est l'audience dans son état actuel, plus removed, le nombre d'appartenances retirées. Vider une audience déjà vide répond removed: 0.
Il n'y a pas de retour en arrière, et rien ne garde trace de qui était dans la liste. Parcourez GET /audiences/{id}/contacts d'abord si vous risquez d'en avoir besoin. L'application demande à la personne de confirmer son identité avant de vider une liste, et une clé n'a pas cette étape : accordez donc audiences:write en connaissance de cause.
L'audience par défaut intégrée ne peut pas être vidée. Cet appel est refusé avec 409 audience_immutable.