Обзор Admin API - Claude Docs

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

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

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

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

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

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

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

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

Роль	Разрешения
user	Может использовать Workbench
claude_code_user	Может использовать Workbench и Claude Code
developer	Может использовать Workbench и управлять API ключами
billing	Может использовать Workbench и управлять деталями биллинга
admin	Может делать все вышеперечисленное, плюс управлять пользователями

Ключевые концепции

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

Вы можете просматривать участников организации, обновлять роли участников и удалять участников.

# Список участников организации
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"

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

Вы можете приглашать пользователей в организации и управлять этими приглашениями.

# Создать приглашение
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"

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

Создавайте и управляйте рабочими пространствами (консоль) для организации ваших ресурсов:

# Создать рабочее пространство
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 ключи

Мониторинг и управление API ключами:

# Список 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 информации об организации.

Доступ к отчетам об использовании и стоимости

Для доступа к отчетам об использовании и стоимости для вашей организации используйте эндпоинты API использования и стоимости:

Эндпоинт использования (/v1/organizations/usage_report/messages) предоставляет подробные данные об использовании, включая количество токенов и метрики запросов, сгруппированные по различным измерениям, таким как рабочее пространство, пользователь и модель.
Эндпоинт стоимости (/v1/organizations/cost_report) предоставляет данные о стоимости, связанные с использованием вашей организации, позволяя отслеживать расходы и распределять затраты по рабочим пространствам или описанию.

Эти эндпоинты предоставляют подробную информацию об использовании вашей организации и связанных с ним затратах.

Доступ к аналитике Claude Code

Для организаций, использующих Claude Code, API аналитики Claude Code предоставляет подробные метрики производительности и аналитику использования:

Эндпоинт аналитики Claude Code (/v1/organizations/usage_report/claude_code) предоставляет ежедневные агрегированные метрики для использования Claude Code, включая сессии, строки кода, коммиты, pull request’ы, статистику использования инструментов и данные о стоимости, разбитые по пользователям и моделям.

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

Лучшие практики

Для эффективного использования Admin API:

Используйте осмысленные имена и описания для рабочих пространств и API ключей
Реализуйте правильную обработку ошибок для неудачных операций
Регулярно проводите аудит ролей и разрешений участников
Очищайте неиспользуемые рабочие пространства и просроченные приглашения
Мониторьте использование API ключей и периодически ротируйте ключи

FAQ

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

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

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

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

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

API ключи сохраняют свое текущее состояние, поскольку они привязаны к организации, а не к отдельным пользователям.

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

Нет, участники организации с ролью администратора не могут быть удалены через API по соображениям безопасности.

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

Приглашения в организацию истекают через 21 день. В настоящее время нет способа изменить этот период истечения.

Есть ли ограничения на рабочие пространства?

Да, вы можете иметь максимум 100 рабочих пространств на организацию. Архивированные рабочие пространства не учитываются в этом лимите.

Что такое рабочее пространство по умолчанию?

У каждой организации есть “Рабочее пространство по умолчанию”, которое нельзя редактировать или удалить, и у которого нет ID. Это рабочее пространство не появляется в эндпоинтах списка рабочих пространств.

Как роли организации влияют на доступ к рабочим пространствам?

Администраторы организации автоматически получают роль workspace_admin во всех рабочих пространствах. Участники организации с ролью биллинга автоматически получают роль workspace_billing. Пользователи и разработчики организации должны быть вручную добавлены в каждое рабочее пространство.

Какие роли могут быть назначены в рабочих пространствах?

Пользователям и разработчикам организации могут быть назначены роли workspace_admin, workspace_developer или workspace_user. Роль workspace_billing нельзя назначить вручную - она наследуется от наличия роли billing в организации.

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

Только участники организации с ролью биллинга могут повысить свою роль в рабочем пространстве до роли администратора. В остальном, администраторы организации и участники биллинга не могут изменить свои роли в рабочих пространствах или быть удалены из рабочих пространств, пока они занимают эти роли в организации. Их доступ к рабочим пространствам должен быть изменен путем изменения их роли в организации сначала.

Что происходит с доступом к рабочим пространствам при изменении ролей в организации?

Если администратор организации или участник биллинга понижается до пользователя или разработчика, они теряют доступ ко всем рабочим пространствам, кроме тех, где им были вручную назначены роли. Когда пользователи повышаются до ролей администратора или биллинга, они получают автоматический доступ ко всем рабочим пространствам.

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

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

​Ключевые концепции

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

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

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

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

​API ключи

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

​Доступ к отчетам об использовании и стоимости

​Доступ к аналитике Claude Code

​Лучшие практики

​FAQ

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

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

Ключевые концепции

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

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

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

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

API ключи

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

Доступ к отчетам об использовании и стоимости

Доступ к аналитике Claude Code

Лучшие практики

FAQ