# Этапы Scrum-канбана

Колонки доски спринта: создание, чтение и изменение. Этапы принадлежат **спринту**, а не рабочей группе — у разных спринтов одного проекта наборы колонок независимы.

**Скоуп:** `task` | **Базовый URL:** `https://vibecode.bitrix24.tech/v1` | **Авторизация:** `X-Api-Key`

## Как получить `sprintId`

Всем операциям с этапами нужен идентификатор спринта. Возьмите его в [списке спринтов](/docs/scrum/sprints/list) или запросите [активный спринт проекта](/docs/scrum/sprints/active).

## Операции

- [Список этапов](./stages/list.md) — `GET /v1/scrum/sprints/:sprintId/stages`
- [Создать этап](./stages/create.md) — `POST /v1/scrum/sprints/:sprintId/stages`
- [Обновить этап](./stages/update.md) — `PATCH /v1/scrum/stages/:stageId`

Адрес элемента плоский, без спринта в пути: Битрикс24 опознаёт этап по одному `stageId`.

## Поля этапа

| Поле | Тип | Описание |
|------|-----|---------|
| `id` | number | ID этапа |
| `name` | string | Название колонки. До 255 символов |
| `type` | string | `NEW`, `WORK` или `FINISH`. По умолчанию `WORK` |
| `sort` | number | Порядок колонки. По умолчанию `100` |
| `color` | string | Шесть шестнадцатеричных символов **без** `#`, например `"00C4FB"` |
| `sprintId` | number | ID спринта, которому принадлежит колонка |

## Известные особенности

- **Удаление этапа не выставлено.** Битрикс24 позволяет снести в том числе системную колонку `NEW` активного спринта, после чего доска перестаёт работать, а отката нет. Убрать колонку можно в интерфейсе Битрикс24.
- **Перенос между спринтами не выставлен.** Поле `sprintId` в теле запроса отклоняется. Создайте колонку в нужном спринте.
- **Добавление колонки в завершённый спринт разрешено** — это поведение Битрикс24, платформа его не блокирует.
- **Цвет с `#` принимается и срезается.** Отправленный напрямую `"#00C4FB"` Битрикс24 обрезал бы до шести символов, то есть до другого цвета.

## Смотрите также

- [Спринты](/docs/scrum/sprints)
- [Эпики скрама](/docs/scrum/epics)
- [Размещение задач](/docs/scrum/tasks)
- [Scrum](/docs/scrum)