Edit an organisation cycle, or send `{ 'state': 'active' | 'completed' }` to transition it (PT-1104)

PATCH 
/api/organisation-cycles/:cycleId

Edit an organisation cycle, or send { "state": "active" | "completed" } to transition it (PT-1104). Requires tasks.update.any AND full-scope projects.read in the active organisation. Moving its dates re-checks the no-overlap rule against the organisation track.

Request

Responses

200

Successful response

400

Validation error, a descriptive body carrying no fields, or an organisation cycle left without a start or end date

401

Unauthorized — authentication credentials are missing or invalid

403

Forbidden — outside the envelope or lacking the required permission. Byte-identical.

404

Cycle not found, archived, or not an organisation cycle

409

Conflict: an invalid lifecycle transition, another organisation cycle already active, a duplicate sequence, or a new window overlapping another planned or active organisation cycle