метод REST scope: task

task.stages.add

Добавить стадию канбана или «Моего плана»

Кто может выполнять: любой пользователь для стадий «Моего плана»

Описание

Метод task.stages.add добавляет стадию канбана или «Моего плана».

Параметры

fields object обязательный

Значения полей (подробное описание приведено ниже) для добавления новой стадии

isAdmin boolean необязательный

Если установлено true, то проверки прав происходить не будет. При условии, что запрашивающий является администратором портала

Параметр fields

TITLE string обязательный

Заголовок стадии

COLOR string необязательный

Цвет стадии в формате RGB

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

Идентификатор стадии, после которой надо добавить новую стадию.

Если не указано или равно 0, то добавится в начало

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

Идентификатор объекта.

Может равняться ID группы, тогда стадия добавится в канбан группы.

Если равняется 0 или отсутствует, то стадия добавляется в «Мой план» текущего пользователя.

При недостаточном уровне прав выводится ошибка доступа

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

curl -X POST \
-H "Content-Type: application/json" \
-d '{
"fields": {
    "TITLE": "Название стадии",
    "COLOR": "#FFAAEE",
    "AFTER_ID": 1,
    "ENTITY_ID": 1
},
"isAdmin": false
}' \
https://your-domain.bitrix24.com/rest/_USER_ID_/_CODE_/task.stages.add

Ответ

HTTP-статус: 200

{
    "result": 1
}

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

result integer

Идентификатор добавленной стадии

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

HTTP-статус: 400

{
    "error": "EMPTY_TITLE",
    "error_description": "Не указан заголовок стадии"
}
Код Описание Значение
EMPTY_TITLE Не указан заголовок стадии
ACCESS_DENIED Вы не можете управлять стадиями

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

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