Aller à la documentation
API

Retirer un contact d'une audience

Retire une seule appartenance et ne touche à rien d'autre. Le contact reste dans le carnet d'adresses, reste dans l'audience par défaut et reste dans toutes les autres audiences où il se trouvait.

DELETEapi.openemail.uk/audiences/{id}/contacts/{email}

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

DELETE /audiences/{id}/contacts/{email}

Retire une seule appartenance et ne touche à rien d'autre. Le contact reste dans le carnet d'adresses, reste dans l'audience par défaut et reste dans toutes les autres audiences où il se trouvait.

Exemple

Nécessite audiences:write. Encodez le @ dans l'URL.

curl
curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"
Réponse
{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

Un contact qui ne se trouve pas dans cette audience donne un 404 : une faute de frappe ne peut donc pas faire état d'un retrait qui n'a jamais eu lieu.

L'audience par défaut intégrée ne peut pas être dégarnie. Cet appel est refusé avec 409 audience_immutable, car elle contient chaque contact aussi longtemps qu'il est un contact. Supprimez le contact quand c'est le contact que vous voulez voir disparaître.

Retirer le dernier contact laisse l'audience en place, et vide.