API

Mettre à jour une audience

Une mise à jour partielle. Un champ que vous omettez conserve sa valeur enregistrée, et un `null` explicite l'efface. L'audience par défaut intégrée peut être renommée et décrite comme n'importe quelle autre, et la renommer ne change ni `builtin` ni ce qu'elle contient.

PATCHapi.openemail.uk/audiences/{id}

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

PATCH /audiences/{id}

Une mise à jour partielle. Un champ que vous omettez conserve sa valeur enregistrée, et un null explicite l'efface. L'audience par défaut intégrée peut être renommée et décrite comme n'importe quelle autre, et la renommer ne change ni builtin ni ce qu'elle contient.

Exemple

Nécessite audiences:write.

curl

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

Réponse

{  "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 ne peut être ni défini, ni déplacé, ni effacé depuis ici.

Renommer ne déplace personne. Les contacts restent dans l'audience sous son nouveau nom, et l'id ne change jamais.