管理とモニタリング

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	上記すべてに加え、ユーザー管理が可能

主要な概念

組織メンバー

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

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

完全なパラメータの詳細とレスポンススキーマについては、組織情報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キーの使用状況を監視し、定期的にキーをローテーションする

FAQ

Was this page helpful?

管理とモニタリング

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には特別なアクセスが必要です

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

完全なパラメータの詳細とレスポンススキーマについては、組織情報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キーの使用状況を監視し、定期的にキーをローテーションする

FAQ

Was this page helpful?

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織の招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

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

Claude Code分析へのアクセス

ベストプラクティス

FAQ

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

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

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

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

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

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

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

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

ワークスペースで割り当てられるロールはどれですか？

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

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

Admin APIの仕組み

組織のロールと権限

主要な概念

組織メンバー

組織の招待

ワークスペース

ワークスペースメンバー

APIキー

組織情報へのアクセス

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

Claude Code分析へのアクセス

ベストプラクティス

FAQ

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

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

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

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

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

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

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

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

ワークスペースで割り当てられるロールはどれですか？

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

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