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

Crear un mensaje de disputa

Envía hasta 5,000 caracteres Unicode a una disputa sin resolver que pertenece al editor. Una respuesta del editor reabre una disputa ya respondida. Requiere `publisher:write`; el modo «ver como» es de solo lectura. Nivel de límite de uso: `write`.

- Scope requerido: `publisher:write`
- Límite de uso: `write` — 20 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

| Nombre | En | Tipo | Requerido |
|---|---|---|---|
| `id` | path | integer | sí |

## Cuerpo petición

```
{ message: string }
```

## Respuesta

```
{ 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" }
```

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

Documentación HTML: https://agimone.com/es/developers/api/#create-dispute-message
API 2026-10
