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には、標準のAPIキーとは異なる特別なAdmin APIキー(
sk-ant-admin...
で始まる)が必要です。管理者ロールを持つ組織メンバーのみが、Anthropic 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 | 上記すべてに加えて、ユーザーを管理可能 |
主要概念
組織メンバー
組織メンバーの一覧表示、メンバーの役割更新、メンバーの削除ができます。組織への招待
ユーザーを組織に招待し、その招待を管理できます。ワークスペース
リソースを整理するためにワークスペース(コンソール)を作成・管理します:ワークスペースメンバー
特定のワークスペースへのユーザーアクセスを管理します:APIキー
APIキーの監視と管理:ベストプラクティス
Admin APIを効果的に使用するには:- ワークスペースとAPIキーに意味のある名前と説明を使用する
- 失敗した操作に対する適切なエラーハンドリングを実装する
- メンバーの役割と権限を定期的に監査する
- 未使用のワークスペースと期限切れの招待をクリーンアップする
- APIキーの使用量を監視し、定期的にキーをローテーションする
FAQ
Admin APIを使用するにはどのような権限が必要ですか?
Admin APIを使用するにはどのような権限が必要ですか?
管理者ロールを持つ組織メンバーのみがAdmin APIを使用できます。また、特別なAdmin APIキー(
sk-ant-admin
で始まる)も必要です。Admin APIを通じて新しいAPIキーを作成できますか?
Admin APIを通じて新しいAPIキーを作成できますか?
いいえ、セキュリティ上の理由により、新しいAPIキーはAnthropic Consoleを通じてのみ作成できます。Admin APIは既存のAPIキーの管理のみ可能です。
ユーザーを削除した場合、APIキーはどうなりますか?
ユーザーを削除した場合、APIキーはどうなりますか?
APIキーは組織にスコープされており、個々のユーザーにスコープされていないため、現在の状態で存続します。
組織の管理者はAPIを通じて削除できますか?
組織の管理者はAPIを通じて削除できますか?
いいえ、セキュリティ上の理由により、管理者ロールを持つ組織メンバーはAPIを通じて削除できません。
組織への招待はどのくらい持続しますか?
組織への招待はどのくらい持続しますか?
組織への招待は21日後に期限切れになります。現在、この有効期限を変更する方法はありません。
ワークスペースに制限はありますか?
ワークスペースに制限はありますか?
はい、組織あたり最大100のワークスペースを持つことができます。アーカイブされたワークスペースはこの制限にカウントされません。
デフォルトワークスペースとは何ですか?
デフォルトワークスペースとは何ですか?
すべての組織には編集や削除ができない「デフォルトワークスペース」があり、IDを持ちません。このワークスペースはワークスペース一覧エンドポイントには表示されません。
組織の役割はワークスペースアクセスにどのように影響しますか?
組織の役割はワークスペースアクセスにどのように影響しますか?
組織の管理者は自動的にすべてのワークスペースで
workspace_admin
ロールを取得します。組織の請求メンバーは自動的にworkspace_billing
ロールを取得します。組織のユーザーと開発者は各ワークスペースに手動で追加する必要があります。ワークスペースではどの役割を割り当てることができますか?
ワークスペースではどの役割を割り当てることができますか?
組織のユーザーと開発者には
workspace_admin
、workspace_developer
、またはworkspace_user
ロールを割り当てることができます。workspace_billing
ロールは手動で割り当てることはできません - これは組織のbilling
ロールを持つことから継承されます。組織の管理者または請求メンバーのワークスペースロールを変更できますか?
組織の管理者または請求メンバーのワークスペースロールを変更できますか?
組織の請求メンバーのみ、ワークスペースロールを管理者ロールにアップグレードできます。それ以外では、組織の管理者と請求メンバーは、それらの組織ロールを保持している間は、ワークスペースロールを変更したり、ワークスペースから削除したりすることはできません。彼らのワークスペースアクセスは、まず組織ロールを変更することで修正する必要があります。
組織の役割が変更された場合、ワークスペースアクセスはどうなりますか?
組織の役割が変更された場合、ワークスペースアクセスはどうなりますか?
組織の管理者または請求メンバーがユーザーまたは開発者に降格された場合、手動で役割が割り当てられたワークスペース以外のすべてのワークスペースへのアクセスを失います。ユーザーが管理者または請求ロールに昇格した場合、すべてのワークスペースへの自動アクセスを取得します。