---
title: "Open a dispute"
method: POST
path: "/escrow/{id}/dispute"
tags: ["Escrow"]
---

# Open a dispute

`POST /escrow/{id}/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).

## Path parameters

- `id` string, required

## Request body

- object
  - `actor` string — Acting party @handle. Must be the client or provider.
  - `clientAmount` string — Optional proposed amount to the client (base units), for a partial_release proposal.
  - `providerAmount` string — Optional proposed amount to the provider (base units), for a partial_release proposal.
  - `rationale` string — Optional rationale for the proposed resolution.
  - `reason` string, required — Why the dispute is being opened.
  - `resolution` 'full_release' | 'full_refund' | 'partial_release' — Optional proposed resolution.

## Response `200`

OK

- object

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/versions/fb85a82845ac/schema)