goalsmanagement.task.add

Scope: goalsmanagement

Кто может вызывать: Авторизованный с правом постановки задачи. Подробнее: Права доступа

Создать задачу модуля сотруднику отдела

HTTP: POST

Побочные эффекты: создаёт задачу Битрикс24

Параметры метода

Параметр Тип Обяз. Описание
departmentId int да ID отдела
userId int нет ID пользователя

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

Ответ в конверте модуля: result.resultdepartmentId, userId, created, taskId; result.error. Если у сотрудника нет карточки целей, метод возвращает CARD_NOT_FOUND и задачу не создаёт.

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

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
ACCESS_DENIED Нет права постановки задачи
VALIDATION_ERROR Некорректные параметры или создание задачи отключено в настройках модуля
CARD_NOT_FOUND У сотрудника нет карточки целей
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/goalsmanagement.task.add.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          --data '{
          "departmentId": 12,
          "userId": 15
        }'
        

Пример ответа

{
          "result": {
            "result": {
              "departmentId": 12,
              "userId": 15,
              "created": true,
              "taskId": 120
            },
            "error": null
          }
        }
        

См. также