Eine Audience leeren
Nimmt in einer Transaktion jeden Kontakt aus der Audience. Die Audience bleibt, mit ihrer ID, ihrem Namen und ihrer Beschreibung, und jeder Kontakt bleibt im Adressbuch, in der Standard-Audience und in seinen anderen Audiences.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences/{id}/empty
Nimmt in einer Transaktion jeden Kontakt aus der Audience. Die Audience bleibt, mit ihrer ID, ihrem Namen und ihrer Beschreibung, und jeder Kontakt bleibt im Adressbuch, in der Standard-Audience und in seinen anderen Audiences.
Beispiel
Erfordert audiences:write. Es gibt keinen Body.
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}Die Antwort ist die Audience in ihrem jetzigen Zustand plus removed, die Zahl der entfernten Mitgliedschaften. Eine bereits leere Audience zu leeren ergibt removed: 0.
Es gibt kein Rückgängig, und nichts hält fest, wer in der Liste war. Gehen Sie zuerst GET /audiences/{id}/contacts durch, wenn Sie sie vielleicht zurückhaben wollen. Die App lässt die Person bestätigen, wer sie ist, bevor sie eine Liste leert, und ein Schlüssel hat keinen solchen Schritt, vergeben Sie audiences:write also bewusst.
Die eingebaute Standard-Audience kann nicht geleert werden. Dieser Aufruf wird mit 409 audience_immutable abgelehnt.