# Scrum kanban stages

The columns of a sprint board: creating, reading and updating. Stages belong to a **sprint**, not to a workgroup — different sprints in the same project have independent sets of columns.

**Scope:** `task` | **Base URL:** `https://vibecode.bitrix24.com/v1` | **Auth:** `X-Api-Key`

## How to obtain a `sprintId`

Every stage operation needs a sprint ID. Obtain it from the [sprint list](/docs/scrum/sprints/list) or request the project's [active sprint](/docs/scrum/sprints/active).

## Operations

- [List stages](./stages/list.md) — `GET /v1/scrum/sprints/:sprintId/stages`
- [Create a stage](./stages/create.md) — `POST /v1/scrum/sprints/:sprintId/stages`
- [Update a stage](./stages/update.md) — `PATCH /v1/scrum/stages/:stageId`

The item path is flat, with no sprint segment: Bitrix24 identifies a stage by `stageId` alone.

## Stage fields

| Field | Type | Description |
|------|-----|---------|
| `id` | number | Stage ID |
| `name` | string | Column name. Up to 255 characters |
| `type` | string | `NEW`, `WORK` or `FINISH`. Defaults to `WORK` |
| `sort` | number | Column order. Defaults to `100` |
| `color` | string | Six hexadecimal characters **without** `#`, e.g. `"00C4FB"` |
| `sprintId` | number | ID of the sprint the column belongs to |

## Known specifics

- **Deleting a stage is not exposed.** Bitrix24 allows removing even the system `NEW` column of an active sprint, after which the board stops working and there is no undo. Remove a column in the Bitrix24 interface instead.
- **Moving between sprints is not exposed.** A `sprintId` in the request body is rejected. Create the column in the sprint you want.
- **Adding a column to a completed sprint is allowed** — that is Bitrix24 behaviour and the platform does not block it.
- **A colour with a leading `#` is accepted, and the `#` is stripped.** Sent straight through, `"#00C4FB"` would be truncated by Bitrix24 to six characters, that is, to a different colour.

## See also

- [Sprints](/docs/scrum/sprints)
- [Scrum epics](/docs/scrum/epics)
- [Task placement](/docs/scrum/tasks)
- [Scrum](/docs/scrum)