Approvals

Approve or reject

Submit a decision (approve or reject) for a pending approval. Human-only. The approval must be in pending status. For card_order approvals, approving auto-executes the x402 payment; rejecting marks the card as rejected. Risk tier 2+ approvals require step-up authentication via X-Auth-Confirm (account password or rat_ re-auth token from POST /v1/auth/reauth/begin + complete). Risk tier 3 requires passkey or TOTP re-auth token.

post/v1/approvals/{approval_id}/decide

Request

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

Path parameters

approval_idstring uuid required

Request body

decision'approve' | 'reject' required
reasonstring

Optional human-readable reason for the decision

Response

Decision recorded

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 1 revision of this API.