метод REST scope: task

task.stages.update

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

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

Описание

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

Метод также применяется для перемещения стадии с одной позиции на другую. Для этого достаточно передать нужный AFTER_ID.

Параметры

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

Идентификатор стадии

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

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

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

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

Параметр fields

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

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

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

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

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

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

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

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

curl -X POST \
-H "Content-Type: application/json" \
-d '{
"id": 5,
"fields": {
    "TITLE": "Новая стадия",
    "SORT": 200,
    "COLOR": "FF5733"
}
}' \
https://your-domain.bitrix24.com/rest/_USER_ID_/_CODE_/task.stages.update

Ответ

{
    "result": true
}

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

result boolean

Возвращает true в случае успешного обновления стадии

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

HTTP-статус: 400

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

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

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