Update a task
PATCH/api/projects/:id/tasks/:taskId
Update a task. When a status change starts the task but its automatic cycle attachment is skipped because the project requires a story-point estimate for cycle work, data carries cycleAutoAttach: { outcome: 'estimate-required', storyPointScale }.
Request
Responses
- 200
- 401
- 403
- 409
Successful response
Unauthorized — authentication credentials are missing or invalid
Forbidden — requires tasks.update.any permission
PT-968 CYCLE_CAPACITY_EXCEEDED — the write would take the target cycle past its targetPoints. details carries the overage, the committed and projected figures, and an ordered list of the cheapest cut candidates (shortest prefix covering the overage, capped at ten). Visibility is ALL-OR-NOTHING: a caller who cannot read every project the cycle spans — or who lacks full tasks.read — receives the restricted arm instead, which names the requested cycle and nothing else: no committed or projected totals, no overage, and an empty candidate list. Resubmit the identical request with cycleCapacityOverrideReason to admit the breach — it is then recorded on the cycle membership event with the overage.