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

スレッドの送信者の購読を解除する

閲覧ペインの「購読を解除」ボタンと同じ動作。

POST/threads/{id}/unsubscribe

実際の呼び出しをワークスペースに対して実行します。

POST /threads/{id}/unsubscribe

閲覧ペインの「購読を解除」ボタンと同じ動作。

例

threads:write が必要です。スレッド内で List-Unsubscribe ヘッダーを持つ最新のメッセージから、その背後にある購読を見つけ、POST /subscriptions/{id}/unsubscribe と同じように、送信者が求める方法で購読を解除します。

curl
curl -X POST "$OE/threads/thr_7c1e4a90/unsubscribe" -H "$AUTH"
レスポンス
{  "object": "unsubscribe",  "threadId": "thr_7c1e4a90",  "subscriptionId": "sub_5d2c8e17",  "method": "email",  "url": null,  "binned": 0}

そのヘッダーを持つメッセージが 1 通もないスレッドは、購読を解除する手段がない送信者と同じく 422 unsubscribe_unsupported になり、リクエストを受け付けなかった送信者は 502 unsubscribe_refused になります。キーが届かないスレッドは 404 になります。

リファレンス