> ## 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.

# Снятие: доступные группы

> Возвращает группы, которыми текущий пользователь вправе управлять через Promote API.

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

## Доступ

Требуется scope `user:promote`, право пользователя `general/promoteAllow` и хотя бы одна группа, которой он может управлять. Эти собственные проверки выполняются и при запросе обхода стандартных прав XenForo.

**XF-Api-Key** `string` *required*

Обязательный ключ API XenForo. Тип ключа и пользовательский контекст описаны в разделе [«Авторизация»](/guard-forum/authentication).

## Параметры

**user\_id** `integer` *required*

Положительный ID форумного пользователя. В этом GET используется только для сопоставления маршрута: целевой профиль не загружается.

## Результат

**groups** `object`

Сопоставление ID групп и их названий. Ключи JSON-объекта — строки с числовыми ID.

## Поведение

Доступные группы определяются настройкой `groups_that_can_promote`: она должна содержать основную или одну из дополнительных групп инициатора. Метод чтения не меняет группы целевого пользователя. Список не ограничивается группами, уже назначенными ID из пути; у обоих GET-маршрутов одинаковая логика.

Все ID и данные в примерах условные. `FORUM_API_KEY` — заранее настроенная переменная окружения; действующий ключ в документации не приводится.

```bash cURL theme={null}
curl --request GET \
  --header "XF-Api-Key: $FORUM_API_KEY" \
  --header 'Accept: application/json' \
  'https://forum.arzguard.com/api/demote/123/'
```

```json Условный сокращённый ответ theme={null}
{
  "groups": {
    "8": "Условная группа"
  }
}
```

Форматы тела запроса и общая обработка ошибок описаны в разделе [«Запросы и ошибки»](/guard-forum/requests-and-errors).


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