Approve or deny a pending approval.
An approval action.
POST/api/v1/approvals/{id}/decide
Scopeapprove
Deciding one that is no longer pending answers 409 conflict. A plan approval (a managed crew launched with limits.review.planApproval) takes three answers: approve: true starts its tasks; approve: false, changes: true with a note sends the note to the manager, which plans again (within the crew's planRevisions); approve: false alone cancels the crew with the note as the reason. changes on any other approval answers 400. When an API key calls it, the timeline records who did what and the outcome. No query parameters.
Path parameters.
idstringrequired
The approval's id.
Headers.
Idempotency-Keystring
Makes a retry safe: the same key with the same request returns the first answer and does nothing else.
Body.
approvebooleanrequired
true approves, false denies.
notestring
Why, in your words. Kept with the decision and shown on the timeline. Default empty.
changesboolean
Plan approvals only, with approve: false: ask the manager for a new plan instead of canceling the crew. note is required and goes to the manager. Refused on any other approval.
Response.
200 OK: a Approval. The example has placeholder values.
- 422 validation_failed
- The body does not match its schema; each problem is in
details.