СправкаСодержание
api:roles
Роли
Роль похожа на обычного пользователя. Вы можете ставить на неё задачи и включать её в маршрутизацию. Каждый участник роли увидит задачу у себя во Входящих, а когда хотя бы один из них утвердит или отклонит задачу, она перейдёт на следующий этап.
Подробнее о ролях можно прочитать в справке.
- GET/rolesПолучение всех ролей организации
- POST/rolesСоздание роли
- PUT/roles/{role-id} Изменение роли
Метод возвращает список всех ролей в организации.
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
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
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
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 | Заблокировать/разблокировать роль. |