# Task kanban stages

Operations on task kanban stages: read the board columns, and create, update or delete a stage in a workgroup or in the key owner's My Plan.

Bitrix24 API: `task.stages.*`
Scope: `task`

## Operations

- [Create a task stage](./tasks/stages.md) — `POST /v1/tasks/stages/:entityId`
- [List task kanban stages](./task-stages/list.md) — `GET /v1/tasks/stages/:entityId`
- [Update a task stage](./task-stages/update.md) — `PATCH /v1/task-stages/:stageId`
- [Delete an empty task stage](./task-stages/delete.md) — `DELETE /v1/task-stages/:stageId`

## Stage owner

Reading and creating stages address the board through `entityId` in the path; updating and deleting address the stage itself through `stageId`.

| `entityId` | Board | `entityType` field in the list response |
|------------|-------|-----------------------------------------|
| Workgroup ID | the group kanban, shared by all its members | `G` |
| `0` | the key owner's My Plan | `U` |

Group IDs — [`GET /v1/workgroups`](/docs/entities/workgroups/list), stage IDs — [list of stages](/docs/task-stages/list).

## Typical scenario

1. Read the board columns — [`GET /v1/tasks/stages/:entityId`](/docs/task-stages/list).
2. Add a column — [`POST /v1/tasks/stages/:entityId`](/docs/tasks/stages).
3. Rename or recolor it — [`PATCH /v1/task-stages/:stageId`](/docs/task-stages/update).
4. Remove an empty column — [`DELETE /v1/task-stages/:stageId`](/docs/task-stages/delete).

## See also

- [Tasks: kanban, My Plan and day plan](/docs/tasks)
- [Move a task with ordering](/docs/tasks/move-stage)
- [Read the kanban sorting permission](/docs/tasks/stages-can-move)
- [Task change history](/docs/task-history)