Approvals

Cancel a pending approval (requester)

Withdraws a pending approval. Callable by the agent that requested it or the human it was addressed to. First answer wins: if the approval was already decided or expired, the existing record is returned unchanged (200) rather than an error — the caller's next question is what the answer was. A cancellation is delivered to webhook subscribers as approval.decided with decision: "cancelled", and audited as approval.cancelled.

post/v1/approvals/{approval_id}/cancel

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/approvals/{approval_id}/cancel
  • Auth: HTTP bearer

Path parameters

approval_idstring uuid required

Request body

reasonstring

Response

The approval — cancelled, or the decision that landed first

idstring uuid required
org_idstring uuid required
user_idstring uuid required
agent_idstring uuid nullable
actionstring required
target_typestring required
target_idstring required
risk_tierinteger required

The tier actually enforced. Authoritative.

declared_risk_tierinteger nullable

What the caller asked for, when it asked for anything.

declared_below_floorboolean

The caller asked for a lower tier than policy required.

human_summarystring nullable

Plain-language line sent to SMS, push and email.

payloadobject

What the action will do, as submitted.

status'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled' required
summaryobject required

Structured summary of the action requiring approval

reasonstring nullable
decision_reasonstring nullable
decided_bystring uuid nullable
decided_atstring date-time nullable
expires_atstring date-time nullable
created_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.