# POST /v1/sites

Создать сайт

Регистрирует новый сайт (201). С разрешением `manage` повторное добавление домена удалённого сайта восстанавливает сайт с прежними ID и статусом и применяет указанную категорию (200). При конфликте (409) в `reason` возвращается `domain_exists`, если домен уже у вашего неудалённого сайта, `domain_taken`, если домен зарезервирован другим паблишером, или `domain_archived`, если у вас нет разрешения восстановить свой удалённый сайт. Требуется область `publisher:write` (ключ API или веб-сессия); недоступно в режиме просмотра от имени. Уровень лимита: `write`.

- Требуемая область: `publisher:write`
- Лимит запросов: `write` — 20 запросов за окно в 60 с на ключ API или веб-сессию

## Параметры

Нет параметров.

## Тело запроса

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

## Ответ

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

## Ошибки

Маршруты с ограничением частоты возвращают `RateLimit-Limit`, `RateLimit-Remaining` и `RateLimit-Reset` (секунд до конца окна); ответ 429 также содержит `Retry-After`. Заголовки могут отсутствовать, пока ограничитель временно недоступен (запросы тогда пропускаются).

| Статус | Смысл |
|---|---|
| 401 | Ключ API отсутствует, недействителен или отозван. |
| 403 | У ключа нет требуемой области, либо операция недоступна для этого субъекта. |
| 429 | Лимит запросов превышен; подождите `Retry-After` секунд. |
| 400 | Default Response |
| 409 | Default Response |

HTML-документация: https://agimone.com/ru/developers/api/#create-site
API 2026-10
