Admin API 概要

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 ロールを持つ組織メンバーのみです。

Admin API の仕組み

Admin API を使用する場合：

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

これは以下の場合に便利です：

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

組織ロールと権限

5 つの組織レベルロールがあります。詳細は API Console ロールと権限の記事を参照してください。

ロール	権限
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"

ワークスペース

Console と API の例を含むワークスペースの包括的なガイドについては、ワークスペースを参照してください。

ワークスペースメンバー

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

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

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

使用状況とコストレポート

使用状況とコスト API を使用して、組織の使用状況とコストを追跡します。

Claude Code 分析

Claude Code Analytics API を使用して、開発者の生産性と Claude Code の採用を監視します。

ベストプラクティス

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

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

FAQ

ワークスペース固有の質問については、ワークスペース FAQ を参照してください。

Admin API の仕組み

組織ロールと権限

主要な概念

組織メンバー

組織招待

ワークスペース

ワークスペースメンバー

API キー

組織情報へのアクセス

使用状況とコストレポート

Claude Code 分析

ベストプラクティス

FAQ

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

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

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

組織管理者は API を通じて削除できますか？

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