# POST /v1/sites

Buat situs

Daftarkan situs baru (201). Dengan izin `manage`, menambahkan kembali domain situs Anda yang telah dihapus akan memulihkan situs dengan ID dan status semula serta menerapkan kategori yang diminta (200). Jika terjadi konflik (409), `reason` berisi `domain_exists` bila domain sudah terdaftar pada situs Anda yang belum dihapus, `domain_taken` bila domain dicadangkan untuk publisher lain, atau `domain_archived` bila Anda tidak memiliki izin untuk memulihkan situs yang telah Anda hapus. Memerlukan scope `publisher:write` (kunci API atau sesi web); tidak tersedia di view-as. 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

```
{ category: "mainstream" | "adult" | "network"; domain: string }
```

## Respons

```
{ category: "mainstream" | "adult" | "network"; created_at: string; deleted_at: string | null; domain: string; id: integer; notes: string | null; pending_category: "mainstream" | "adult" | "network" | null; pending_category_at: string | null; publisher_note: string | null; status: "pending" | "approved" | "rejected"; zones_count: integer }
```

## 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 |
| 409 | Default Response |

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