Admin API概要

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Admin APIを使用すると、組織メンバー、ワークスペース、APIキーなど、組織のリソースをプログラムで管理できます。これにより、Claude Consoleで手動設定が必要な管理タスクをプログラムで制御できます。

Admin APIには特別なアクセスが必要ですAdmin APIには、標準のAPIキーとは異なる特別なAdmin APIキー（sk-ant-admin...で始まる）が必要です。管理者ロールを持つ組織メンバーのみが、Claude ConsoleからAdmin APIキーをプロビジョニングできます。

Admin APIの仕組み

Admin APIを使用する場合：

x-api-keyヘッダーでAdmin APIキーを使用してリクエストを行います
APIでは以下を管理できます：
- 組織メンバーとそのロール
- 組織メンバーの招待
- ワークスペースとそのメンバー
- APIキー

これは以下の用途に便利です：

ユーザーのオンボーディング/オフボーディングの自動化
ワークスペースアクセスのプログラム管理
APIキー使用量の監視と管理

組織のロールと権限

組織レベルのロールは5つあります。詳細はこちらをご覧ください。

ロール	権限
user	Workbenchを使用可能
claude_code_user	WorkbenchとClaude Codeを使用可能
developer	WorkbenchとAPIキーの管理が可能
billing	Workbenchと請求詳細の管理が可能
admin	上記すべてに加えて、ユーザー管理が可能

主要概念

組織メンバー

組織メンバーの一覧表示、メンバーロールの更新、メンバーの削除ができます。

# 組織メンバーの一覧表示
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# メンバーロールの更新
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# メンバーの削除
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

組織への招待

ユーザーを組織に招待し、その招待を管理できます。

# 招待の作成
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "newuser@domain.com",
    "role": "developer"
  }'

# 招待の一覧表示
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 招待の削除
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

ワークスペース

リソースを整理するためにワークスペース（コンソール）を作成・管理します：

# ワークスペースの作成
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# ワークスペースの一覧表示
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# ワークスペースのアーカイブ
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

ワークスペースメンバー

特定のワークスペースへのユーザーアクセスを管理します：

# ワークスペースへのメンバー追加
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# ワークスペースメンバーの一覧表示
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# メンバーロールの更新
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# ワークスペースからのメンバー削除
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

APIキー

APIキーの監視と管理：

# APIキーの一覧表示
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# APIキーの更新
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

組織情報へのアクセス

/v1/organizations/meエンドポイントを使用して、組織に関する情報をプログラムで取得します。例：

curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

{
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}

このエンドポイントは、Admin APIキーがどの組織に属するかをプログラムで判断するのに便利です。完全なパラメータの詳細とレスポンススキーマについては、組織情報APIリファレンスをご覧ください。

使用量とコストレポートへのアクセス

組織の使用量とコストレポートにアクセスするには、使用量とコストAPIエンドポイントを使用します：

使用量エンドポイント（/v1/organizations/usage_report/messages）は、ワークスペース、ユーザー、モデルなどの様々な次元でグループ化された、トークン数やリクエストメトリクスを含む詳細な使用量データを提供します。
コストエンドポイント（/v1/organizations/cost_report）は、組織の使用量に関連するコストデータを提供し、ワークスペースや説明別に費用を追跡し、コストを配分できます。

これらのエンドポイントは、組織の使用量と関連コストに関する詳細な洞察を提供します。

Claude Codeアナリティクスへのアクセス

Claude Codeを使用している組織の場合、Claude Code Analytics APIは詳細な生産性メトリクスと使用量の洞察を提供します：

Claude Code Analyticsエンドポイント（/v1/organizations/usage_report/claude_code）は、セッション、コード行数、コミット、プルリクエスト、ツール使用統計、ユーザーとモデル別に分類されたコストデータを含む、Claude Code使用量の日次集計メトリクスを提供します。

このAPIにより、開発者の生産性を追跡し、Claude Codeの採用を分析し、組織のカスタムダッシュボードを構築できます。

ベストプラクティス

Admin APIを効果的に使用するために：

ワークスペースとAPIキーには意味のある名前と説明を使用する
失敗した操作に対する適切なエラーハンドリングを実装する
メンバーロールと権限を定期的に監査する
未使用のワークスペースと期限切れの招待をクリーンアップする
APIキーの使用量を監視し、定期的にキーをローテーションする

FAQ

Admin APIを使用するにはどのような権限が必要ですか？

管理者ロールを持つ組織メンバーのみがAdmin APIを使用できます。また、特別なAdmin APIキー（sk-ant-adminで始まる）も必要です。

Admin APIを通じて新しいAPIキーを作成できますか？

いいえ、セキュリティ上の理由により、新しいAPIキーはClaude Consoleからのみ作成できます。Admin APIは既存のAPIキーの管理のみ可能です。

ユーザーを削除した場合、APIキーはどうなりますか？

APIキーは組織にスコープされており、個々のユーザーにスコープされていないため、現在の状態で持続します。

組織の管理者をAPI経由で削除できますか？

いいえ、セキュリティ上の理由により、管理者ロールを持つ組織メンバーはAPI経由で削除できません。

組織への招待はどのくらい持続しますか？

組織への招待は21日後に期限切れになります。現在、この有効期限を変更する方法はありません。

ワークスペースに制限はありますか？

はい、組織あたり最大100個のワークスペースを持つことができます。アーカイブされたワークスペースはこの制限にカウントされません。

デフォルトワークスペースとは何ですか？

すべての組織には編集や削除ができない「デフォルトワークスペース」があり、IDを持ちません。このワークスペースはワークスペース一覧エンドポイントには表示されません。

組織のロールはワークスペースアクセスにどのような影響を与えますか？

組織の管理者は自動的にすべてのワークスペースでworkspace_adminロールを取得します。組織の請求メンバーは自動的にworkspace_billingロールを取得します。組織のユーザーと開発者は各ワークスペースに手動で追加する必要があります。

ワークスペースではどのロールを割り当てることができますか？

組織のユーザーと開発者にはworkspace_admin、workspace_developer、またはworkspace_userロールを割り当てることができます。workspace_billingロールは手動で割り当てることはできません - 組織のbillingロールを持つことから継承されます。

組織の管理者や請求メンバーのワークスペースロールを変更できますか？

組織の請求メンバーのみ、ワークスペースロールを管理者ロールにアップグレードできます。それ以外では、組織の管理者と請求メンバーは、それらの組織ロールを保持している間は、ワークスペースロールを変更したり、ワークスペースから削除したりできません。彼らのワークスペースアクセスは、まず組織ロールを変更することで修正する必要があります。

組織のロールが変更された場合、ワークスペースアクセスはどうなりますか？

組織の管理者や請求メンバーがユーザーや開発者に降格された場合、手動でロールが割り当てられたワークスペース以外のすべてのワークスペースへのアクセスを失います。ユーザーが管理者や請求ロールに昇格した場合、すべてのワークスペースへの自動アクセスを取得します。

はじめの一歩

モデルと価格

Claudeで構築

機能

ツール

エージェントスキル

Agent SDK

API内のMCP

Claude on 3rd-party platforms

プロンプトエンジニアリング

テストと評価

ガードレールを強化

管理とモニタリング

Admin APIの仕組み

組織のロールと権限

主要概念

組織メンバー

組織への招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

使用量とコストレポートへのアクセス

Claude Codeアナリティクスへのアクセス

ベストプラクティス

FAQ

はじめの一歩

モデルと価格

Claudeで構築

機能

ツール

エージェントスキル

Agent SDK

API内のMCP

Claude on 3rd-party platforms

プロンプトエンジニアリング

テストと評価

ガードレールを強化

管理とモニタリング

​Admin APIの仕組み

​組織のロールと権限

​主要概念

​組織メンバー

​組織への招待

​ワークスペース

​ワークスペースメンバー

​APIキー

​組織情報へのアクセス

​使用量とコストレポートへのアクセス

​Claude Codeアナリティクスへのアクセス

​ベストプラクティス

​FAQ

Admin APIの仕組み

組織のロールと権限

主要概念

組織メンバー

組織への招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

使用量とコストレポートへのアクセス

Claude Codeアナリティクスへのアクセス

ベストプラクティス

FAQ