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