管理組織

Admin API

Admin APIは個人アカウントではご利用いただけません。 チームメンバーと共同作業を行い、メンバーを追加するには、Console → Settings → Organization で組織を設定してください。

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

Admin APIには特別なアクセス権が必要です

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

AWS上のClaude Platform： Admin APIのほとんどは、AWS上のClaude Platformでは利用できません。ワークスペースエンドポイント（/v1/organizations/workspacesでの作成、取得、一覧表示、更新、アーカイブ）は利用可能です。組織メンバー、ワークスペースメンバー、招待、APIキー、使用状況レポート、コストレポート、レート制限レポートなど、その他のエンドポイントは利用できません。詳細については、AWS上のClaude Platformを参照してください。

Admin APIの仕組み

Admin APIを使用する場合：

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

これは以下の用途に役立ちます：

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

組織のロールと権限

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

ロール	権限
user	Workbenchを使用できます
claude_code_user	WorkbenchとClaude Codeを使用できます
developer	Workbenchを使用し、APIキーを管理できます
billing	Workbenchを使用し、請求情報を管理できます
admin	上記のすべてに加えて、ユーザーを管理できます

主要な概念

組織メンバー

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

cURL

# 組織メンバーを一覧表示
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 "content-type: application/json" \
  --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

# 招待を作成
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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"

ワークスペース

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

ワークスペースメンバー

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

cURL

# ワークスペースにメンバーを追加
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 "content-type: application/json" \
  --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キーを監視および管理します：

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

組織情報へのアクセス

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

例：

cURL

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

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

このエンドポイントは、Admin APIキーがどの組織に属しているかをプログラムで判断するのに役立ちます。

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

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

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

Claude Code分析

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

レート制限

Rate Limits APIを使用して、組織とそのワークスペースに設定されているレート制限を確認します。

Compliance API

Compliance APIを使用して、組織の監査およびアクティビティデータを取得します。Admin APIキーはアクティビティフィードの読み取りのみ可能です。フルアクセスについては、Compliance APIへのアクセスを取得するを参照してください。

ベストプラクティス

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

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

FAQ

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

Was this page helpful?

管理組織

Admin API

Admin APIには特別なアクセス権が必要です

Admin APIの仕組み

Admin APIを使用する場合：

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

これは以下の用途に役立ちます：

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

組織のロールと権限

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

ロール	権限
user	Workbenchを使用できます
claude_code_user	WorkbenchとClaude Codeを使用できます
developer	Workbenchを使用し、APIキーを管理できます
billing	Workbenchを使用し、請求情報を管理できます
admin	上記のすべてに加えて、ユーザーを管理できます

主要な概念

組織メンバー

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

cURL

# 組織メンバーを一覧表示
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 "content-type: application/json" \
  --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

# 招待を作成
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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"

ワークスペース

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

ワークスペースメンバー

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

cURL

# ワークスペースにメンバーを追加
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 "content-type: application/json" \
  --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キーを監視および管理します：

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

組織情報へのアクセス

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

例：

cURL

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

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

このエンドポイントは、Admin APIキーがどの組織に属しているかをプログラムで判断するのに役立ちます。

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

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

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

Claude Code分析

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

レート制限

Rate Limits APIを使用して、組織とそのワークスペースに設定されているレート制限を確認します。

Compliance API

ベストプラクティス

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

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

FAQ

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

Was this page helpful?

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織への招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

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

Claude Code分析

レート制限

Compliance API

ベストプラクティス

FAQ

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

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

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

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

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

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織への招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

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

Claude Code分析

レート制限

Compliance API

ベストプラクティス

FAQ

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

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

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

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

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