--- title: Управление пользователями url: https://platform.claude.com/docs/ru/manage-claude/user-management description: "Управляйте людьми в вашей организации Claude Enterprise с помощью Admin API: просматривайте список участников и меняйте их роли, отправляйте и отзывайте приглашения, управляйте группами и читайте пользовательские роли." --- На этой странице описано программное управление людьми в вашей организации **Claude Enterprise** (claude.ai) с помощью [Admin API](https://platform.claude.com/docs/ru/api/beta/organization): получение списка участников и поиск их по адресу электронной почты, изменение роли участника, удаление участников, отправка и отзыв приглашений, управление группами вашего предприятия и их составом, а также чтение пользовательских ролей вашей организации. Для организаций Claude Console (Claude Platform) см. [руководство по Admin API для Claude Console](https://platform.claude.com/docs/ru/manage-claude/admin-api). Запросы к группам и пользовательским ролям не требуют [бета-заголовка](https://platform.claude.com/docs/ru/api/beta-headers) `anthropic-beta: ce-user-management-2026-07-13`. Запросы, которые по-прежнему его отправляют, принимаются и работают идентично. ## Какие эндпоинты может использовать ваша организация? Admin API — это единый набор эндпоинтов по адресу `https://api.anthropic.com/v1/organizations/`. Организации Claude Console и Claude Enterprise проходят аутентификацию с помощью [разных ключей](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys), и каждой из них доступно своё подмножество эндпоинтов: | Эндпоинты | Claude Console (Claude Platform) | Claude Enterprise (claude.ai) | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Участники](https://platform.claude.com/docs/ru/manage-claude/user-management#members) и [приглашения](https://platform.claude.com/docs/ru/manage-claude/user-management#invites) | Доступны; см. [руководство по Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) | Доступны (эта страница) | | [Группы](https://platform.claude.com/docs/ru/manage-claude/user-management#groups) | Недоступны | Доступны (эта страница) | | [Пользовательские роли](https://platform.claude.com/docs/ru/manage-claude/user-management#custom-roles) | Недоступны | Доступны, только чтение (эта страница) | | [Плагины](https://platform.claude.com/docs/ru/manage-claude/plugins-api) | Недоступны | Доступны в бета-версии | | [Лимиты расходов](https://platform.claude.com/docs/ru/manage-claude/spend-limits-api) | Недоступны | Доступны | | Отчёты об использовании и затратах | Доступны; см. [Usage and Cost API](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api) | Доступны через [Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) | | [Рабочие пространства](https://platform.claude.com/docs/ru/manage-claude/workspaces), [ключи API](https://platform.claude.com/docs/ru/manage-claude/admin-api#api-keys), [ограничения скорости](https://platform.claude.com/docs/ru/manage-claude/rate-limits-api) и другие эндпоинты из [руководства по Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) | Доступны | Недоступны | Эндпоинты участников и приглашений одинаковы для обоих типов организаций; на этой странице описано их поведение в Claude Enterprise, включая [роли организации](https://platform.claude.com/docs/ru/manage-claude/user-management#organization-roles) Claude Enterprise. Эндпоинты групп и пользовательских ролей существуют только для Claude Enterprise. **Требуется ключ Admin API с областями доступа** Для этих эндпоинтов требуется ключ Admin API с областью доступа `read:members` (эндпоинты `GET` для участников и приглашений, а также все эндпоинты пользовательских ролей; отдельной области доступа для ролей нет), областью `write:members` (эндпоинты `POST` и `DELETE` для участников и приглашений), областью `read:rbac_groups` (эндпоинты `GET` для групп) или областью `write:rbac_groups` (эндпоинты `POST` и `DELETE` для групп). Назначение роли `managed` или групп в приглашении требует `write:rbac_groups` в дополнение к `write:members`. Ключ с областью доступа `read:org_audit` (область только для чтения, предназначенная для интеграций аудита безопасности) также может вызывать все эндпоинты `GET` на этой странице и эндпоинты чтения [Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api). О том, где основной владелец создаёт такой ключ и какие области доступа выбрать, см. [Создание ключа Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api-keys#create-a-key-for-a-claude-enterprise-organization). Передавайте ключ в заголовке `x-api-key` в каждом запросе вместе с заголовком [`anthropic-version`](https://platform.claude.com/docs/ru/api/versioning). ## Обзор На этой странице описаны пять ресурсов: | Ресурс | Эндпоинты | Назначение | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | **Участники** | `GET /v1/organizations/users`
`GET /v1/organizations/users/{user_id}`
`POST /v1/organizations/users/{user_id}`
`DELETE /v1/organizations/users/{user_id}` | Получение списка участников организации или поиск участника по электронной почте; изменение роли участника; удаление участника. | | **Приглашения** | `POST /v1/organizations/invites`
`GET /v1/organizations/invites`
`GET /v1/organizations/invites/{invite_id}`
`DELETE /v1/organizations/invites/{invite_id}` | Приглашение человека в организацию, отслеживание статуса приглашения и его отзыв до принятия. | | **Группы** | `GET /v1/organizations/rbac_groups`
`GET /v1/organizations/rbac_groups/{rbac_group_id}`
`POST /v1/organizations/rbac_groups`
`POST /v1/organizations/rbac_groups/{rbac_group_id}`
`DELETE /v1/organizations/rbac_groups/{rbac_group_id}` | Чтение групп вашего предприятия и привязанных к каждой из них пользовательских ролей; создание, переименование и удаление групп. | | **Участники групп** | `GET /v1/organizations/rbac_groups/{rbac_group_id}/members`
`POST /v1/organizations/rbac_groups/{rbac_group_id}/members`
`DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}` | Чтение участников группы; добавление и удаление участников. | | **Пользовательские роли** | `GET /v1/organizations/rbac_roles`
`GET /v1/organizations/rbac_roles/{rbac_role_id}`
`GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions` | Чтение пользовательских ролей вашей организации и разрешений, которые предоставляет каждая роль. | Пользовательские роли и их привязки к группам управляются в [настройках организации claude.ai](https://claude.ai/admin-settings); API может их читать, но не может изменять. ## Быстрый старт Задайте в переменной окружения `ANTHROPIC_API_KEY` ваш ключ Admin API. Примеры на этой странице считывают ключ из неё. SDK и CLI `ant` отправляют заголовки `Authorization` и `anthropic-version` за вас. Получите список участников организации, начиная с самых новых: ```bash cURL curl "https://api.anthropic.com/v1/organizations/users?limit=20" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:users list --limit 20 ``` ```python Python client = anthropic.Anthropic() users = client.organization.users.list(limit=20) for user in users: print(f"{user.id}: {user.email} ({user.role})") ``` ```typescript TypeScript const client = new Anthropic(); const users = await client.organization.users.list({ limit: 20 }); for await (const user of users) { console.log(`${user.id}: ${user.email} (${user.role})`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Organization.Users.List(new() { Limit = 20 }); await foreach (var user in page.Paginate()) { Console.WriteLine($"{user.ID}: {user.Email} ({user.Role.Raw()})"); } ``` ```go Go client := anthropic.NewClient() users := client.Organization.Users.ListAutoPaging(context.Background(), anthropic.OrganizationUserListParams{ Limit: anthropic.Int(20), }) for users.Next() { user := users.Current() fmt.Printf("%s: %s (%s)\n", user.ID, user.Email, user.Role) } if err := users.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.organization.users.UserListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = UserListParams.builder() .limit(20) .build(); var users = client.organization().users().list(params); for (var user : users.autoPager()) { IO.println(user.id() + ": " + user.email() + " (" + user.role().asString() + ")"); } } ``` ```php PHP $client = new Client(); $users = $client->organization->users->list(limit: 20); foreach ($users->pagingEachItem() as $user) { echo "{$user->id}: {$user->email} ({$user->role})\n"; } ``` ```ruby Ruby client = Anthropic::Client.new users = client.organization.users.list(limit: 20) users.auto_paging_each do |user| puts "#{user.id}: #{user.email} (#{user.role})" end ``` ```json { "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` группы содержит идентификаторы привязанных к ней пользовательских ролей; получить их названия и разрешения можно с помощью [эндпоинтов пользовательских ролей](https://platform.claude.com/docs/ru/manage-claude/user-management#custom-roles). Учтите, что каталог ролей ведётся для каждой организации отдельно, а группы действуют на уровне всего предприятия, поэтому запрос роли, принадлежащей другой организации вашего предприятия, вернёт для вашего ключа 404. Поле имеет значение `null` (а не `[]`), если данные о ролях были временно недоступны, поэтому повторите запрос, чтобы отличить неполное чтение от группы без ролей. ## Версионирование Отправляйте заголовок `anthropic-version` в каждом запросе; доступные версии см. в разделе [Версии API](https://platform.claude.com/docs/ru/api/versioning). ## Ограничения скорости Эндпоинты 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` задаёт общее количество результатов для списков участников и приглашений. Для списков групп и ролей он задаёт размер страницы. ## Ответы с ошибками Ответы с ошибками имеют стандартную структуру, описанную в разделе [Ошибки](https://platform.claude.com/docs/ru/api/errors). ## Участники ### Получение списка участников `GET /v1/organizations/users` возвращает участников организации, начиная с добавленных последними. Используйте фильтр `email`, чтобы найти конкретного участника; сопоставление не зависит от регистра и допускает распространённые варианты одного и того же адреса (например, `jane+hiring@example.com` соответствует `jane@example.com`). Требуется область доступа `read:members`. Полное описание параметров и схем ответов см. в разделе [List users](https://platform.claude.com/docs/ru/api/organization/users/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/users?email=jane@example.com" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:users list --email jane@example.com ``` ```python Python client = anthropic.Anthropic() users = client.organization.users.list(email="jane@example.com") for user in users: print(f"{user.id}: {user.email} ({user.role})") ``` ```typescript TypeScript const client = new Anthropic(); const users = await client.organization.users.list({ email: "jane@example.com" }); for await (const user of users) { console.log(`${user.id}: ${user.email} (${user.role})`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Organization.Users.List(new() { Email = "jane@example.com" }); await foreach (var user in page.Paginate()) { Console.WriteLine($"{user.ID}: {user.Email} ({user.Role.Raw()})"); } ``` ```go Go client := anthropic.NewClient() users := client.Organization.Users.ListAutoPaging(context.Background(), anthropic.OrganizationUserListParams{ Email: anthropic.String("jane@example.com"), }) for users.Next() { user := users.Current() fmt.Printf("%s: %s (%s)\n", user.ID, user.Email, user.Role) } if err := users.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.organization.users.UserListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = UserListParams.builder() .email("jane@example.com") .build(); var users = client.organization().users().list(params); for (var user : users.autoPager()) { IO.println(user.id() + ": " + user.email() + " (" + user.role().asString() + ")"); } } ``` ```php PHP $client = new Client(); $users = $client->organization->users->list(email: 'jane@example.com'); foreach ($users->pagingEachItem() as $user) { echo "{$user->id}: {$user->email} ({$user->role})\n"; } ``` ```ruby Ruby client = Anthropic::Client.new users = client.organization.users.list(email: "jane@example.com") users.auto_paging_each do |user| puts "#{user.id}: #{user.email} (#{user.role})" end ``` ### Получение участника `GET /v1/organizations/users/{user_id}` возвращает одного участника по идентификатору. Требуется область доступа `read:members`. Полное описание параметров и схем ответов см. в разделе [Get user](https://platform.claude.com/docs/ru/api/organization/users/retrieve) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:users retrieve --user-id user_01AbCdEfGhIjKlMnOpQrSt ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const user = await client.organization.users.retrieve("user_01AbCdEfGhIjKlMnOpQrSt"); console.log(`id: ${user.id}`); console.log(`email: ${user.email}`); console.log(`role: ${user.role}`); ``` ```csharp C# AnthropicClient client = new(); var user = await client.Organization.Users.Retrieve("user_01AbCdEfGhIjKlMnOpQrSt"); Console.WriteLine($"id: {user.ID}"); Console.WriteLine($"email: {user.Email}"); Console.WriteLine($"role: {user.Role.Raw()}"); ``` ```go Go client := anthropic.NewClient() user, err := client.Organization.Users.Get(context.Background(), "user_01AbCdEfGhIjKlMnOpQrSt") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", user.ID) fmt.Printf("email: %s\n", user.Email) fmt.Printf("role: %s\n", user.Role) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var user = client.organization().users() .retrieve("user_01AbCdEfGhIjKlMnOpQrSt"); IO.println("id: " + user.id()); IO.println("email: " + user.email()); IO.println("role: " + user.role().asString()); ``` ```php PHP $client = new Client(); $user = $client->organization->users->retrieve( userID: 'user_01AbCdEfGhIjKlMnOpQrSt', ); echo "id: {$user->id}\n"; echo "email: {$user->email}\n"; echo "role: {$user->role}\n"; ``` ```ruby Ruby client = Anthropic::Client.new user = client.organization.users.retrieve("user_01AbCdEfGhIjKlMnOpQrSt") puts "id: #{user.id}" puts "email: #{user.email}" puts "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](https://platform.claude.com/docs/ru/api/organization/users/update) справочника API. ```bash cURL curl -X POST "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{"role": "managed"}' ``` ```bash CLI ant organization:users update \ --user-id user_01AbCdEfGhIjKlMnOpQrSt \ --role managed ``` ```python Python client = anthropic.Anthropic() user = client.organization.users.update("user_01AbCdEfGhIjKlMnOpQrSt", role="managed") print(f"id: {user.id}") print(f"role: {user.role}") ``` ```typescript TypeScript const client = new Anthropic(); const user = await client.organization.users.update("user_01AbCdEfGhIjKlMnOpQrSt", { role: "managed" }); console.log(`id: ${user.id}`); console.log(`role: ${user.role}`); ``` ```csharp C# using Anthropic.Models.Organization.Users; // ... AnthropicClient client = new(); var user = await client.Organization.Users.Update( "user_01AbCdEfGhIjKlMnOpQrSt", new() { Role = Role.Managed } ); Console.WriteLine($"id: {user.ID}"); Console.WriteLine($"role: {user.Role.Raw()}"); ``` ```go Go client := anthropic.NewClient() user, err := client.Organization.Users.Update( context.Background(), "user_01AbCdEfGhIjKlMnOpQrSt", anthropic.OrganizationUserUpdateParams{ Role: anthropic.OrganizationUserUpdateParamsRoleManaged, }, ) if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", user.ID) fmt.Printf("role: %s\n", user.Role) ``` ```java Java import com.anthropic.models.organization.users.UserUpdateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = UserUpdateParams.builder() .role(UserUpdateParams.Role.MANAGED) .build(); var user = client.organization().users() .update("user_01AbCdEfGhIjKlMnOpQrSt", params); IO.println("id: " + user.id()); IO.println("role: " + user.role().asString()); } ``` ```php PHP use Anthropic\Organization\Users\UserUpdateParams\Role; // ... $client = new Client(); $user = $client->organization->users->update( userID: 'user_01AbCdEfGhIjKlMnOpQrSt', role: Role::MANAGED, ); echo "id: {$user->id}\n"; echo "role: {$user->role}\n"; ``` ```ruby Ruby client = Anthropic::Client.new user_id = "user_01AbCdEfGhIjKlMnOpQrSt" user = client.organization.users.update(user_id, role: :managed) puts "id: #{user.id}" puts "role: #{user.role}" ``` ### Удаление участника `DELETE /v1/organizations/users/{user_id}` удаляет участника из организации, возвращая занимаемое им купленное место в пул организации. Участников с административной ролью нельзя удалить через этот эндпоинт, а если членством управляет ваш поставщик удостоверений (SCIM), удаления возвращают 400. Требуется область доступа `write:members`. Полное описание параметров и схем ответов см. в разделе [Remove user](https://platform.claude.com/docs/ru/api/organization/users/remove) справочника API. ```bash cURL curl -X DELETE "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:users remove --user-id user_01AbCdEfGhIjKlMnOpQrSt ``` ```python Python client = anthropic.Anthropic() removed_user = client.organization.users.remove("user_01AbCdEfGhIjKlMnOpQrSt") print(f"id: {removed_user.id}") ``` ```typescript TypeScript const client = new Anthropic(); const removedUser = await client.organization.users.remove("user_01AbCdEfGhIjKlMnOpQrSt"); console.log(`id: ${removedUser.id}`); ``` ```csharp C# AnthropicClient client = new(); var removedUser = await client.Organization.Users.Remove("user_01AbCdEfGhIjKlMnOpQrSt"); Console.WriteLine($"id: {removedUser.ID}"); ``` ```go Go client := anthropic.NewClient() removedUser, err := client.Organization.Users.Remove(context.Background(), "user_01AbCdEfGhIjKlMnOpQrSt") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", removedUser.ID) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var removedUser = client.organization().users() .remove("user_01AbCdEfGhIjKlMnOpQrSt"); IO.println("id: " + removedUser.id()); ``` ```php PHP $client = new Client(); $removedUser = $client->organization->users->remove( userID: 'user_01AbCdEfGhIjKlMnOpQrSt', ); echo "id: {$removedUser->id}\n"; ``` ```ruby Ruby client = Anthropic::Client.new user_id = "user_01AbCdEfGhIjKlMnOpQrSt" removed_user = client.organization.users.remove(user_id) puts "id: #{removed_user.id}" ``` ```json { "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](https://platform.claude.com/docs/ru/api/organization/invites/create) справочника API. ```bash cURL curl -X POST "https://api.anthropic.com/v1/organizations/invites" \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "email": "newhire@example.com", "role": "managed", "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"] }' ``` ```bash CLI ant organization:invites create \ --email newhire@example.com \ --role managed \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const invite = await client.organization.invites.create({ email: "newhire@example.com", role: "managed", rbac_group_ids: ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"] }); console.log(`id: ${invite.id}`); console.log(`email: ${invite.email}`); console.log(`status: ${invite.status}`); console.log(`expires_at: ${invite.expires_at}`); ``` ```csharp C# using Anthropic.Models.Organization.Invites; // ... AnthropicClient client = new(); var invite = await client.Organization.Invites.Create(new() { Email = "newhire@example.com", Role = Role.Managed, RbacGroupIds = ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"] }); Console.WriteLine($"id: {invite.ID}"); Console.WriteLine($"email: {invite.Email}"); Console.WriteLine($"status: {invite.Status.Raw()}"); Console.WriteLine($"expires_at: {invite.ExpiresAt:O}"); ``` ```go Go client := anthropic.NewClient() invite, err := client.Organization.Invites.New(context.Background(), anthropic.OrganizationInviteNewParams{ Email: "newhire@example.com", Role: anthropic.OrganizationInviteNewParamsRoleManaged, RBACGroupIDs: []string{"rbac_group_01UvWxYzAbCdEfGhIjKlMn"}, }) if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", invite.ID) fmt.Printf("email: %s\n", invite.Email) fmt.Printf("status: %s\n", invite.Status) fmt.Printf("expires_at: %s\n", invite.ExpiresAt.Format(time.RFC3339)) ``` ```java Java import com.anthropic.models.organization.invites.InviteCreateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = InviteCreateParams.builder() .email("newhire@example.com") .role(InviteCreateParams.Role.MANAGED) .addRbacGroupId("rbac_group_01UvWxYzAbCdEfGhIjKlMn") .build(); var invite = client.organization().invites().create(params); IO.println("id: " + invite.id()); IO.println("email: " + invite.email()); IO.println("status: " + invite.status().asString()); IO.println("expires_at: " + invite.expiresAt()); } ``` ```php PHP use Anthropic\Organization\Invites\InviteCreateParams\Role; // ... $client = new Client(); $invite = $client->organization->invites->create( email: 'newhire@example.com', role: Role::MANAGED, rbacGroupIDs: ['rbac_group_01UvWxYzAbCdEfGhIjKlMn'], ); echo "id: {$invite->id}\n"; echo "email: {$invite->email}\n"; echo "status: {$invite->status}\n"; echo "expires_at: {$invite->expiresAt->format(DATE_ATOM)}\n"; ``` ```ruby Ruby client = Anthropic::Client.new invite = client.organization.invites.create( email: "newhire@example.com", role: :managed, rbac_group_ids: ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"] ) puts "id: #{invite.id}" puts "email: #{invite.email}" puts "status: #{invite.status}" puts "expires_at: #{invite.expires_at.iso8601}" ``` ```json { "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](https://platform.claude.com/docs/ru/api/organization/invites/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/invites?limit=20" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:invites list --limit 20 ``` ```python Python client = anthropic.Anthropic() invites = client.organization.invites.list(limit=20) for invite in invites: print(f"{invite.id}: {invite.email} ({invite.status})") ``` ```typescript TypeScript const client = new Anthropic(); const invites = await client.organization.invites.list({ limit: 20 }); for await (const invite of invites) { console.log(`${invite.id}: ${invite.email} (${invite.status})`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Organization.Invites.List(new() { Limit = 20 }); await foreach (var invite in page.Paginate()) { Console.WriteLine($"{invite.ID}: {invite.Email} ({invite.Status.Raw()})"); } ``` ```go Go client := anthropic.NewClient() invites := client.Organization.Invites.ListAutoPaging(context.Background(), anthropic.OrganizationInviteListParams{ Limit: anthropic.Int(20), }) for invites.Next() { invite := invites.Current() fmt.Printf("%s: %s (%s)\n", invite.ID, invite.Email, invite.Status) } if err := invites.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.organization.invites.InviteListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = InviteListParams.builder() .limit(20) .build(); var invites = client.organization().invites().list(params); for (var invite : invites.autoPager()) { IO.println(invite.id() + ": " + invite.email() + " (" + invite.status().asString() + ")"); } } ``` ```php PHP $client = new Client(); $invites = $client->organization->invites->list(limit: 20); foreach ($invites->pagingEachItem() as $invite) { echo "{$invite->id}: {$invite->email} ({$invite->status})\n"; } ``` ```ruby Ruby client = Anthropic::Client.new invites = client.organization.invites.list(limit: 20) invites.auto_paging_each do |invite| puts "#{invite.id}: #{invite.email} (#{invite.status})" end ``` ### Получение приглашения `GET /v1/organizations/invites/{invite_id}` возвращает одно приглашение по идентификатору. Требуется область доступа `read:members`. Полное описание параметров и схем ответов см. в разделе [Get invite](https://platform.claude.com/docs/ru/api/organization/invites/retrieve) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:invites retrieve --invite-id invite_01QrStUvWxYzAbCdEfGhIj ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const invite = await client.organization.invites.retrieve("invite_01QrStUvWxYzAbCdEfGhIj"); console.log(`id: ${invite.id}`); console.log(`email: ${invite.email}`); console.log(`status: ${invite.status}`); ``` ```csharp C# AnthropicClient client = new(); var invite = await client.Organization.Invites.Retrieve("invite_01QrStUvWxYzAbCdEfGhIj"); Console.WriteLine($"id: {invite.ID}"); Console.WriteLine($"email: {invite.Email}"); Console.WriteLine($"status: {invite.Status.Raw()}"); ``` ```go Go client := anthropic.NewClient() invite, err := client.Organization.Invites.Get(context.Background(), "invite_01QrStUvWxYzAbCdEfGhIj") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", invite.ID) fmt.Printf("email: %s\n", invite.Email) fmt.Printf("status: %s\n", invite.Status) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var invite = client.organization().invites() .retrieve("invite_01QrStUvWxYzAbCdEfGhIj"); IO.println("id: " + invite.id()); IO.println("email: " + invite.email()); IO.println("status: " + invite.status().asString()); ``` ```php PHP $client = new Client(); $invite = $client->organization->invites->retrieve( inviteID: 'invite_01QrStUvWxYzAbCdEfGhIj', ); echo "id: {$invite->id}\n"; echo "email: {$invite->email}\n"; echo "status: {$invite->status}\n"; ``` ```ruby Ruby client = Anthropic::Client.new invite = client.organization.invites.retrieve("invite_01QrStUvWxYzAbCdEfGhIj") puts "id: #{invite.id}" puts "email: #{invite.email}" puts "status: #{invite.status}" ``` ### Отзыв приглашения `DELETE /v1/organizations/invites/{invite_id}` отзывает приглашение в статусе `pending`, деактивируя ссылку в письме с приглашением. Отзыв приглашения в статусе `accepted` возвращает 400 (вместо этого удалите участника); отзыв приглашения в статусе `expired` возвращает 400. Требуется область доступа `write:members`. Полное описание параметров и схем ответов см. в разделе [Delete invite](https://platform.claude.com/docs/ru/api/organization/invites/delete) справочника API. ```bash cURL curl -X DELETE "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:invites delete --invite-id invite_01QrStUvWxYzAbCdEfGhIj ``` ```python Python client = anthropic.Anthropic() deleted_invite = client.organization.invites.delete("invite_01QrStUvWxYzAbCdEfGhIj") print(f"id: {deleted_invite.id}") ``` ```typescript TypeScript const client = new Anthropic(); const deletedInvite = await client.organization.invites.delete( "invite_01QrStUvWxYzAbCdEfGhIj" ); console.log(`id: ${deletedInvite.id}`); ``` ```csharp C# AnthropicClient client = new(); var deletedInvite = await client.Organization.Invites.Delete("invite_01QrStUvWxYzAbCdEfGhIj"); Console.WriteLine($"id: {deletedInvite.ID}"); ``` ```go Go client := anthropic.NewClient() deletedInvite, err := client.Organization.Invites.Delete(context.Background(), "invite_01QrStUvWxYzAbCdEfGhIj") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", deletedInvite.ID) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var deletedInvite = client.organization().invites() .delete("invite_01QrStUvWxYzAbCdEfGhIj"); IO.println("id: " + deletedInvite.id()); ``` ```php PHP $client = new Client(); $deletedInvite = $client->organization->invites->delete( inviteID: 'invite_01QrStUvWxYzAbCdEfGhIj', ); echo "id: {$deletedInvite->id}\n"; ``` ```ruby Ruby client = Anthropic::Client.new invite_id = "invite_01QrStUvWxYzAbCdEfGhIj" deleted_invite = client.organization.invites.delete(invite_id) puts "id: #{deleted_invite.id}" ``` ## Группы Группы, которые ваше предприятие создаёт напрямую — в [настройках организации claude.ai](https://claude.ai/admin-settings) или через этот API (`source_type: "direct"`), — поддерживают все эндпоинты этого раздела. Группы, предоставленные вашим поставщиком удостоверений (`source_type: "scim"`), можно читать, но нельзя изменять: переименование или удаление группы SCIM, а также изменение её состава возвращает 400, поскольку ею владеет ваш поставщик удостоверений. ### Получение списка групп `GET /v1/organizations/rbac_groups` возвращает группы вашего предприятия, включая группы, управляемые поставщиком удостоверений (`scim`). Требуется область доступа `read:rbac_groups`. Полное описание параметров и схем ответов см. в разделе [List groups](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_groups?limit=20" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-groups list --limit 20 ``` ```python Python 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})") ``` ```typescript TypeScript const client = new Anthropic(); const groups = await client.beta.organization.rbacGroups.list({ limit: 20 }); for await (const group of groups) { console.log(`${group.id}: ${group.name} (${group.source_type})`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Beta.Organization.RbacGroups.List(new() { Limit = 20 }); await foreach (var group in page.Paginate()) { Console.WriteLine($"{group.ID}: {group.Name} ({group.SourceType.Raw()})"); } ``` ```go Go client := anthropic.NewClient() groups := client.Beta.Organization.RBACGroups.ListAutoPaging(context.Background(), anthropic.BetaOrganizationRBACGroupListParams{ Limit: anthropic.Int(20), }) for groups.Next() { group := groups.Current() fmt.Printf("%s: %s (%s)\n", group.ID, group.Name, group.SourceType) } if err := groups.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.RbacGroupListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = RbacGroupListParams.builder() .limit(20) .build(); var groups = client.beta().organization().rbacGroups().list(params); for (var group : groups.autoPager()) { IO.println(group.id() + ": " + group.name() + " (" + group.sourceType().asString() + ")"); } } ``` ```php PHP $client = new Client(); $groups = $client->beta->organization->rbacGroups->list(limit: 20); foreach ($groups->pagingEachItem() as $group) { echo "{$group->id}: {$group->name} ({$group->sourceType})\n"; } ``` ```ruby Ruby client = Anthropic::Client.new groups = client.beta.organization.rbac_groups.list(limit: 20) groups.auto_paging_each do |group| puts "#{group.id}: #{group.name} (#{group.source_type})" end ``` ```json { "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/retrieve) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-groups retrieve \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const group = await client.beta.organization.rbacGroups.retrieve( "rbac_group_01UvWxYzAbCdEfGhIjKlMn" ); console.log(`id: ${group.id}`); console.log(`name: ${group.name}`); console.log(`source_type: ${group.source_type}`); ``` ```csharp C# AnthropicClient client = new(); var group = await client.Beta.Organization.RbacGroups.Retrieve("rbac_group_01UvWxYzAbCdEfGhIjKlMn"); Console.WriteLine($"id: {group.ID}"); Console.WriteLine($"name: {group.Name}"); Console.WriteLine($"source_type: {group.SourceType.Raw()}"); ``` ```go Go client := anthropic.NewClient() group, err := client.Beta.Organization.RBACGroups.Get(context.Background(), "rbac_group_01UvWxYzAbCdEfGhIjKlMn") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", group.ID) fmt.Printf("name: %s\n", group.Name) fmt.Printf("source_type: %s\n", group.SourceType) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var group = client.beta().organization().rbacGroups() .retrieve("rbac_group_01UvWxYzAbCdEfGhIjKlMn"); IO.println("id: " + group.id()); IO.println("name: " + group.name()); IO.println("source_type: " + group.sourceType().asString()); ``` ```php PHP $client = new Client(); $group = $client->beta->organization->rbacGroups->retrieve( rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', ); echo "id: {$group->id}\n"; echo "name: {$group->name}\n"; echo "source_type: {$group->sourceType}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" group = client.beta.organization.rbac_groups.retrieve(rbac_group_id) puts "id: #{group.id}" puts "name: #{group.name}" puts "source_type: #{group.source_type}" ``` ### Создание группы `POST /v1/organizations/rbac_groups` создаёт группу с заданным `name` (1–255 символов) без ролей и участников. Требуется область доступа `write:rbac_groups`. Полное описание параметров и схем ответов см. в разделе [Create group](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/create) справочника API. ```bash cURL curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups" \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{"name": "Engineering"}' ``` ```bash CLI ant beta:organization:rbac-groups create --name Engineering ``` ```python Python client = anthropic.Anthropic() group = client.beta.organization.rbac_groups.create(name="Engineering") print(f"id: {group.id}") print(f"name: {group.name}") ``` ```typescript TypeScript const client = new Anthropic(); const group = await client.beta.organization.rbacGroups.create({ name: "Engineering" }); console.log(`id: ${group.id}`); console.log(`name: ${group.name}`); ``` ```csharp C# AnthropicClient client = new(); var group = await client.Beta.Organization.RbacGroups.Create(new() { Name = "Engineering" }); Console.WriteLine($"id: {group.ID}"); Console.WriteLine($"name: {group.Name}"); ``` ```go Go client := anthropic.NewClient() group, err := client.Beta.Organization.RBACGroups.New(context.Background(), anthropic.BetaOrganizationRBACGroupNewParams{ Name: "Engineering", }) if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", group.ID) fmt.Printf("name: %s\n", group.Name) ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.RbacGroupCreateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = RbacGroupCreateParams.builder() .name("Engineering") .build(); var group = client.beta().organization().rbacGroups().create(params); IO.println("id: " + group.id()); IO.println("name: " + group.name()); } ``` ```php PHP $client = new Client(); $group = $client->beta->organization->rbacGroups->create( name: 'Engineering', ); echo "id: {$group->id}\n"; echo "name: {$group->name}\n"; ``` ```ruby Ruby client = Anthropic::Client.new group = client.beta.organization.rbac_groups.create(name: "Engineering") puts "id: #{group.id}" puts "name: #{group.name}" ``` ```json { "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/update) справочника API. ```bash cURL curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{"name": "Platform Engineering"}' ``` ```bash CLI ant beta:organization:rbac-groups update \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn \ --name "Platform Engineering" ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const group = await client.beta.organization.rbacGroups.update( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", { name: "Platform Engineering" } ); console.log(`id: ${group.id}`); console.log(`name: ${group.name}`); ``` ```csharp C# AnthropicClient client = new(); var group = await client.Beta.Organization.RbacGroups.Update( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", new() { Name = "Platform Engineering" } ); Console.WriteLine($"id: {group.ID}"); Console.WriteLine($"name: {group.Name}"); ``` ```go Go client := anthropic.NewClient() group, err := client.Beta.Organization.RBACGroups.Update( context.Background(), "rbac_group_01UvWxYzAbCdEfGhIjKlMn", anthropic.BetaOrganizationRBACGroupUpdateParams{ Name: anthropic.String("Platform Engineering"), }, ) if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", group.ID) fmt.Printf("name: %s\n", group.Name) ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.RbacGroupUpdateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = RbacGroupUpdateParams.builder() .name("Platform Engineering") .build(); var group = client.beta().organization().rbacGroups() .update("rbac_group_01UvWxYzAbCdEfGhIjKlMn", params); IO.println("id: " + group.id()); IO.println("name: " + group.name()); } ``` ```php PHP $client = new Client(); $group = $client->beta->organization->rbacGroups->update( rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', name: 'Platform Engineering', ); echo "id: {$group->id}\n"; echo "name: {$group->name}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" group = client.beta.organization.rbac_groups.update(rbac_group_id, name: "Platform Engineering") puts "id: #{group.id}" puts "name: #{group.name}" ``` ### Удаление группы `DELETE /v1/organizations/rbac_groups/{rbac_group_id}` удаляет группу. Её участники остаются участниками своих организаций, но теряют разрешения привязанных к ней ролей, а [лимит расходов](https://platform.claude.com/docs/ru/manage-claude/spend-limits-api) группы, если он был, перестаёт к ним применяться. Требуется область доступа `write:rbac_groups`. Полное описание параметров и схем ответов см. в разделе [Delete group](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/delete) справочника API. ```bash cURL curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-groups delete \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn ``` ```python Python client = anthropic.Anthropic() deleted_group = client.beta.organization.rbac_groups.delete( "rbac_group_01UvWxYzAbCdEfGhIjKlMn" ) print(f"id: {deleted_group.id}") ``` ```typescript TypeScript const client = new Anthropic(); const deletedGroup = await client.beta.organization.rbacGroups.delete( "rbac_group_01UvWxYzAbCdEfGhIjKlMn" ); console.log(`id: ${deletedGroup.id}`); ``` ```csharp C# AnthropicClient client = new(); var deletedGroup = await client.Beta.Organization.RbacGroups.Delete( "rbac_group_01UvWxYzAbCdEfGhIjKlMn" ); Console.WriteLine($"id: {deletedGroup.ID}"); ``` ```go Go client := anthropic.NewClient() deletedGroup, err := client.Beta.Organization.RBACGroups.Delete(context.Background(), "rbac_group_01UvWxYzAbCdEfGhIjKlMn") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", deletedGroup.ID) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var deletedGroup = client.beta().organization().rbacGroups() .delete("rbac_group_01UvWxYzAbCdEfGhIjKlMn"); IO.println("id: " + deletedGroup.id()); ``` ```php PHP $client = new Client(); $deletedGroup = $client->beta->organization->rbacGroups->delete( rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', ); echo "id: {$deletedGroup->id}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" deleted_group = client.beta.organization.rbac_groups.delete(rbac_group_id) puts "id: #{deleted_group.id}" ``` ```json { "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/members/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members?limit=100" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-groups:members list \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn \ --limit 100 ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const members = await client.beta.organization.rbacGroups.members.list( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", { limit: 100 } ); for await (const member of members) { console.log(`${member.user_id}: ${member.email}`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Beta.Organization.RbacGroups.Members.List( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", new() { Limit = 100 } ); await foreach (var member in page.Paginate()) { Console.WriteLine($"{member.UserID}: {member.Email}"); } ``` ```go Go client := anthropic.NewClient() members := client.Beta.Organization.RBACGroups.Members.ListAutoPaging( context.Background(), "rbac_group_01UvWxYzAbCdEfGhIjKlMn", anthropic.BetaOrganizationRBACGroupMemberListParams{ Limit: anthropic.Int(100), }, ) for members.Next() { member := members.Current() fmt.Printf("%s: %s\n", member.UserID, member.Email) } if err := members.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.members.MemberListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = MemberListParams.builder() .limit(100) .build(); var members = client.beta().organization().rbacGroups().members() .list("rbac_group_01UvWxYzAbCdEfGhIjKlMn", params); for (var member : members.autoPager()) { IO.println(member.userId() + ": " + member.email()); } } ``` ```php PHP $client = new Client(); $members = $client->beta->organization->rbacGroups->members->list( rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', limit: 100, ); foreach ($members->pagingEachItem() as $member) { echo "{$member->userID}: {$member->email}\n"; } ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" members = client.beta.organization.rbac_groups.members.list(rbac_group_id, limit: 100) members.auto_paging_each do |member| puts "#{member.user_id}: #{member.email}" end ``` ```json { "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` при [создании приглашения](https://platform.claude.com/docs/ru/manage-claude/user-management#create-an-invite). Требуется область доступа `write:rbac_groups`. Полное описание параметров и схем ответов см. в разделе [Add group member](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/members/add) справочника API. ```bash cURL curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"}' ``` ```bash CLI ant beta:organization:rbac-groups:members add \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn \ --user-id user_01AbCdEfGhIjKlMnOpQrSt ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const member = await client.beta.organization.rbacGroups.members.add( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", { user_id: "user_01AbCdEfGhIjKlMnOpQrSt" } ); console.log(`user_id: ${member.user_id}`); console.log(`email: ${member.email}`); ``` ```csharp C# AnthropicClient client = new(); var member = await client.Beta.Organization.RbacGroups.Members.Add( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", new() { UserID = "user_01AbCdEfGhIjKlMnOpQrSt" } ); Console.WriteLine($"user_id: {member.UserID}"); Console.WriteLine($"email: {member.Email}"); ``` ```go Go client := anthropic.NewClient() member, err := client.Beta.Organization.RBACGroups.Members.Add( context.Background(), "rbac_group_01UvWxYzAbCdEfGhIjKlMn", anthropic.BetaOrganizationRBACGroupMemberAddParams{ UserID: "user_01AbCdEfGhIjKlMnOpQrSt", }, ) if err != nil { log.Fatal(err) } fmt.Printf("user_id: %s\n", member.UserID) fmt.Printf("email: %s\n", member.Email) ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.members.MemberAddParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = MemberAddParams.builder() .userId("user_01AbCdEfGhIjKlMnOpQrSt") .build(); var member = client.beta().organization().rbacGroups().members() .add("rbac_group_01UvWxYzAbCdEfGhIjKlMn", params); IO.println("user_id: " + member.userId()); IO.println("email: " + member.email()); } ``` ```php PHP $client = new Client(); $member = $client->beta->organization->rbacGroups->members->add( rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', userID: 'user_01AbCdEfGhIjKlMnOpQrSt', ); echo "user_id: {$member->userID}\n"; echo "email: {$member->email}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" member = client.beta.organization.rbac_groups.members.add( rbac_group_id, user_id: "user_01AbCdEfGhIjKlMnOpQrSt" ) puts "user_id: #{member.user_id}" puts "email: #{member.email}" ``` ```json { "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_groups/members/remove) справочника API. ```bash cURL curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members/user_01AbCdEfGhIjKlMnOpQrSt" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-groups:members remove \ --rbac-group-id rbac_group_01UvWxYzAbCdEfGhIjKlMn \ --user-id user_01AbCdEfGhIjKlMnOpQrSt ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const removedMember = await client.beta.organization.rbacGroups.members.remove( "user_01AbCdEfGhIjKlMnOpQrSt", { rbac_group_id: "rbac_group_01UvWxYzAbCdEfGhIjKlMn" } ); console.log(`user_id: ${removedMember.user_id}`); ``` ```csharp C# AnthropicClient client = new(); var removedMember = await client.Beta.Organization.RbacGroups.Members.Remove( "user_01AbCdEfGhIjKlMnOpQrSt", new() { RbacGroupID = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" } ); Console.WriteLine($"user_id: {removedMember.UserID}"); ``` ```go Go client := anthropic.NewClient() removedMember, err := client.Beta.Organization.RBACGroups.Members.Remove( context.Background(), "user_01AbCdEfGhIjKlMnOpQrSt", anthropic.BetaOrganizationRBACGroupMemberRemoveParams{ RBACGroupID: "rbac_group_01UvWxYzAbCdEfGhIjKlMn", }, ) if err != nil { log.Fatal(err) } fmt.Printf("user_id: %s\n", removedMember.UserID) ``` ```java Java import com.anthropic.models.beta.organization.rbacgroups.members.MemberRemoveParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = MemberRemoveParams.builder() .rbacGroupId("rbac_group_01UvWxYzAbCdEfGhIjKlMn") .build(); var removedMember = client.beta().organization().rbacGroups().members() .remove("user_01AbCdEfGhIjKlMnOpQrSt", params); IO.println("user_id: " + removedMember.userId()); } ``` ```php PHP $client = new Client(); $removedMember = $client->beta->organization->rbacGroups->members->remove( userID: 'user_01AbCdEfGhIjKlMnOpQrSt', rbacGroupID: 'rbac_group_01UvWxYzAbCdEfGhIjKlMn', ); echo "user_id: {$removedMember->userID}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_group_id = "rbac_group_01UvWxYzAbCdEfGhIjKlMn" removed_member = client.beta.organization.rbac_groups.members.remove( "user_01AbCdEfGhIjKlMnOpQrSt", rbac_group_id: rbac_group_id ) puts "user_id: #{removed_member.user_id}" ``` ```json { "rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn", "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn", "user_id": "user_01AbCdEfGhIjKlMnOpQrSt", "type": "rbac_group_member_deleted" } ``` ## Пользовательские роли Через API пользовательские роли доступны только для чтения: эти эндпоинты предоставляют каталог пользовательских ролей вашей организации (определённых в [настройках организации claude.ai](https://claude.ai/admin-settings) или предоставленных Anthropic) и разрешений, которые предоставляет каждая роль. Чтение пользовательских ролей использует область доступа `read:members` (отдельной области доступа для ролей нет) и работает с ключом уровня организации: в отличие от эндпоинтов групп, они не требуют ключа, созданного для всех связанных организаций, а возвращаемый каталог принадлежит вашей собственной организации. Название роли берите из её поля `display_name`. Для роли, предоставленной Anthropic, `display_name` может отличаться от метки, которую показывает claude.ai, и Anthropic может изменить это название. Чтобы сохранить постоянную ссылку на роль, храните её `id`. ### Получение списка ролей `GET /v1/organizations/rbac_roles` возвращает пользовательские роли вашей организации. Требуется область доступа `read:members`. Полное описание параметров и схем ответов см. в разделе [List roles](https://platform.claude.com/docs/ru/api/beta/organization/rbac_roles/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_roles?limit=20" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-roles list --limit 20 ``` ```python Python client = anthropic.Anthropic() roles = client.beta.organization.rbac_roles.list(limit=20) for role in roles: print(f"{role.id}: {role.display_name}") ``` ```typescript TypeScript const client = new Anthropic(); const roles = await client.beta.organization.rbacRoles.list({ limit: 20 }); for await (const role of roles) { console.log(`${role.id}: ${role.display_name}`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Beta.Organization.RbacRoles.List(new() { Limit = 20 }); await foreach (var role in page.Paginate()) { Console.WriteLine($"{role.ID}: {role.DisplayName}"); } ``` ```go Go client := anthropic.NewClient() roles := client.Beta.Organization.RBACRoles.ListAutoPaging(context.Background(), anthropic.BetaOrganizationRBACRoleListParams{ Limit: anthropic.Int(20), }) for roles.Next() { role := roles.Current() fmt.Printf("%s: %s\n", role.ID, role.DisplayName) } if err := roles.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.beta.organization.rbacroles.RbacRoleListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = RbacRoleListParams.builder() .limit(20) .build(); var roles = client.beta().organization().rbacRoles().list(params); for (var role : roles.autoPager()) { IO.println(role.id() + ": " + role.displayName()); } } ``` ```php PHP $client = new Client(); $roles = $client->beta->organization->rbacRoles->list(limit: 20); foreach ($roles->pagingEachItem() as $role) { echo "{$role->id}: {$role->displayName}\n"; } ``` ```ruby Ruby client = Anthropic::Client.new roles = client.beta.organization.rbac_roles.list(limit: 20) roles.auto_paging_each do |role| puts "#{role.id}: #{role.display_name}" end ``` ```json { "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_roles/retrieve) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-roles retrieve \ --rbac-role-id rbac_role_01CdEfGhIjKlMnOpQrStUv ``` ```python Python 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}") ``` ```typescript TypeScript const client = new Anthropic(); const role = await client.beta.organization.rbacRoles.retrieve( "rbac_role_01CdEfGhIjKlMnOpQrStUv" ); console.log(`id: ${role.id}`); console.log(`display_name: ${role.display_name}`); ``` ```csharp C# AnthropicClient client = new(); var role = await client.Beta.Organization.RbacRoles.Retrieve("rbac_role_01CdEfGhIjKlMnOpQrStUv"); Console.WriteLine($"id: {role.ID}"); Console.WriteLine($"display_name: {role.DisplayName}"); ``` ```go Go client := anthropic.NewClient() role, err := client.Beta.Organization.RBACRoles.Get(context.Background(), "rbac_role_01CdEfGhIjKlMnOpQrStUv") if err != nil { log.Fatal(err) } fmt.Printf("id: %s\n", role.ID) fmt.Printf("display_name: %s\n", role.DisplayName) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var role = client.beta().organization().rbacRoles() .retrieve("rbac_role_01CdEfGhIjKlMnOpQrStUv"); IO.println("id: " + role.id()); IO.println("display_name: " + role.displayName()); ``` ```php PHP $client = new Client(); $role = $client->beta->organization->rbacRoles->retrieve( rbacRoleID: 'rbac_role_01CdEfGhIjKlMnOpQrStUv', ); echo "id: {$role->id}\n"; echo "display_name: {$role->displayName}\n"; ``` ```ruby Ruby client = Anthropic::Client.new rbac_role_id = "rbac_role_01CdEfGhIjKlMnOpQrStUv" role = client.beta.organization.rbac_roles.retrieve(rbac_role_id) puts "id: #{role.id}" puts "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](https://platform.claude.com/docs/ru/api/beta/organization/rbac_roles/permissions/list) справочника API. ```bash cURL curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv/permissions?limit=20" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant beta:organization:rbac-roles:permissions list \ --rbac-role-id rbac_role_01CdEfGhIjKlMnOpQrStUv \ --limit 20 ``` ```python Python client = anthropic.Anthropic() permissions = client.beta.organization.rbac_roles.permissions.list( "rbac_role_01CdEfGhIjKlMnOpQrStUv", limit=20 ) for permission in permissions: print(permission.action) ``` ```typescript TypeScript const client = new Anthropic(); const permissions = await client.beta.organization.rbacRoles.permissions.list( "rbac_role_01CdEfGhIjKlMnOpQrStUv", { limit: 20 } ); for await (const permission of permissions) { console.log(permission.action); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Beta.Organization.RbacRoles.Permissions.List( "rbac_role_01CdEfGhIjKlMnOpQrStUv", new() { Limit = 20 } ); await foreach (var permission in page.Paginate()) { Console.WriteLine(permission.Action); } ``` ```go Go client := anthropic.NewClient() permissions := client.Beta.Organization.RBACRoles.Permissions.ListAutoPaging( context.Background(), "rbac_role_01CdEfGhIjKlMnOpQrStUv", anthropic.BetaOrganizationRBACRolePermissionListParams{ Limit: anthropic.Int(20), }, ) for permissions.Next() { permission := permissions.Current() fmt.Println(permission.Action) } if err := permissions.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.beta.organization.rbacroles.permissions.PermissionListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = PermissionListParams.builder() .limit(20) .build(); var permissions = client.beta().organization().rbacRoles().permissions() .list("rbac_role_01CdEfGhIjKlMnOpQrStUv", params); for (var permission : permissions.autoPager()) { IO.println(permission.action()); } } ``` ```php PHP $client = new Client(); $permissions = $client->beta->organization->rbacRoles->permissions->list( rbacRoleID: 'rbac_role_01CdEfGhIjKlMnOpQrStUv', limit: 20, ); foreach ($permissions->pagingEachItem() as $permission) { echo "{$permission->action}\n"; } ``` ```ruby Ruby client = Anthropic::Client.new rbac_role_id = "rbac_role_01CdEfGhIjKlMnOpQrStUv" permissions = client.beta.organization.rbac_roles.permissions.list(rbac_role_id, limit: 20) permissions.auto_paging_each do |permission| puts permission.action end ``` ```json { "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 } ``` ## Примеры рабочих процессов ### Отключение уходящего сотрудника 1. Найдите участника по электронной почте: ```bash cURL curl "https://api.anthropic.com/v1/organizations/users?email=departing@example.com" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` ```bash CLI ant organization:users list --email departing@example.com ``` ```python Python client = anthropic.Anthropic() users = client.organization.users.list(email="departing@example.com") for user in users: print(f"{user.id}: {user.email} ({user.role})") ``` ```typescript TypeScript const client = new Anthropic(); const users = await client.organization.users.list({ email: "departing@example.com" }); for await (const user of users) { console.log(`${user.id}: ${user.email} (${user.role})`); } ``` ```csharp C# AnthropicClient client = new(); var page = await client.Organization.Users.List(new() { Email = "departing@example.com" }); await foreach (var user in page.Paginate()) { Console.WriteLine($"{user.ID}: {user.Email} ({user.Role.Raw()})"); } ``` ```go Go client := anthropic.NewClient() users := client.Organization.Users.ListAutoPaging(context.Background(), anthropic.OrganizationUserListParams{ Email: anthropic.String("departing@example.com"), }) for users.Next() { user := users.Current() fmt.Printf("%s: %s (%s)\n", user.ID, user.Email, user.Role) } if err := users.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.organization.users.UserListParams; void main() { AnthropicClient client = AnthropicOkHttpClient.fromEnv(); var params = UserListParams.builder() .email("departing@example.com") .build(); var users = client.organization().users().list(params); for (var user : users.autoPager()) { IO.println(user.id() + ": " + user.email() + " (" + user.role().asString() + ")"); } } ``` ```php PHP $client = new Client(); $users = $client->organization->users->list(email: 'departing@example.com'); foreach ($users->pagingEachItem() as $user) { echo "{$user->id}: {$user->email} ({$user->role})\n"; } ``` ```ruby Ruby client = Anthropic::Client.new users = client.organization.users.list(email: "departing@example.com") users.auto_paging_each do |user| puts "#{user.id}: #{user.email} (#{user.role})" end ``` 2. Удалите его с помощью `DELETE /v1/organizations/users/{user_id}`, используя `id` из ответа. Его место, если оно было, возвращается в пул. 3. Если человек ещё не присоединился, поиск не вернёт участника; в этом случае получите список приглашений и отзовите его приглашение в статусе `pending`. ### Аудит состава групп 1. Получите список групп и запишите `id`, `name` и `role_ids` каждой группы. 2. Для каждой группы с конфиденциальными ролями пройдите по страницам `GET /v1/organizations/rbac_groups/{rbac_group_id}/members` и сравните адреса электронной почты участников со списком в вашем поставщике удостоверений. 3. Удалите участников, которые больше не должны состоять в группе, с помощью `DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}`. Для групп `scim` вместо этого внесите изменение в вашем поставщике удостоверений. Рабочий процесс, сочетающий состав группы с временным повышением лимита расходов, см. в разделе [Временное повышение лимита расходов участника во время инцидента](https://platform.claude.com/docs/ru/manage-claude/spend-limits-api#temporarily-raise-a-members-spend-limit-during-an-incident) на странице Spend Limits API. ## Часто задаваемые вопросы ### Это отдельный API, отличный от Admin API? Нет. Эндпоинты участников и приглашений — это те же эндпоинты `/v1/organizations/`, которые используют организации Claude Console; на этой странице описано их поведение в Claude Enterprise. Эндпоинты групп и пользовательских ролей являются частью того же API и существуют только для организаций Claude Enterprise. В [таблице доступности](https://platform.claude.com/docs/ru/manage-claude/user-management#which-endpoints-can-your-organization-use) показано, какие эндпоинты может вызывать каждый тип организации. ### Можно ли назначить роль владельца или администратора участников через API? Нет. API назначает только `user` и `managed` — при создании приглашения и обновлении роли. Административные роли назначаются в настройках организации claude.ai, а участников с этими ролями нельзя изменить или удалить через API. ### Можно ли создавать или изменять группы через API? Да, с областью доступа `write:rbac_groups`: создавать, переименовывать и удалять группы, а также добавлять и удалять их участников. Две вещи API изменить не может: группы, предоставленные вашим поставщиком удостоверений (`source_type: "scim"`), названием и составом которых владеет поставщик удостоверений, и пользовательские роли, которые управляются в настройках организации claude.ai (API [их читает](https://platform.claude.com/docs/ru/manage-claude/user-management#custom-roles)). ### Занимает ли непринятое приглашение место? В тарифных планах с ограниченным пулом мест — да: приглашение в статусе `pending` удерживает место. Отзыв приглашения или истечение его срока освобождает место. В тарифных планах без пула мест приглашения ничего не занимают. ### Моя организация использует единый вход. Какие операции работают? Если ваш поставщик удостоверений автоматически предоставляет пользователей (JIT или SCIM), создание приглашений возвращает 400. Если он управляет ролями (расширенный SSO или расширенное предоставление через SCIM), обновления ролей возвращают 400. Если он управляет членством (предоставление через SCIM), удаление участников возвращает 400. Операции чтения работают в любом случае. ### Что происходит с ключом Admin API, когда создавший его человек уходит? Ключ продолжает работать. Ключи Admin API привязаны к организации, а не к отдельным пользователям, и ключ, созданный в claude.ai, не имеет срока действия. Удаление создателя из организации или отзыв его учётной записи через поставщика удостоверений прекращает его собственный доступ, но не созданные им ключи. Понижение его роли также не влияет на ключи: каждый ключ остаётся активным с исходными областями доступа. При отключении человека, создававшего ключи Admin API, удалите эти ключи в разделе **Keys** в [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) и создайте замену. ## См. также Где основной владелец создаёт ключ с областями доступа и какие области выбрать. Аудит активности, а также получение или удаление пользовательского контента во всей организации. Отчёты об использовании и затратах по пользователям и временным интервалам для Claude Enterprise. Установка лимитов расходов для участников и рассмотрение запросов на их повышение.