Platform

Create a pending consensus approval for a connection agent

Platform apps submit over-cap or consensus-gated actions on behalf of a connected user's agent. When policy_id is omitted, the server resolves the matching agent consensus_trigger policy from action_payload (chain, to, value). Returns 202 with pending_approval_id and payload_hash for decide/execute. Requires plt_ auth; agent must be provisioned on the connection.

post/v1/platform/connections/{connectionId}/pending-approvals

Request

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

Path parameters

connectionIdstring uuid required

Request body

agent_idstring uuid

Required when the connection has multiple agents

policy_idstring uuid

Optional — auto-resolved from agent consensus policies when omitted

actionstring
action_payloadobject required

Transaction/intent fields (chain, to, value, …) hashed for decide binding

summarystring

Human-readable label included in webhook payloads

Response

Pending approval created

pending_approval_idstring uuid
required_approvalsinteger
current_approvalsinteger
expires_atstring date-time
statusstring
messagestring

Changes

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