Platform

Get a connection-scoped approval

get/v1/platform/connections/{connectionId}/approvals/{approvalId}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/platform/connections/{connectionId}/approvals/{approvalId}
  • Auth: HTTP bearer

Path parameters

connectionIdstring uuid required
approvalIdstring uuid required

Response

Approval detail

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.