Управление пользователями
Управляйте людьми в вашей организации Claude Enterprise с помощью Admin API: просматривайте список участников и меняйте их роли, отправляйте и отзывайте приглашения, управляйте группами и читайте пользовательские роли.
На этой странице описано программное управление людьми в вашей организации Claude Enterprise (claude.ai) с помощью Admin API: получение списка участников и поиск их по адресу электронной почты, изменение роли участника, удаление участников, отправка и отзыв приглашений, управление группами вашего предприятия и их составом, а также чтение пользовательских ролей вашей организации. Для организаций Claude Console (Claude Platform) см. руководство по Admin API для Claude Console.
Какие эндпоинты может использовать ваша организация?
Admin API — это единый набор эндпоинтов по адресу https://api.anthropic.com/v1/organizations/. Организации Claude Console и Claude Enterprise проходят аутентификацию с помощью разных ключей, и каждой из них доступно своё подмножество эндпоинтов:
| Эндпоинты | Claude Console (Claude Platform) | Claude Enterprise (claude.ai) |
|---|---|---|
| Участники и приглашения | Доступны; см. руководство по Admin API | Доступны (эта страница) |
| Группы | Недоступны | Доступны (эта страница) |
| Пользовательские роли | Недоступны | Доступны, только чтение (эта страница) |
| Плагины | Недоступны | Доступны в бета-версии |
| Лимиты расходов | Недоступны | Доступны |
| Отчёты об использовании и затратах | Доступны; см. Usage and Cost API | Доступны через Claude Enterprise Analytics API |
| Рабочие пространства, ключи API, ограничения скорости и другие эндпоинты из руководства по Admin API | Доступны | Недоступны |
Эндпоинты участников и приглашений одинаковы для обоих типов организаций; на этой странице описано их поведение в Claude Enterprise, включая роли организации Claude Enterprise. Эндпоинты групп и пользовательских ролей существуют только для Claude Enterprise.
Обзор
На этой странице описаны пять ресурсов:
| Ресурс | Эндпоинты | Назначение |
|---|---|---|
| Участники | GET /v1/organizations/usersGET /v1/organizations/users/{user_id}POST /v1/organizations/users/{user_id}DELETE /v1/organizations/users/{user_id} | Получение списка участников организации или поиск участника по электронной почте; изменение роли участника; удаление участника. |
| Приглашения | POST /v1/organizations/invitesGET /v1/organizations/invitesGET /v1/organizations/invites/{invite_id}DELETE /v1/organizations/invites/{invite_id} | Приглашение человека в организацию, отслеживание статуса приглашения и его отзыв до принятия. |
| Группы | GET /v1/organizations/rbac_groupsGET /v1/organizations/rbac_groups/{rbac_group_id}POST /v1/organizations/rbac_groupsPOST /v1/organizations/rbac_groups/{rbac_group_id}DELETE /v1/organizations/rbac_groups/{rbac_group_id} | Чтение групп вашего предприятия и привязанных к каждой из них пользовательских ролей; создание, переименование и удаление групп. |
| Участники групп | GET /v1/organizations/rbac_groups/{rbac_group_id}/membersPOST /v1/organizations/rbac_groups/{rbac_group_id}/membersDELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} | Чтение участников группы; добавление и удаление участников. |
| Пользовательские роли | GET /v1/organizations/rbac_rolesGET /v1/organizations/rbac_roles/{rbac_role_id}GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions | Чтение пользовательских ролей вашей организации и разрешений, которые предоставляет каждая роль. |
Пользовательские роли и их привязки к группам управляются в настройках организации claude.ai; API может их читать, но не может изменять.
Быстрый старт
Задайте в переменной окружения ANTHROPIC_API_KEY ваш ключ Admin API. Примеры на этой странице считывают ключ из неё. SDK и CLI ant отправляют заголовки Authorization и anthropic-version за вас.
Получите список участников организации, начиная с самых новых:
client = anthropic.Anthropic()
users = client.organization.users.list(limit=20)
for user in users:
print(f"{user.id}: {user.email} ({user.role})"){
"data": [
{
"type": "user",
"id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"name": "Jane Smith",
"role": "user",
"added_at": "2026-06-12T09:14:03Z"
}
],
"has_more": false,
"first_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"last_id": "user_01AbCdEfGhIjKlMnOpQrSt"
}Ключевые понятия
Роли организации
У каждого участника ровно одна роль в организации. При чтении роль участника возвращается как одно из пяти значений:
| Роль | Значение |
|---|---|
user | Обычный участник. |
managed | Участник, разрешения которого предоставляются через пользовательские роли, привязанные к его группам. |
owner | Владелец организации. |
membership_admin | Участник, который может управлять участниками организации. |
primary_owner | Основной владелец организации. Он всегда ровно один. |
API может назначать только роли user и managed — при создании приглашения и при обновлении роли. Назначение managed требует области доступа write:rbac_groups в дополнение к write:members, поскольку разрешения управляемого участника определяются пользовательскими ролями, привязанными к его группам. Административные роли (owner, membership_admin и primary_owner) назначаются в настройках организации claude.ai, а участников с этими ролями нельзя изменить или удалить через этот API.
Участники и приглашения
Человек становится участником, приняв приглашение (или через единый вход (single sign-on) вашей организации, если он настроен). При создании приглашения отправляется письмо с приглашением; затем приглашение имеет статус pending, пока получатель не примет его (accepted) или не истечёт назначенный сервером срок expires_at (expired). Отозвать можно только приглашение в статусе pending. Чтобы изменить адрес электронной почты или роль в ожидающем приглашении, отзовите его и создайте новое.
Если тарифный план вашей организации выделяет участникам места из ограниченного пула купленных мест, ожидающее приглашение занимает место. Эндпоинт создания приглашения не принимает параметр места или уровня: место назначается автоматически из самого низкого уровня, в котором есть свободные места. Если свободных мест нет, создание приглашения завершается ошибкой 400, а не покупкой места. Отзыв приглашения, истечение его срока или последующее удаление участника возвращает место в пул.
Группы и роли
Группы связывают участников с пользовательскими ролями (управление доступом на основе ролей, role-based access control — отсюда rbac в путях эндпоинтов и названиях областей доступа). Группы принадлежат вашему предприятию в целом (родительской организации вместе со всеми организациями под ней), а не отдельной организации, поэтому области доступа для групп (read:rbac_groups и write:rbac_groups) требуют ключа, созданного для всех связанных организаций. У каждой группы есть source_type: direct для групп, созданных в claude.ai, и scim для групп, предоставленных вашим поставщиком удостоверений. Поле role_ids группы содержит идентификаторы привязанных к ней пользовательских ролей; получить их названия и разрешения можно с помощью эндпоинтов пользовательских ролей. Учтите, что каталог ролей ведётся для каждой организации отдельно, а группы действуют на уровне всего предприятия, поэтому запрос роли, принадлежащей другой организации вашего предприятия, вернёт для вашего ключа 404. Поле имеет значение null (а не []), если данные о ролях были временно недоступны, поэтому повторите запрос, чтобы отличить неполное чтение от группы без ролей.
Версионирование
Отправляйте заголовок anthropic-version в каждом запросе; доступные версии см. в разделе Версии API.
Ограничения скорости
Эндпоинты Admin API используют общее для организации ограничение в 100 запросов в минуту; для создания приглашений вместо этого действует собственное ограничение в 1 200 запросов в час. Запросы сверх ограничения возвращают 429 Too Many Requests.
Пагинация
Списки участников и приглашений используют пагинацию на основе идентификаторов: передайте limit (по умолчанию 20, максимум 1000) и не более одного из параметров before_id или after_id, а затем переходите по страницам с помощью полей first_id и last_id каждого ответа, пока has_more не станет false. Списки групп и пользовательских ролей вместо этого используют непрозрачный курсор: значение next_page из ответа передаётся без изменений в параметре page следующего запроса, пока next_page не станет null.
При переборе результатов SDK сам загружает дополнительные страницы, поэтому limit задаёт размер страницы, а не общее количество. В CLI --limit задаёт общее количество результатов для списков участников и приглашений. Для списков групп и ролей он задаёт размер страницы.
Ответы с ошибками
Ответы с ошибками имеют стандартную структуру, описанную в разделе Ошибки.
Участники
Получение списка участников
GET /v1/organizations/users возвращает участников организации, начиная с добавленных последними. Используйте фильтр email, чтобы найти конкретного участника; сопоставление не зависит от регистра и допускает распространённые варианты одного и того же адреса (например, jane+hiring@example.com соответствует jane@example.com). Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе List users справочника API.
client = anthropic.Anthropic()
users = client.organization.users.list(email="jane@example.com")
for user in users:
print(f"{user.id}: {user.email} ({user.role})")Получение участника
GET /v1/organizations/users/{user_id} возвращает одного участника по идентификатору. Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе Get user справочника API.
client = anthropic.Anthropic()
user = client.organization.users.retrieve("user_01AbCdEfGhIjKlMnOpQrSt")
print(f"id: {user.id}")
print(f"email: {user.email}")
print(f"role: {user.role}")Изменение роли участника
POST /v1/organizations/users/{user_id} устанавливает роль участника user или managed. Участников с административной ролью (owner, membership_admin или primary_owner) нельзя изменить через этот эндпоинт, и административные роли нельзя назначить; в обоих случаях возвращается 400, а управление ими осуществляется в настройках организации claude.ai. Если роли в вашей организации управляются поставщиком удостоверений (расширенный SSO или расширенное предоставление через SCIM), обновления ролей возвращают 400. Требуется область доступа write:members, а также write:rbac_groups при изменении роли на managed.
Полное описание параметров и схем ответов см. в разделе Update user справочника API.
client = anthropic.Anthropic()
user = client.organization.users.update("user_01AbCdEfGhIjKlMnOpQrSt", role="managed")
print(f"id: {user.id}")
print(f"role: {user.role}")Удаление участника
DELETE /v1/organizations/users/{user_id} удаляет участника из организации, возвращая занимаемое им купленное место в пул организации. Участников с административной ролью нельзя удалить через этот эндпоинт, а если членством управляет ваш поставщик удостоверений (SCIM), удаления возвращают 400. Требуется область доступа write:members.
Полное описание параметров и схем ответов см. в разделе Remove user справочника API.
client = anthropic.Anthropic()
removed_user = client.organization.users.remove("user_01AbCdEfGhIjKlMnOpQrSt")
print(f"id: {removed_user.id}"){
"type": "user_deleted",
"id": "user_01AbCdEfGhIjKlMnOpQrSt"
}Приглашения
Создание приглашения
POST /v1/organizations/invites отправляет письмо с приглашением и возвращает приглашение с назначенным сервером expires_at. role должно быть user или managed. Если для этого адреса электронной почты уже существует ожидающее приглашение или адрес уже принадлежит участнику, запрос возвращает 400 с указанием существующего ресурса. Организации, в которых поставщик удостоверений автоматически предоставляет пользователей (JIT или SCIM), не могут создавать приглашения через API. Требуется область доступа write:members, а также write:rbac_groups, если role имеет значение managed.
В тарифных планах, выделяющих участникам места из ограниченного пула, приглашение автоматически занимает место из самого низкого уровня, в котором есть свободные места. API не принимает параметр уровня. Если свободных мест нет, запрос завершается ошибкой 400, а не покупкой места. Добавьте места через управление тарифным планом организации и повторите попытку.
Необязательное поле rbac_group_ids содержит список групп (по идентификаторам с префиксом rbac_group_), которые будут назначены участнику после принятия приглашения. Передача непустого rbac_group_ids дополнительно требует, чтобы у ключа была область доступа write:rbac_groups, поскольку назначение группы может предоставить разрешения, привязанные к ролям группы.
Полное описание параметров и схем ответов см. в разделе Create invite справочника API.
client = anthropic.Anthropic()
invite = client.organization.invites.create(
email="newhire@example.com",
role="managed",
rbac_group_ids=["rbac_group_01UvWxYzAbCdEfGhIjKlMn"],
)
print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")
print(f"expires_at: {invite.expires_at}"){
"type": "invite",
"id": "invite_01QrStUvWxYzAbCdEfGhIj",
"email": "newhire@example.com",
"role": "managed",
"invited_at": "2026-07-06T16:20:11Z",
"expires_at": "2026-07-27T16:20:11Z",
"accepted_at": null,
"status": "pending",
"rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
}Получение списка приглашений
GET /v1/organizations/invites возвращает приглашения организации, начиная с самых последних, во всех состояниях pending, accepted и expired; фильтра по статусу нет. Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе List invites справочника API.
client = anthropic.Anthropic()
invites = client.organization.invites.list(limit=20)
for invite in invites:
print(f"{invite.id}: {invite.email} ({invite.status})")Получение приглашения
GET /v1/organizations/invites/{invite_id} возвращает одно приглашение по идентификатору. Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе Get invite справочника API.
client = anthropic.Anthropic()
invite = client.organization.invites.retrieve("invite_01QrStUvWxYzAbCdEfGhIj")
print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")Отзыв приглашения
DELETE /v1/organizations/invites/{invite_id} отзывает приглашение в статусе pending, деактивируя ссылку в письме с приглашением. Отзыв приглашения в статусе accepted возвращает 400 (вместо этого удалите участника); отзыв приглашения в статусе expired возвращает 400. Требуется область доступа write:members.
Полное описание параметров и схем ответов см. в разделе Delete invite справочника API.
client = anthropic.Anthropic()
deleted_invite = client.organization.invites.delete("invite_01QrStUvWxYzAbCdEfGhIj")
print(f"id: {deleted_invite.id}")Группы
Группы, которые ваше предприятие создаёт напрямую — в настройках организации claude.ai или через этот API (source_type: "direct"), — поддерживают все эндпоинты этого раздела. Группы, предоставленные вашим поставщиком удостоверений (source_type: "scim"), можно читать, но нельзя изменять: переименование или удаление группы SCIM, а также изменение её состава возвращает 400, поскольку ею владеет ваш поставщик удостоверений.
Получение списка групп
GET /v1/organizations/rbac_groups возвращает группы вашего предприятия, включая группы, управляемые поставщиком удостоверений (scim). Требуется область доступа read:rbac_groups.
Полное описание параметров и схем ответов см. в разделе List groups справочника API.
client = anthropic.Anthropic()
groups = client.beta.organization.rbac_groups.list(limit=20)
for group in groups:
print(f"{group.id}: {group.name} ({group.source_type})"){
"data": [
{
"type": "rbac_group",
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"name": "Engineering",
"source_type": "direct",
"role_ids": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
"roles": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
"created_at": "2026-03-18T10:01:42Z",
"updated_at": "2026-05-02T08:55:09Z"
}
],
"has_more": false,
"next_page": null
}Получение группы
GET /v1/organizations/rbac_groups/{rbac_group_id} возвращает одну группу по идентификатору. Требуется область доступа read:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Get group справочника API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.retrieve(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"id: {group.id}")
print(f"name: {group.name}")
print(f"source_type: {group.source_type}")Создание группы
POST /v1/organizations/rbac_groups создаёт группу с заданным name (1–255 символов) без ролей и участников. Требуется область доступа write:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Create group справочника API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.create(name="Engineering")
print(f"id: {group.id}")
print(f"name: {group.name}"){
"type": "rbac_group",
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"name": "Engineering",
"source_type": "direct",
"role_ids": [],
"roles": [],
"created_at": "2026-07-09T18:00:00Z",
"updated_at": "2026-07-09T18:00:00Z"
}Переименование группы
POST /v1/organizations/rbac_groups/{rbac_group_id} обновляет группу. name — единственное поле, которое может изменить этот эндпоинт. Требуется область доступа write:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Update group справочника API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.update(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", name="Platform Engineering"
)
print(f"id: {group.id}")
print(f"name: {group.name}")Удаление группы
DELETE /v1/organizations/rbac_groups/{rbac_group_id} удаляет группу. Её участники остаются участниками своих организаций, но теряют разрешения привязанных к ней ролей, а лимит расходов группы, если он был, перестаёт к ним применяться. Требуется область доступа write:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Delete group справочника API.
client = anthropic.Anthropic()
deleted_group = client.beta.organization.rbac_groups.delete(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"id: {deleted_group.id}"){
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"type": "rbac_group_deleted"
}Получение списка участников группы
GET /v1/organizations/rbac_groups/{rbac_group_id}/members возвращает участников группы (каждого с его user_id и адресом электронной почты), начиная с самых давних. Возвращаются только текущие участники организаций вашего предприятия, поэтому страница может содержать меньше записей, чем limit, при has_more, равном true. Требуется область доступа read:rbac_groups.
Полное описание параметров и схем ответов см. в разделе List group members справочника API.
client = anthropic.Anthropic()
members = client.beta.organization.rbac_groups.members.list(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", limit=100
)
for member in members:
print(f"{member.user_id}: {member.email}"){
"data": [
{
"type": "rbac_group_member",
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"created_at": "2026-04-07T12:30:00Z"
}
],
"has_more": false,
"next_page": null
}Добавление участника в группу
POST /v1/organizations/rbac_groups/{rbac_group_id}/members добавляет участника организации в группу по user_id. Пользователь уже должен быть участником одной из организаций вашего предприятия (иначе запрос возвращает 404), а добавление того, кто уже состоит в группе, возвращает 400. Для групп scim составом управляет ваш поставщик удостоверений, и этот запрос возвращает 400. Чтобы назначить группы человеку, который ещё не присоединился, используйте вместо этого rbac_group_ids при создании приглашения. Требуется область доступа write:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Add group member справочника API.
client = anthropic.Anthropic()
member = client.beta.organization.rbac_groups.members.add(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", user_id="user_01AbCdEfGhIjKlMnOpQrSt"
)
print(f"user_id: {member.user_id}")
print(f"email: {member.email}"){
"type": "rbac_group_member",
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"created_at": "2026-07-09T18:00:00Z"
}Удаление участника из группы
DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} удаляет участника из группы; он остаётся участником своей организации. Запрос возвращает 404, если пользователь не состоит в группе, и 400 для групп scim, составом которых управляет ваш поставщик удостоверений. Требуется область доступа write:rbac_groups.
Полное описание параметров и схем ответов см. в разделе Remove group member справочника API.
client = anthropic.Anthropic()
removed_member = client.beta.organization.rbac_groups.members.remove(
"user_01AbCdEfGhIjKlMnOpQrSt", rbac_group_id="rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"user_id: {removed_member.user_id}"){
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"type": "rbac_group_member_deleted"
}Пользовательские роли
Через API пользовательские роли доступны только для чтения: эти эндпоинты предоставляют каталог пользовательских ролей вашей организации (определённых в настройках организации claude.ai или предоставленных Anthropic) и разрешений, которые предоставляет каждая роль. Чтение пользовательских ролей использует область доступа read:members (отдельной области доступа для ролей нет) и работает с ключом уровня организации: в отличие от эндпоинтов групп, они не требуют ключа, созданного для всех связанных организаций, а возвращаемый каталог принадлежит вашей собственной организации.
Название роли берите из её поля display_name. Для роли, предоставленной Anthropic, display_name может отличаться от метки, которую показывает claude.ai, и Anthropic может изменить это название. Чтобы сохранить постоянную ссылку на роль, храните её id.
Получение списка ролей
GET /v1/organizations/rbac_roles возвращает пользовательские роли вашей организации. Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе List roles справочника API.
client = anthropic.Anthropic()
roles = client.beta.organization.rbac_roles.list(limit=20)
for role in roles:
print(f"{role.id}: {role.display_name}"){
"data": [
{
"type": "rbac_role",
"id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",
"display_name": "Engineering base",
"name": "Engineering base",
"created_at": "2026-03-18T10:01:42Z",
"updated_at": "2026-05-02T08:55:09Z"
}
],
"has_more": false,
"next_page": null
}Получение роли
GET /v1/organizations/rbac_roles/{rbac_role_id} возвращает одну роль по идентификатору. Требуется область доступа read:members.
Полное описание параметров и схем ответов см. в разделе Get role справочника API.
client = anthropic.Anthropic()
role = client.beta.organization.rbac_roles.retrieve("rbac_role_01CdEfGhIjKlMnOpQrStUv")
print(f"id: {role.id}")
print(f"display_name: {role.display_name}")Получение списка разрешений роли
GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions возвращает разрешения роли. Каждое разрешение сочетает resource (к чему оно применяется: функции продукта организации, инструмент коннектора, область OAuth коннектора, один коннектор или все коннекторы) с action (что оно предоставляет для этого ресурса). Строки для функций, не включённых для вашей организации, опускаются, поэтому страница может содержать меньше строк, чем limit, при has_more, равном true. Требуется область доступа read:members.
Два значения action требуют особого внимания: разрешение organization с действием capability_access_all (все функции продукта) или capability_access_all_ga (все стабильные функции продукта, то есть все функции, не помеченные как бета-версия или исследовательская предварительная версия) является общим разрешением (которое не охватывает ни доступ к моделям, ни разрешения панели администратора с префиксом permission_) и указывается одной строкой, а не разворачивается. Подсчитывая, что предоставляет роль, считайте, что общая строка охватывает всё, что описывает её вариант, а не только функции, названные в других строках.
Полное описание параметров и схем ответов см. в разделе List role permissions справочника API.
client = anthropic.Anthropic()
permissions = client.beta.organization.rbac_roles.permissions.list(
"rbac_role_01CdEfGhIjKlMnOpQrStUv", limit=20
)
for permission in permissions:
print(permission.action){
"data": [
{
"type": "rbac_role_permission",
"resource": {
"type": "organization",
"organization_id": "12345678-1234-5678-1234-567812345678"
},
"action": "capability_access_all_ga"
},
{
"type": "rbac_role_permission",
"resource": {
"type": "connector_tool",
"connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",
"tool_name": "search_tickets"
},
"action": "use"
}
],
"has_more": false,
"next_page": null
}Примеры рабочих процессов
Отключение уходящего сотрудника
-
Найдите участника по электронной почте:
Pythonclient = anthropic.Anthropic() users = client.organization.users.list(email="departing@example.com") for user in users: print(f"{user.id}: {user.email} ({user.role})") -
Удалите его с помощью
DELETE /v1/organizations/users/{user_id}, используяidиз ответа. Его место, если оно было, возвращается в пул. -
Если человек ещё не присоединился, поиск не вернёт участника; в этом случае получите список приглашений и отзовите его приглашение в статусе
pending.
Аудит состава групп
-
Получите список групп и запишите
id,nameиrole_idsкаждой группы. -
Для каждой группы с конфиденциальными ролями пройдите по страницам
GET /v1/organizations/rbac_groups/{rbac_group_id}/membersи сравните адреса электронной почты участников со списком в вашем поставщике удостоверений. -
Удалите участников, которые больше не должны состоять в группе, с помощью
DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}. Для группscimвместо этого внесите изменение в вашем поставщике удостоверений.
Рабочий процесс, сочетающий состав группы с временным повышением лимита расходов, см. в разделе Временное повышение лимита расходов участника во время инцидента на странице Spend Limits API.
Часто задаваемые вопросы
Это отдельный API, отличный от Admin API?
Нет. Эндпоинты участников и приглашений — это те же эндпоинты /v1/organizations/, которые используют организации Claude Console; на этой странице описано их поведение в Claude Enterprise. Эндпоинты групп и пользовательских ролей являются частью того же API и существуют только для организаций Claude Enterprise. В таблице доступности показано, какие эндпоинты может вызывать каждый тип организации.
Можно ли назначить роль владельца или администратора участников через API?
Нет. API назначает только user и managed — при создании приглашения и обновлении роли. Административные роли назначаются в настройках организации claude.ai, а участников с этими ролями нельзя изменить или удалить через API.
Можно ли создавать или изменять группы через API?
Да, с областью доступа write:rbac_groups: создавать, переименовывать и удалять группы, а также добавлять и удалять их участников. Две вещи API изменить не может: группы, предоставленные вашим поставщиком удостоверений (source_type: "scim"), названием и составом которых владеет поставщик удостоверений, и пользовательские роли, которые управляются в настройках организации claude.ai (API их читает).
Занимает ли непринятое приглашение место?
В тарифных планах с ограниченным пулом мест — да: приглашение в статусе pending удерживает место. Отзыв приглашения или истечение его срока освобождает место. В тарифных планах без пула мест приглашения ничего не занимают.
Моя организация использует единый вход. Какие операции работают?
Если ваш поставщик удостоверений автоматически предоставляет пользователей (JIT или SCIM), создание приглашений возвращает 400. Если он управляет ролями (расширенный SSO или расширенное предоставление через SCIM), обновления ролей возвращают 400. Если он управляет членством (предоставление через SCIM), удаление участников возвращает 400. Операции чтения работают в любом случае.
Что происходит с ключом Admin API, когда создавший его человек уходит?
Ключ продолжает работать. Ключи Admin API привязаны к организации, а не к отдельным пользователям, и ключ, созданный в claude.ai, не имеет срока действия. Удаление создателя из организации или отзыв его учётной записи через поставщика удостоверений прекращает его собственный доступ, но не созданные им ключи. Понижение его роли также не влияет на ключи: каждый ключ остаётся активным с исходными областями доступа. При отключении человека, создававшего ключи Admin API, удалите эти ключи в разделе Keys в claude.ai > Organization settings > API и создайте замену.
См. также
Где основной владелец создаёт ключ с областями доступа и какие области выбрать.
Аудит активности, а также получение или удаление пользовательского контента во всей организации.
Отчёты об использовании и затратах по пользователям и временным интервалам для Claude Enterprise.
Установка лимитов расходов для участников и рассмотрение запросов на их повышение.
Was this page helpful?