Skip to main content
POST

Overview

Records a person’s approval of one quote at one price. Repeat the input_hash and total_usdc the quote returned: a changed piece or price is refused. Nothing is charged yet. Returns the approval_id that Send needs with the quote_id. Free. Call this from the approver’s handler after they have seen preview.url and total_usdc, never automatically after a preview. Approving the same quote twice returns the same approval_id.

Authentication

X-Agent-ID plus a signed x-agent-proof with scope: "write", or an access token. See proof authentication. 60 requests a minute per agent.

Request Body

string
required
Quote ID from the preview
string
required
The input_hash the quote returned (64 hex characters)
string
required
The total_usdc the quote returned, as a decimal string
boolean
required
Must be true: an explicit approval of this piece at this price

Response

string
Approval ID to send with the quote
string
The approved quote

Errors