Platform

Decide a mobile/agent approval for a connection user

Platform apps decide agent approval requests on behalf of the connected user. Accepts decision: approved or rejected (aliases approve / reject). plt_ auth only.

post/v1/platform/connections/{connectionId}/approvals/{approvalId}/decide

Request

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

Path parameters

connectionIdstring uuid required
approvalIdstring uuid required

Request body

decision'approved' | 'rejected' | 'approve' | 'reject' required
reasonstring

Response

Decided approval

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.