метод REST scope: task

tasks.api.scrum.task.update

Создать или обновить задачу Скрама

Кто может выполнять: любой пользователь, имеющий доступ к Скраму

Описание

Метод создает или обновляет задачу Скрама. Вы сможете:
- создать задачу в Скраме
- перенести задачу из другого проекта
- перенести ее между бэклогом и спринтами
- изменить стори поинты
- привязать эпик

Задачу нужно создать методом tasks.task.add или обновить методом tasks.task.update. Привязка задачи к скраму указывается в параметре идентификатора группы GROUP_ID.

Получить идентификатор группы можно методом создания новой группы или методом получения списка групп. Группа является скрамом, если у нее заполнено поле SCRUM_MASTER_ID.

Параметры

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

Идентификатор задачи

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

Объект содержащий записи о задаче скрама (подробное описание приведено ниже) в виде структуры:

fields: {
    entityId: 'значение'
    storyPoints: 'значение',
    epicId: 'значение',
    sort: 'значение'
}

Параметр fields

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

Идентификатор бэклога или спринта.

Если значение не указано, *Битрикс24* автоматически добавит задачу в бэклог Скрама, если он существует

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

Стори Поинты — относительная оценка сложности задачи.

Может иметь строковое значение

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

Идентификатор эпика

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

Сортировка

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1,"fields":{"epicId":1,"storyPoints":"8","entityId":2}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.api.scrum.task.update

Ответ

HTTP-статус: 200

{
    "status" : "success",
    "data" : true,
    "errors" : []
}

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

status string

Статус ответа.

Возможные значения:
- success
- error

data boolean

Возвращает:
- true — в случае успеха
- null — в случае ошибки

errors array

Массив ошибок

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

HTTP-статус: 400

{
    "error": 0,
    "error_description": "Task not found"
}
Код Описание Значение
0 Epic not found Эпик не найден
0 Task not found Задача не найдена
0 Access denied Доступ запрещен
0 Item not created Задача не добавлена в скрам

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

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