Edit a multi-project cycle, or send `{ 'state': 'active' | 'completed' }` to transition it (PT-938)

PATCH 
/api/cycle-sets/:id/cycles/:cycleId

Edit a multi-project cycle, or send { "state": "active" | "completed" } to transition it (PT-938). Requires tasks.update.any AND full-scope projects.read against the set's organisation — the same read bar the GETs apply, because a caller who cannot read the member projects must not be able to rename, activate or complete a cycle spanning them. The scope itself is immutable — project_set_id is rejected by a DB trigger and is not a member of the request schema.

Request

Responses

200

Successful response

400

Validation error, or a descriptive body carrying no fields

401

Unauthorized — authentication credentials are missing or invalid

403

Forbidden — the project set is inaccessible or unknown, its id is malformed, the caller lacks the required permission, or the x-act-as-org selector named a non-member org.

404

Cycle not found, archived, or not in this project set

409

Conflict: an invalid lifecycle transition, another cycle already active in the same project set, or a descriptive update setting a sequence that already exists in it.