Admin API(Claude API)

主な用途は、入退社に伴うオンボーディングとオフボーディングの自動化、ワークスペースへのアクセス管理、API キーの監査です。

Admin API は次の資格情報を受け付けます。

• Admin API キー:sk-ant-admin... で始まるキーを x-api-key ヘッダーで送ります。発行できるのは admin ロールを持つ組織メンバーだけです。
• OAuth bearer token:org:admin スコープ付きのトークンを authorization: Bearer ヘッダーで送ります。取得できるのは admin、owner、primary owner のいずれかのロールを持つメンバーだけです。
• personal key / service account key:特定のワークスペースにスコープされていないキーを x-api-key ヘッダーで送ります。キーは紐づくアカウントと同じ権限を持ちます。

サービスアカウント、ワークロード ID フェデレーションの発行者とルールのエンドポイントは、org:admin OAuth トークンだけを受け付けます。org:admin トークンは、元になるプロファイルやフェデレーションのルールがどのワークスペースに紐づいていても、組織全体へのアクセス権を持ちます。

SDK では client.organization、ant CLI では ant organization の下でエンドポイントを呼び出します。/v1/organizations/me エンドポイントは、使っている資格情報が属する組織を返します。

ant CLI と各 SDK は、組織情報、メンバー、招待、ワークスペースとそのメンバー、API キー、レート制限、サービスアカウント、ワークロード ID フェデレーションの発行者とルール、顧客管理の暗号化キーを扱えます。ant CLI 1.37.0 と各 SDK では、これらにコンプライアンス設定を加えたメソッドが client.organization と ant organization の下で呼び出せます。

一方、使用量・コストレポートと、Claude Enterprise のユーザー管理・分析エンドポイントは、引き続き curl だけで利用します。

Admin API で、Claude Enterprise(claude.ai)組織のメンバーも管理できます。対象の操作は次のとおりです。

• メンバーの一覧取得とメールアドレスでの検索
• メンバーのロール変更と削除
• 招待の送信と取り消し
• グループとそのメンバーの管理
• カスタムロールの読み取り

read:org_audit スコープを持つ Admin API キーは、ユーザー管理のすべての GET エンドポイントを呼び出せます。Admin API の Claude Enterprise エンドポイント(ユーザー管理と支出上限)には、すべてのリクエストで anthropic-version ヘッダーを送る必要があります。グループとカスタムロールのリクエストでは、anthropic-beta: ce-user-management-2026-07-13 ヘッダーは不要で、送っても変わらず受け付けられます。

Claude Enterprise 組織のユーザー管理は、すべての Claude Enterprise 組織向けにベータとして始まり、その後ベータを終えています。組織 Webhook は webhooks-2026-10-07 ベータヘッダーを使うベータ機能で、利用を申請するには Anthropic のアカウントチームに連絡します。Admin API のそれ以外の部分の対象プランは、公式のリリースノートには記載がありません。

• Admin API では API キーを作成できません。API キーは Claude Console で作成し、Admin API では既存のキーの読み取り、名前の変更、ステータスの変更だけを行います。
• Admin API では admin ロールを持つメンバーを削除できません。
• ユーザーを組織から削除すると、そのユーザーの personal key は動作しなくなります。ワークスペースの API キーは引き続き動作します。
• 組織への招待は 21 日で失効し、この期間は変更できません。
• API キーの一覧を Default Workspace の ID の workspace_id で絞り込むと、Default Workspace に紐づくキーだけが返ります。ワークスペースのスコープを持たないキーは、どの workspace_id で絞り込んでも返りません。

ant CLI で org:admin スコープの OAuth トークンを使い、Admin API を呼び出す流れです。

1. ant auth login --profile admin --scope "org:admin" を実行し、org:admin スコープを持つ専用プロファイルでログインします。
2. export ANTHROPIC_AUTH_TOKEN=$(ant auth print-credentials --profile admin --access-token) で、bearer token を環境変数に書き出します。
3. 同じシェルでは ANTHROPIC_API_KEY を未設定のままにします。これにより、SDK と ant CLI は ANTHROPIC_AUTH_TOKEN から読み込んだ bearer token を送ります。
4. 書き出したトークンで Admin API を呼び出します。例として ant organization retrieve を使います。
5. 対話型のトークンは有効期間が短いため、リクエストが 401 を返し始めたら export コマンドを再実行してトークンを更新します。
6. 作業は管理用に分けたシェルで行い、終わったら変数を解除して ant profile activate default で CLI を元のプロファイルに戻します。