метод REST scope: task

tasks.api.scrum.kanban.addStage

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

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

Описание

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

Канбан Скрама обязательно должен содержать в себе стадии с типом новая NEW и финальная FINISH.

Используйте метод только для активных спринтов, то есть с полем "status": "active".

Параметры

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 '{"fields":{"sprintId":1,"name":"Первая стадия","type":"NEW","color":"00C4FB","sort":100}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.api.scrum.kanban.addStage

Ответ

HTTP-статус: 200

{
    "result": 5,
    "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":"Sprint not found"
}
Код Описание Значение
0 Sprint id not found Не заполнено обязательное поле sprintId
0 Sprint not found Передан неизвестный идентификатор спринта
0 Access denied Доступ запрещен
0 Incorrect name format Не заполнено обязательное поле name
0 Неизвестная ошибка

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

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