Узнайте, как использовать Admin API для программного управления ресурсами вашей организации, включая участников, рабочие пространства и 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 ключи. Это обеспечивает программный контроль над административными задачами, которые в противном случае потребовали бы ручной настройки в Anthropic Console.
Admin API требует специального доступа
Admin API требует специального Admin API ключа (начинающегося с sk-ant-admin...), который отличается от стандартных API ключей. Только участники организации с ролью администратора могут создавать Admin API ключи через Anthropic Console.
# Создать рабочее пространство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"
# Добавить участника в рабочее пространство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 ключей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"}'
Только участники организации с ролью администратора могут использовать Admin API. У них также должен быть специальный Admin API ключ (начинающийся с sk-ant-admin).
Нет, новые API ключи могут быть созданы только через Anthropic Console по соображениям безопасности. Admin API может только управлять существующими API ключами.
API ключи сохраняются в их текущем состоянии, поскольку они привязаны к Организации, а не к отдельным пользователям.
Нет, участники организации с ролью администратора не могут быть удалены через API по соображениям безопасности.
Приглашения в организацию истекают через 21 день. В настоящее время нет способа изменить этот период истечения.
Да, вы можете иметь максимум 100 рабочих пространств на Организацию. Архивированные рабочие пространства не учитываются в этом ограничении.
У каждой Организации есть “Рабочее пространство по умолчанию”, которое нельзя редактировать или удалить, и у которого нет ID. Это Рабочее пространство не отображается в конечных точках списка рабочих пространств.
Администраторы организации автоматически получают роль workspace_admin во всех рабочих пространствах. Участники биллинга организации автоматически получают роль workspace_billing. Пользователи и разработчики организации должны быть вручную добавлены в каждое рабочее пространство.
Пользователям и разработчикам организации можно назначать роли workspace_admin, workspace_developer или workspace_user. Роль workspace_billing нельзя назначить вручную - она наследуется от наличия роли billing в организации.
Только участники биллинга организации могут повысить свою роль в рабочем пространстве до роли администратора. В остальном, администраторы организации и участники биллинга не могут изменить свои роли в рабочих пространствах или быть удалены из рабочих пространств, пока они занимают эти роли в организации. Их доступ к рабочим пространствам должен быть изменен путем изменения их роли в организации сначала.
Если администратор организации или участник биллинга понижается до пользователя или разработчика, они теряют доступ ко всем рабочим пространствам, кроме тех, где им были вручную назначены роли. Когда пользователи повышаются до ролей администратора или биллинга, они получают автоматический доступ ко всем рабочим пространствам.