Claude API

Claude Platform Organization Webhooksベータ発表 — エンドカスタマーのエンフォースメントアクション(制限・BAN)発生時にWebhookで即時通知

元記事を読む(platform.claude.com) ↗

Summary

10月20日のPlatform Release NotesでOrganization Webhooksがベータ発表(`webhooks-2026-10-07`ベータヘッダーで有効化)。Admin APIの`/v1/organizations/webhooks`エンドポイントでWebhookエンドポイントを登録し、User Profilesに対するエンフォースメントアクション(制限・BAN)の発生・解除を即時に受信可能。2種のイベントタイプ: `user_profile.enforcement_action_opened`(制限・BAN開始)と`user_profile.enforcement_action_resolved`(制限・BAN解除)。Standard Webhooks仕様に準拠し署名検証をサポート。5秒以内の2xx応答が必要で、失敗時は自動リトライ。1組織最大32エンドポイント。HTTPS port 443・パブリックドメイン名が必須。HIPAA有効化組織では利用不可。現時点ではイベント配信は未開始で、エンドポイント登録とハンドラー構築の準備段階。

Key Takeaways

  • ▸ User Profilesのエンフォースメントアクション(制限・BAN)の開始・解除をWebhookで即時通知
  • ▸ Standard Webhooks仕様準拠で署名検証をサポート — 既存Webhook受信インフラに統合可能
  • ▸ `webhooks-2026-10-07`ベータヘッダーで有効化 — 全8言語SDK+CLIがヘッダーを自動送信
  • ▸ イベント配信は未開始だがエンドポイント登録・ハンドラー構築の先行準備が可能
  • ▸ 1組織最大32エンドポイント・HIPAA有効化組織では利用不可

Best Practice Updates

  • ✓ API再販・プラットフォーム事業者はUser Profiles API+Organization Webhooksの組み合わせでエンドカスタマーのエンフォースメント状態をリアルタイム追跡する設計を先行構築すべき
  • ✓ Webhookハンドラーではイベント重複(同一`webhook-id`)への冪等処理とプロファイル現在状態の取得を組み合わせた設計が推奨

Same Day Signals

すべて見る →

元記事の著作権は各著作者に帰属します。