Подробнее о ролях можно прочитать в справке.
Метод возвращает список всех ролей в организации.
GET https://api.pyrus.com/v4/roles
{ "roles": [ { "id": 32568, "name": "Accountant", "banned": false, "member_ids": [ 1233, 1731, 2384 ] }, { "id": 13355, "name": "Managers", "banned": false, "member_ids": [ 2384, 1346, 4444, 3460 ] } ] }
curl -X GET \ 'https://api.pyrus.com/v4/roles' \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
Метод создает роль в организации пользователя.
POST https://api.pyrus.com/v4/roles
{ "name": "TechSupport", "member_add": [ 1732, 4487 ] }
{ "id": 9364, "name": "TechSupport", "banned": "false" "member_ids": [ 1732, 4487 ] }
curl -X POST \ https://api.pyrus.com/v4/roles \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json' \ -d '{ "name": "TechSupport", "member_ids": [ 1732, 4487 ] }'
name | Имя роли. |
member_add | Участники роли. Массив идентификаторов пользователей. |
Метод изменяет роль.
PUT https://api.pyrus.com/v4/roles/9364
{ "name": "InternalTechSupport", "member_add": [ 3796 ], "member_remove": [ 1732 ], "banned": false }
{ "id": 9364, "name": "InternalTechSupport", "banned": "false" "member_ids": [ 3796, 4487 ] }
curl -X PUT \ https://api.pyrus.com/v4/roles/9364 \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json' \ -d '{ "name": "InternalTechSupport", "member_add": [ 3796 ], "member_remove": [ 1732 ], "banned": false }'
name | Имя роли. |
member_add | Новые участники роли. Массив идентификаторов пользователей. |
member_remove | Удаленные из роли участники. Массив идентификаторов пользователей. |
banned | Заблокировать/разблокировать роль. |