Untuk ejen AI: markdown halaman ini — /docs-content-en/tasks/stages.md indeks dokumentasi — /llms.txt

Artikel dokumentasi kini tersedia dalam bahasa Inggeris.

Create a task stage

POST /v1/tasks/stages/:entityId

Bitrix24 REST: task.stages.add. Scope: task.

0 selects the key owner My Plan; a positive entityId selects a group. Body: title (non-empty), color? (#RRGGBB or RRGGBB), afterStageId? or position:"first". No position appends after the last stage. afterStageId must belong to the same entity; combine it with position and the wrapper returns 400. isAdmin is never forwarded. Color is stored without #. Returns 201 with the freshly read stage.

position:"first" makes this the group default: new tasks and tasks without a stage appear here. The first write to a group without stages initializes its default kanban. Group owner/moderator rights are required; a portal admin without group membership may be refused. Your own My Plan is editable.

Example

Terminal 
curl -X POST "https://vibecode.bitrix24.com/v1/tasks/stages/9" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Approval","color":"#FF0000"}'

Writes require a READWRITE key. No automatic retry after timeout: reread the object before retrying. Bitrix24 permission refusals return 403; other business refusals return 422.

Stage list