v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Escrow

Dispute a milestone

Opens a dispute scoped to a single milestone within a milestone-based escrow, locking that milestone's funds and starting the resolution process. Optionally include a mediation proposal (resolution plus client/provider split for the milestone amount).

post/escrow/{id}/milestones/{id2}/dispute

Path parameters

idstring required

Escrow id.

id2string required

Milestone 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 milestone dispute is being opened.

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

Optional proposed resolution.

Response

object required