管理組織

Admin API

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

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

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

Admin APIは2種類の認証情報を受け付けます。x-api-keyヘッダーで送信されるAdmin APIキー（sk-ant-admin...で始まる）、またはauthorization: Bearerヘッダーで送信されるorg:adminスコープを持つOAuthベアラートークンです。Admin APIキーをプロビジョニングできるのはadminロールを持つ組織メンバーのみであり、org:adminトークンを取得できるのはadmin、owner、またはprimary ownerロールを持つメンバーのみです。Admin APIキーの作成を参照してください。

AWS上のClaude Platform： Admin APIのほとんどはAWS上のClaude Platformでは利用できません。ワークスペースエンドポイント（/v1/organizations/workspacesに対するcreate、get、list、update、archive）は利用可能です。組織メンバー、ワークスペースメンバー、招待、APIキー、使用状況レポート、コストレポート、レート制限レポートなど、その他のエンドポイントは利用できません。詳細については、AWS上のClaude Platformを参照してください。

認証

いずれかの認証情報で認証します。組織タイプに応じたAdmin APIキーを作成するには、Admin APIキーの作成を参照してください。以下の例では、両方の方法で組織情報エンドポイントを呼び出しています。

OAuthベアラー：

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

org:adminトークンは、基盤となるプロファイルやフェデレーションルールがバインドされているワークスペースに関係なく、組織全体へのアクセスを付与します。取得方法については、Admin APIでWIFを管理するの前提条件を参照してください。

Admin APIキー：

cURL

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

Admin APIの仕組み

Admin APIを使用する場合：

認証セクションのいずれかの認証情報を使用してリクエストを行います
APIを使用して以下を管理できます：
- 組織メンバーとそのロール
- 組織メンバーの招待
- ワークスペースとそのメンバー
- APIキー
- サービスアカウント、フェデレーション発行者、フェデレーションルール（これらのエンドポイントにはorg:admin OAuthトークンが必要です。Admin APIキーは受け付けられません）

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

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

組織のロールと権限

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

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

組織のownerとprimary ownerはすべてのadmin権限を持ち、さらにadminを管理することもできます。このページでのadminロールへの言及はすべて、ownerとprimary ownerにも適用されます。

主要な概念

組織メンバー

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

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"
  }'

サービスアカウント

サービスアカウント（svac_...）を作成および管理します。これは、Workload Identity Federationトークンが動作する際の非人間アイデンティティです。サービスアカウント、フェデレーション発行者、フェデレーションルールのエンドポイントではAdmin APIキーは受け付けられません。org:admin OAuthトークンを使用してください。Admin APIでWIFを管理するを参照してください。

フェデレーション発行者

組織のワークロードアイデンティティをアサートできるトークンを発行するOIDCアイデンティティプロバイダー（fdis_...）を登録します。Admin APIでWIFを管理するを参照してください。

フェデレーションルール

発行者トークンをサービスアカウントとスコープにマッピングするルール（fdrl_...）を管理します。Admin APIでWIFを管理するを参照してください。

組織情報へのアクセス

/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キーはActivity Feedの読み取りのみ可能です。フルアクセスについては、Compliance APIへのアクセスを取得するを参照してください。

ベストプラクティス

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

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

FAQ

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

Was this page helpful?

管理組織

Admin API

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

認証

OAuthベアラー：

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

Admin APIキー：

cURL

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

Admin APIの仕組み

Admin APIを使用する場合：

認証セクションのいずれかの認証情報を使用してリクエストを行います
APIを使用して以下を管理できます：
- 組織メンバーとそのロール
- 組織メンバーの招待
- ワークスペースとそのメンバー
- APIキー
- サービスアカウント、フェデレーション発行者、フェデレーションルール（これらのエンドポイントにはorg:admin OAuthトークンが必要です。Admin 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"
  }'

サービスアカウント

フェデレーション発行者

フェデレーションルール

発行者トークンをサービスアカウントとスコープにマッピングするルール（fdrl_...）を管理します。Admin APIでWIFを管理するを参照してください。

組織情報へのアクセス

/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キーはどうなりますか？

組織のadminをAPIを通じて削除できますか？

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

認証

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織の招待

ワークスペース

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

APIキー

サービスアカウント

フェデレーション発行者

フェデレーションルール

組織情報へのアクセス

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

Claude Code分析

レート制限

Compliance API

ベストプラクティス

FAQ

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

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

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

組織のadminをAPIを通じて削除できますか？

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

認証

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織の招待

ワークスペース

ワークスペースメンバー

APIキー

サービスアカウント

フェデレーション発行者

フェデレーションルール

組織情報へのアクセス

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

Claude Code分析

レート制限

Compliance API

ベストプラクティス

FAQ

認証

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織の招待

ワークスペース

ワークスペースメンバー

APIキー

サービスアカウント

フェデレーション発行者

フェデレーションルール

組織情報へのアクセス

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

Claude Code分析

レート制限

Compliance API

ベストプラクティス

FAQ