Docs
Sign in

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.