Sign in
Approval Queue

Resolve an approval request

Approve or deny a pending approval request. If approved, the gateway resumes the full task pipeline (stages 2-8: credit debit, compute, IPFS, fingerprint, receipt). If denied, the task is marked FAILED and no credits are consumed. Supports both JWT (dashboard) and API key (SDK/scripts) authentication. Fires a dual-signed webhook (HMAC + EIP-712) to any configured webhook URL or one-shot callback.

patch/api/v1/approvals/{id}

Path parameters

idstring required

Approval request ID

Request body

decision'approved' | 'denied' required

Approval decision. "approved" resumes the pipeline. "denied" marks the task as FAILED.

notestring

Optional note explaining the decision (stored in audit trail)

Example request

{
  "decision": "approved",
  "note": "Verified invoice with finance team"
}

Response

Approval resolved successfully

successboolean
decision'approved' | 'denied'
taskIdstring

The task that was held

resumeErrorstring nullable

Error message if pipeline resume failed (approval still recorded)

Example response

{
  "success": true,
  "decision": "approved",
  "taskId": "task_abc123"
}

Changes