---
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/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 с «scope» (областью доступа) `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` отправляют заголовки `x-api-key` и `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.
### Участники и приглашения
Человек становится участником, приняв приглашение (или через единый вход вашей организации, если он настроен). Создание приглашения отправляет письмо с приглашением; затем приглашение имеет статус `pending`, пока получатель не примет его (`accepted`) или не пройдёт назначенное сервером время `expires_at` (`expired`). Отозвать можно только приглашение в статусе `pending`. Чтобы изменить адрес электронной почты или роль в ожидающем приглашении, отзовите его и создайте новое.
Если план вашей организации выделяет участников из ограниченного пула приобретённых мест, ожидающее приглашение занимает место. Конечная точка создания приглашения не принимает параметр места или уровня: место назначается автоматически из самого низкого уровня, где есть свободные места. Создание приглашения при отсутствии свободных мест завершается ошибкой 400, а не покупкой места. Отзыв приглашения, истечение его срока или последующее удаление участника возвращает место в пул.
### Группы и роли
Группы связывают участников с пользовательскими ролями. Этот механизм называется «role-based access control» (управление доступом на основе ролей), или RBAC, — отсюда `rbac` в путях конечных точек и названиях областей доступа. Группы принадлежат не отдельной организации, а всему вашему предприятию, то есть родительской организации вместе со всеми входящими в неё организациями. Поэтому для областей доступа групп (`read:rbac_groups` и `write:rbac_groups`) нужен ключ, созданный для всех связанных организаций. У каждой группы есть поле `source_type`: `direct`, если группа создана в claude.ai, и `scim`, если группа предоставлена вашим «identity provider» (поставщиком удостоверений). Поле `role_ids` содержит идентификаторы пользовательских ролей, прикреплённых к группе. Названия и разрешения этих ролей можно получить через [конечные точки пользовательских ролей](https://platform.claude.com/docs/ru/manage-claude/user-management#custom-roles). Учтите, что каталог ролей у каждой организации свой, а группы действуют на уровне всего предприятия. Поэтому запрос роли, которая принадлежит другой организации вашего предприятия, вернёт для вашего ключа ошибку 404. Если данные о ролях временно недоступны, поле имеет значение `null`, а не `[]`. Чтобы отличить такой неполный ответ от группы без ролей, повторите запрос. API по-прежнему возвращает два устаревших поля: `roles` у групп (всегда совпадает с `role_ids`) и `group_id` у участников групп (всегда совпадает с `rbac_group_id`).
## Версионирование
Отправляйте заголовок `anthropic-version` в каждом запросе; доступные версии см. в разделе [Версии API](https://platform.claude.com/docs/ru/api/versioning).
## Ограничения скорости
Конечные точки Admin API используют общее «rate limit» (ограничение скорости) на организацию — **100 запросов в минуту**; для создания приглашений вместо этого действует собственное ограничение — **1200 запросов в час**. Запросы сверх лимита возвращают **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`. Устаревшее поле `name` по-прежнему возвращается и всегда равно `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.
Установка лимитов расходов для участников и рассмотрение запросов на их повышение.