метод REST scope: task

tasks.api.scrum.kanban.updateStage

Обновить стадию канбана Скрама

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

Описание

Метод изменяет стадию канбана Скрама.

Параметры

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

Идентификатор стадии. Получить идентификатор можно при помощи метода tasks.api.scrum.kanban.getStages

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

Поля, соответствующие доступному списку полей tasks.api.scrum.kanban.getFields (подробное описание приведено ниже)

Параметр fields

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

Идентификатор спринта. Получить идентификатор можно при помощи метода tasks.api.scrum.sprint.list

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

Название стадии канбана

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

Тип стадии канбана. Возможные значения: NEW, WORK, FINISH

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

Порядок сортировки. Значение поля должно быть кратно 100

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

Цвет стадии канбана

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"stageId":65,"fields":{"name":"Обновленная стадия","type":"WORK","color":"00C4FB","sort":100}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.api.scrum.kanban.updateStage

Ответ

HTTP-статус: 200

{
    "result": true,
    "time":{
        "start":1712137817.343984,
        "finish":1712137817.605804,
        "duration":0.26182007789611816,
        "processing":0.018325090408325195,
        "date_start":"2024-04-03T12:50:17+03:00",
        "date_finish":"2024-04-03T12:50:17+03:00"
    }
}

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"Incorrect sprintId value"
}
Код Описание Значение
0 Stage id not found Не заполнено обязательное поле stageId
0 Stage not found Передан неизвестный идентификатор стадии stageId
0 Incorrect sprintId value Передан неизвестный идентификатор спринта или нет доступа к спринту
0 Access denied Доступ запрещен
0 Неизвестная ошибка

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

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