API

Eine Audience aktualisieren

Eine partielle Aktualisierung. Ein weggelassenes Feld behält seinen gespeicherten Wert, ein ausdrückliches `null` leert es. Die eingebaute Standard-Audience lässt sich wie jede andere umbenennen und beschreiben; das Umbenennen ändert weder `builtin` noch ihren Inhalt.

PATCHapi.openemail.uk/audiences/{id}

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

PATCH /audiences/{id}

Eine partielle Aktualisierung. Ein weggelassenes Feld behält seinen gespeicherten Wert, ein ausdrückliches null leert es. Die eingebaute Standard-Audience lässt sich wie jede andere umbenennen und beschreiben; das Umbenennen ändert weder builtin noch ihren Inhalt.

Beispiel

Erfordert audiences:write.

curl

curl -X PATCH "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Release notes"}'

Antwort

{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Release notes",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:22:00.000Z"}

builtin kann von hier aus weder gesetzt noch verschoben noch geleert werden.

Das Umbenennen verschiebt niemanden. Die Kontakte bleiben in der Audience unter ihrem neuen Namen, und die id ändert sich nie.