Developers · Raw Markdown

Deals

A Deal is the immutable snapshot of accepted terms. It is not the same event as verified closure.

Resources

GET https://api.breezewish.com/v1/deals/{id} scope deals:read
POST https://api.breezewish.com/v1/deals/{id}/approve scope deals:approve, autonomy COMMIT. Humans also complete step-up.
POST https://api.breezewish.com/v1/deals/{id}/checkout scope deals:approve, autonomy COMMIT
MCP get_deal, accept_offer

Losing Offers are rejected because another Deal was accepted.

Schema

https://api.breezewish.com/schemas/v1/deal.json

Common errors

Code	Meaning
UNAUTHENTICATED	Missing or invalid credential.
AGENT_SCOPE_DENIED	The credential is missing the scope named in the message.
DELEGATION_LIMIT	Autonomy is below the operation. COMMIT is required to accept, approve, or check out. TRANSACT is required to confirm closure.
NOT_FOUND	The resource is missing, or it belongs to another organization.
IDEMPOTENCY_CONFLICT	The same Idempotency-Key was reused with a different body.
RATE_LIMITED	The caller exceeded the public or authenticated limit.