# POST /v1/disputes

Créer un litige

Crée un litige avec un message de 5 000 caractères Unicode maximum. Au plus cinq litiges non résolus par éditeur et un litige de qualité par zone en 24 heures. Les objets du litige doivent appartenir à l'éditeur. Nécessite `publisher:write` ; view-as est en lecture seule. Niveau de limite de débit : `write`.

- Portée requise: `publisher:write`
- Limite débit: `write` — 20 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

Aucun paramètre.

## Corps de requête

```
{ message: string; subject_id?: integer | null; subject_type: "hold" | "adjustment" | "ivt" | "zone_quality" | "payout" | "other" }
```

## Réponse

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

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

Documentation HTML: https://agimone.com/fr/developers/api/#create-dispute
API 2026-10
