метод REST scope: task

tasks.task.getaccess

Проверить доступ к задаче

Кто может выполнять: любой пользователь

Описание

Метод tasks.task.getaccess проверяет доступные действия пользователей над задачей.

Параметры

taskId integer обязательный

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

Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач

users array необязательный

Массив идентификаторов пользователей, для которых нужно проверить доступ.

По умолчанию используется текущий пользователь.

Идентификатор пользователя можно получить методом получения списка пользователей

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"taskId":8017,"users":[503,547]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.getaccess

Ответ

HTTP-статус: 200

{
    "result": {
        "allowedActions": {
            "503": {
                "ACCEPT": false,
                "DECLINE": false,
                "COMPLETE": true,
                "APPROVE": false,
                "DISAPPROVE": false,
                "START": false,
                "PAUSE": true,
                "DELEGATE": true,
                "REMOVE": true,
                "EDIT": true,
                "DEFER": false,
                "RENEW": false,
                "CREATE": true,
                "CHANGE_DEADLINE": true,
                "CHECKLIST_ADD_ITEMS": true,
                "ADD_FAVORITE": false,
                "DELETE_FAVORITE": true,
                "RATE": true,
                "TAKE": false,
                "EDIT.ORIGINATOR": false,
                "CHECKLIST.REORDER": true,
                "ELAPSEDTIME.ADD": true,
                "DAYPLAN.TIMER.TOGGLE": true,
                "EDIT.PLAN": true,
                "CHECKLIST.ADD": true,
                "FAVORITE.ADD": false,
                "FAVORITE.DELETE": true
            },
            "547": {
                "ACCEPT": false,
                "DECLINE": false,
                "COMPLETE": false,
                "APPROVE": false,
                "DISAPPROVE": false,
                // ...
                "FAVORITE.DELETE": false
            }
        }
    },
    "time": {
        "start": 1758177122.815386,
        "finish": 1758177122.911002,
        "duration": 0.09561586380004883,
        "processing": 0.054609060287475586,
        "date_start": "2025-09-18T09:32:02+03:00",
        "date_finish": "2025-09-18T09:32:02+03:00",
        "operating_reset_at": 1758177722,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой элемент ответа.

Содержит объект c описанием доступных действий для каждого пользователя

allowedActions object

Объект, в котором ключ — ID пользователя, значение — объект с описанием доступных действий над задачей.

Если у пользователя, выполняющего метод, нет доступа к задаче, вернется пустой массив "allowedActions":[].

Для несушествующих пользователей из параметра users метод вернет ответ со значением false для всех действий

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"100",
    "error_description":"Invalid value {} to match with parameter {users}. Should be value of type array."
}
Код Описание Значение
0 wrong task id В параметре taskId указано значение неверного типа
100 Invalid value {} to match with parameter {users}. Should be value of type array. Указано неверное значение в параметре users
100 CTaskItem All parameters in the constructor must have real class type Не указан обязательный параметр taskId

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.