v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Escrow

Open a dispute

Opens a dispute on the escrow, locking the funds and starting the structured resolution process (free mediation, escalating to paid arbitration if rejected). Optionally include a mediation proposal (resolution plus client/provider split).

post/escrow/{id}/dispute

Path parameters

idstring required

Escrow id.

Request body

actorstring

Acting party @handle. Must be the client or provider.

clientAmountstring

Optional proposed amount to the client (base units), for a partial_release proposal.

providerAmountstring

Optional proposed amount to the provider (base units), for a partial_release proposal.

rationalestring

Optional rationale for the proposed resolution.

reasonstring required

Why the dispute is being opened.

resolution'full_release' | 'full_refund' | 'partial_release'

Optional proposed resolution.

Response

object required