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
- 400
- 401
- 403
- 404
- 409
Successful response
Validation error, a descriptive body carrying no fields, or an organisation cycle left without a start or end date
Unauthorized — authentication credentials are missing or invalid
Forbidden — outside the envelope or lacking the required permission. Byte-identical.
Cycle not found, archived, or not an organisation cycle
Conflict: an invalid lifecycle transition, another organisation cycle already active, a duplicate sequence, or a new window overlapping another planned or active organisation cycle