Update a cycle

PATCH 
/api/projects/:id/cycles/:cycleId

Update a cycle. Send descriptive fields to edit it, OR a { state: "active" | "completed" } body to transition its lifecycle (activate enforces one-active-per-project and writes the activation snapshot; complete freezes the close snapshot). state and descriptive fields are mutually exclusive, and an empty descriptive body (no fields) is rejected with 400.

Request

Responses

200

Successful response

400

Validation error or empty update

401

Unauthorized — authentication credentials are missing or invalid

403

Forbidden — the x-act-as-org selector named an organisation the caller is not an ACTIVE member of (or the caller lacks the required permission).

404

Cycle not found or archived

409

Conflict: another cycle is already active in this project (state=active), or the requested lifecycle transition is invalid for the current cycle state (activating a non-planned cycle, or completing a non-active cycle).