Admin API

Admin API недоступен для индивидуальных аккаунтов. Чтобы сотрудничать с коллегами и добавлять участников, настройте свою организацию в Console → Settings → Organization.

Admin API позволяет программно управлять ресурсами вашей организации, включая участников организации, рабочие пространства и ключи API. Это обеспечивает программный контроль над административными задачами, которые в противном случае потребовали бы ручной настройки в Claude Console.

Admin API требует специального доступа

Admin API требует специального ключа Admin API (начинающегося с sk-ant-admin...), который отличается от стандартных ключей API. Только участники организации с ролью администратора могут создавать ключи Admin API через Claude Console.

Claude Platform на AWS: Большая часть Admin API недоступна в Claude Platform на AWS. Эндпоинты рабочих пространств (создание, получение, перечисление, обновление и архивирование по адресу /v1/organizations/workspaces) доступны. Другие эндпоинты, включая участников организации, участников рабочих пространств, приглашения, ключи API, отчёты об использовании, отчёты о затратах и отчёты об ограничениях скорости, недоступны. Подробнее см. в разделе Claude Platform на AWS.

Как работает Admin API

Когда вы используете Admin API:

Вы отправляете запросы, используя ваш ключ Admin API в заголовке x-api-key
API позволяет вам управлять:
- Участниками организации и их ролями
- Приглашениями участников организации
- Рабочими пространствами и их участниками
- Ключами API

Это полезно для:

Автоматизации подключения и отключения пользователей
Программного управления доступом к рабочим пространствам
Мониторинга и управления использованием ключей API

Роли и разрешения организации

Существует пять ролей на уровне организации. Подробнее см. в статье Роли и разрешения API Console.

Роль	Разрешения
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"

Рабочие пространства

Подробное руководство по рабочим пространствам, включая примеры для Console и 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"
  }'

Доступ к информации об организации

Получайте информацию о вашей организации программно с помощью эндпоинта /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 с помощью Claude Code Analytics API.

Ограничения скорости

Считывайте ограничения скорости, настроенные для вашей организации и её рабочих пространств, с помощью Rate Limits API.

Compliance API

Получайте данные аудита и активности для вашей организации с помощью Compliance API. Ключи Admin API могут только считывать ленту активности (Activity Feed); для полного доступа см. раздел Получение доступа к Compliance API.

Часто задаваемые вопросы

Вопросы, связанные с рабочими пространствами, см. в разделе Часто задаваемые вопросы о рабочих пространствах.

Как работает Admin API

Роли и разрешения организации

Ключевые понятия

Участники организации

Приглашения в организацию

Рабочие пространства

Участники рабочих пространств

Ключи API

Доступ к информации об организации

Отчёты об использовании и затратах

Аналитика Claude Code

Ограничения скорости

Compliance API

Рекомендации

Часто задаваемые вопросы

Какие разрешения необходимы для использования Admin API?

Можно ли создавать новые ключи API через Admin API?

Что происходит с ключами API при удалении пользователя?

Можно ли удалить администраторов организации через API?

Как долго действуют приглашения в организацию?