Запрос: POST /group
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют добавлять группы.
Заголовки и параметры запроса
Authorization (обязательный) | Токен доступа. Вы можете получить токен с помощью запроса |
Параметр | Описание |
---|---|
name (обязательный) | Название группы |
userIds (необязательный) | ID пользователей, которые будут входить в состав группы |
Заголовок | Описание |
Параметры ответа
Параметр | Описание |
---|---|
response | ID добавленной группы |
Коды ответов
201 | Created | Новая группа добавлена. Тело ответа будет содержать ID добавленной группы |
400 | Bad Request | Ошибка в запросе |
401 | Unauthorized | Ошибка авторизации |
403 | Permission denied | У пользователя недостаточно прав для выполнения запроса |
Код | Текст | Описание |
---|
Пример запроса
POST /group https/1.1 Host: api-learn.ispringlearn.ru Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE Content-Type:application/xml <?xml version="1.0" encoding="UTF-8"?> <request> <name>Стажеры</name> <userIds> <id>3fa85f64-5717-4562-b3fc-2c963f66afa6</id> <id>9265e422-deb9-11e9-b4d0-864db459a4d7</id> </userIds> </request>
Пример ответа
https/1.1 201 Created <?xml version="1.0" encoding="UTF-8"?> <response>b1496214-acab-11e9-8db0-120a62f268a9</response>