# POST /v1/disputes

Buat sengketa

Buat sengketa dengan pesan hingga 5.000 karakter Unicode. Maksimal lima sengketa yang belum selesai per publisher dan satu sengketa kualitas zona per zona dalam 24 jam. Subjek harus milik publisher. Memerlukan `publisher:write`; view-as bersifat hanya baca. Tingkat batas laju: `write`.

- Scope wajib: `publisher:write`
- Batas laju: `write` — 20 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

Tanpa parameter.

## Isi permintaan

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

## Respons

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

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

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