Update a project
PATCH/api/projects/:id
Update a project. PT-1083: turning requiresStoryPointsForCycles on, or changing storyPointScale while it is on, first runs a readiness check against the project's tasks in planned and active cycles. When a task there would not satisfy the policy — for enabling, any estimate that is empty, 0 or off the resulting scale; for a scale change, an estimate on a value the change removes — the request is refused with 409 CYCLE_ESTIMATE_POLICY_NOT_READY and nothing is changed. Its details carry reason (ENABLE | SCALE_NARROWING), offendingCount, sampleTaskIds (at most 20), truncated and the resulting storyPointScale.
Request
Responses
- 200
- 401
- 403
- 409
Successful response
Unauthorized — authentication credentials are missing or invalid
Forbidden — requires projects.update permission
A conflict. PT-1083: CYCLE_ESTIMATE_POLICY_NOT_READY when the cycle estimate policy is not ready — enabling requiresStoryPointsForCycles, or narrowing storyPointScale while it is on, would leave tasks in planned or active cycles without an admissible estimate. Nothing was changed.