ドキュメント本文へスキップ
API

オーディエンスを削除する

オーディエンスを削除し、それが保持していたすべてのメンバーシップを同一トランザクションで削除します。連絡先そのものには手を触れません。連絡先はアドレス帳に残り、デフォルトオーディエンスにも、それまで入っていた他のどのオーディエンスにも残ります。

DELETEapi.openemail.uk/audiences/{id}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

DELETE /audiences/{id}

オーディエンスを削除し、それが保持していたすべてのメンバーシップを同一トランザクションで削除します。連絡先そのものには手を触れません。連絡先はアドレス帳に残り、デフォルトオーディエンスにも、それまで入っていた他のどのオーディエンスにも残ります。

audiences:write が必要です。

curl
curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH"
レスポンス
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "deleted": true}

組み込みのデフォルトオーディエンスは削除できません。その呼び出しは 409 audience_immutable で拒否されます。デフォルトオーディエンスこそが、アドレス帳をリストとして読めるようにしているものだからです。

取り消しはできません。同じ名前で新しいオーディエンスを作っても、中身は空です。