Webhookの削除

Webhookの削除

Box上のファイルやフォルダからWebhookを削除するには、削除するWebhookのIDをAPIに渡す必要があります。

cURL
curl -i -X DELETE "https://api.box.com/2.0/webhooks/3321123" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"

Webhook ID

WebhookのIDを調べるには、すべてのWebhookのリストを取得エンドポイントを使用します。

その他の削除の理由

APIを使用していなくても、Webhookが削除される場合があります。

Webhookは以下の理由で削除される可能性があります。

  1. Boxアプリケーションを削除すると、アプリケーションに関連付けられているすべてのWebhookが削除されます。
  2. Webhookに関連付けられているすべてのアクセストークンを削除した場合。
  3. システムで決められている時間内にWebhookを配信できなかった場合、BoxによってそのWebhookが自動的に削除されます。

これらのすべてのケースで、BoxはWEBHOOK.DELETEDイベント名を含むWebhookペイロードを通知URLに送信します。この場合、ペイロードの本体には以下の追加情報が含まれます。

"additional_info": {
  "reason": "auto_cleanup"
}