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... で始まる）が必要です。Admin API キーをプロビジョニングできるのは、Claude Console を通じて管理者ロールを持つ組織メンバーのみです。

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	上記すべてに加えて、ユーザーを管理できます

主要な概念

組織メンバー

組織メンバーをリストアップし、メンバーロールを更新し、メンバーを削除できます。

Shell

# 組織メンバーをリストアップ
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"

組織招待

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

Shell

# 招待を作成
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": "[email protected]",
    "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"

ワークスペース

ワークスペース（コンソール）を作成および管理して、リソースを整理します：

Shell

# ワークスペースを作成
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"

ワークスペースメンバー

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

Shell

# ワークスペースにメンバーを追加
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 キーを監視および管理します：

Shell

# 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 キーがどの組織に属しているかをプログラムで判定するのに便利です。

完全なパラメータの詳細とレスポンススキーマについては、Organization Info API リファレンスを参照してください。

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

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

Usage エンドポイント（/v1/organizations/usage_report/messages）は、トークン数とリクエストメトリクスを含む詳細な使用状況データを提供し、ワークスペース、ユーザー、モデルなどのさまざまなディメンションでグループ化されています。
Cost エンドポイント（/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 キーの使用状況を監視し、定期的にキーをローテーションする

Admin API の仕組み

組織ロールと権限

主要な概念

組織メンバー

組織招待

ワークスペース

ワークスペース メンバー

API キー

組織情報へのアクセス

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

Claude Code 分析へのアクセス

ベスト プラクティス

FAQ

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

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

ユーザーを削除するとどうなりますか？

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

組織招待はどのくらい有効ですか？

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

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

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

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

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

組織ロールが変更されるとワークスペース アクセスはどうなりますか？

ワークスペースメンバー

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

ベストプラクティス