# POST /v1/disputes/{id}/messages

Criar mensagem de disputa

Envia até 5.000 caracteres Unicode a uma disputa não resolvida do publisher. Uma resposta do publisher reabre uma disputa respondida. Exige `publisher:write`; view-as é somente leitura. Nível de limite de taxa: `write`.

- Escopo exigido: `publisher:write`
- Limite de taxa: `write` — 20 requisições por janela de 60 s por chave de API ou sessão web

## Parâmetros

| Nome | Em | Tipo | Obrigatório |
|---|---|---|---|
| `id` | path | integer | sim |

## Corpo da chamada

```
{ message: string }
```

## Resposta

```
{ amount_returned: string | null; first_response_at: string | null; first_response_due_at: string; id: integer; messages: { author_type: "publisher" | "admin"; body: string; created_at: string; id: integer }[]; opened_at: string; overdue: boolean; resolution: "upheld" | "rejected" | "partial" | null; resolve_due_at: string; resolved_at: string | null; status: "open" | "answered" | "resolved"; subject_id: integer | null; subject_type: "hold" | "adjustment" | "ivt" | "zone_quality" | "payout" | "other" }
```

## Erros

As rotas com limite de taxa retornam `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset` (segundos até o fim da janela); um 429 também traz `Retry-After`. Os headers podem estar ausentes enquanto o limitador estiver temporariamente indisponível (as requisições passam nesse caso).

| Status | Significado |
|---|---|
| 401 | Chave de API ausente, inválida ou revogada. |
| 403 | A chave não tem o escopo exigido, ou a operação não é permitida para este ator. |
| 429 | Limite de taxa excedido; aguarde `Retry-After` segundos. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

Documentação HTML: https://agimone.com/pt/developers/api/#create-dispute-message
API 2026-10
