> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить состав сервера

> Возвращает страницу состава выбранного сервера.

Возвращает страницу состава выбранного сервера. Требуется право чтения состава и доступ бота к серверу. Для следующей страницы передайте полученный next\_cursor в параметре cursor.

## Доступ

`roster:read`.

**Authorization** `string` *required*

Партнёрский Bearer-токен. Подробнее в разделе [«Авторизация»](https://docs.arzguard.com/cerberus-crm/authentication.md).

## Параметры

**server\_id** `union` *required*

Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.

**cursor** `string`

Курсор из next\_cursor предыдущей страницы. В первом запросе не передавайте.

**limit** `integer`

Максимальное число записей в одной странице. По умолчанию `50`. Диапазон от `1` до `100`.

## Успешный ответ

HTTP `200`. Запрос выполнен успешно.

**members** `object[]` *required*

Сотрудники текущей страницы состава.

**Поля**

**display\_name** `string` *required*

Отображаемое имя сотрудника.

**id** `string` *required*

Идентификатор записи.

**position\_name** `string | null` *required*

Название должности сотрудника.

**status** `string` *required*

Текущее состояние записи.

**user\_id** `string | null` *required*

Идентификатор зарегистрированного пользователя CRM. Null, если аккаунт ещё не зарегистрирован.

**next\_cursor** `string`

Курсор следующей страницы. Пустое значение или отсутствие поля означает, что следующей страницы нет.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректный лимит, курсор или параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `429` | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
| `503` | Сервис временно недоступен. Повторите запрос позднее. |

См. [формат ошибок и правила повторов](https://docs.arzguard.com/cerberus-crm/requests-and-errors.md).

## Пример

В примере использованы условные идентификаторы.

```bash cURL theme={null}
curl --request GET \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  'https://test.crm.arzguard.com/api/partner/v1/servers/102/roster?limit=25'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "members": [
    {
      "id": "01910000-0000-7000-8000-000000000001",
      "user_id": "01910000-0000-7000-8000-000000000002",
      "display_name": "Пример",
      "position_name": "Куратор модерации",
      "status": "active"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.