Для AI-агентов: markdown этой страницы — /docs-content/task-stages.md индекс документации — /llms.txt

Стадии канбана задач

Операции со стадиями канбана задач: чтение колонок доски, создание, изменение и удаление стадии в рабочей группе или в «Моём плане» владельца ключа.

Битрикс24 API: task.stages.* Скоуп: task

Создать стадию задач

POST /v1/tasks/stages/:entityId

Добавляет стадию в канбан рабочей группы или в «Мой план» владельца ключа. По умолчанию стадия встаёт последней.

Параметры

Параметр	Тип	Обяз.	Описание
`entityId` (path)	number	да	ID рабочей группы или `0` — «Мой план» владельца ключа. Список групп: `GET /v1/workgroups`

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`title`	string	да	Название стадии. Пустая строка и строка из пробелов отклоняются
`color`	string	нет	Цвет в формате `RRGGBB` или `#RRGGBB`. Сохраняется без `#`
`afterStageId`	number	нет	ID стадии того же канбана, после которой встанет новая. Список: `GET /v1/tasks/stages/:entityId`. Не передаётся вместе с `position`
`position`	string	нет	Единственное значение — `first`: стадия встаёт первой и становится стадией по умолчанию. Не передаётся вместе с `afterStageId`

Другие поля в теле, включая sort, отклоняются с 400 INVALID_PARAMS.

Примеры

curl — личный ключ

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/stages/155" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "На согласовании", "color": "#FF0000"}'

curl — OAuth-приложение

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/stages/155" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "На согласовании", "color": "#FF0000"}'

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/stages/155', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'На согласовании', color: '#FF0000' }),
})

const { success, data } = await res.json()

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/stages/155', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'На согласовании', color: '#FF0000' }),
})

const { success, data } = await res.json()

Поля ответа

Ответ приходит с HTTP-статусом 201 Created. Стадия в ответе прочитана заново после создания.

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data`	object	Созданная стадия
`data.id`	number	ID стадии
`data.title`	string	Название
`data.sort`	number	Позиция на доске: чем меньше, тем левее
`data.color`	string	Цвет в формате `RRGGBB`
`data.systemType`	string \| null	`NEW` у стадии по умолчанию, `null` у остальных
`data.entityId`	number	Владелец канбана: ID группы или ID пользователя для «Моего плана»
`data.entityType`	string	`G` — канбан группы, `U` — «Мой план»

Пример ответа

JSON

{
  "success": true,
  "data": {
    "id": 629,
    "title": "На согласовании",
    "sort": 400,
    "color": "FF0000",
    "systemType": null,
    "entityId": 155,
    "entityType": "G"
  }
}

Пример ответа при ошибке

400 — переданы оба поля afterStageId и position: