Skip to main content
POST
Resolve a procedure's review hold
Resolves an operator-review hold on a Procedure Builder draft that failed finalize, as Console’s hold card does:
  • approve promotes the held draft past the finalize gate to provisional, an audited override. The provisional-to-approved gate still stands.
  • send_back returns it to an editable draft for the Builder to keep steering.
A version with no hold is 409 invalid_state. This is a procedure lifecycle hold, not a Trust Fabric approval request: the approval policy limits that apply to approval requests do not apply here.

Who may resolve

You need approvals:approve at the version’s home; a missing version and one out of reach are the same 404 resource_missing. It is an approve permission: a Personal key carries it only when its owner opts in, an External App only by an explicit grant, and a Forge agent never. The decision is audited with you as the actor and the procedure as its resource.

Idempotency

With an Idempotency-Key, a same-key repeat within 24 hours returns the recorded result only while you still hold approvals:approve at the version’s home; otherwise 409 idempotency_result_unavailable.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

procedureId
string
required

The procedure family's id (its slug).

Minimum string length: 1

Body

application/json
version
string
required

The semver version.

Minimum string length: 1
action
enum<string>
required

approve promotes the held draft to provisional; send_back returns it to an editable draft.

Available options:
approve,
send_back

Response

Success

data
object
required
meta
object
required