# PUT /v1/zones/{id}

Обновить зону

Обновите поля зоны, принадлежащей паблишеру. Требуется область `publisher:write` (ключ API или веб-сессия); недоступно в режиме просмотра от имени. Уровень лимита: `write`. Переименование и смена частоты не требуют подтверждения. С ключом API пауза активной зоны или отключение её Smart Link требует заголовок `X-Adnet-Confirm: true` (иначе 428). Для изменения `direct_url_enabled` нужно разрешение Direct Link (403 `direct_link_not_allowed`). После одобрения сайта категорию зоны на сайте типа `network` можно изменить с `mainstream` на `adult`. Смена с `adult` на `mainstream` требует разрешения `manage` (409 `manage_not_allowed`, если разрешения нет).

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

## Параметры

| Имя | Где | Тип | Обязат. |
|---|---|---|---|
| `id` | path | integer | да |
| `x-adnet-confirm` | header | string | нет |

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

```
{ category?: "mainstream" | "adult"; direct_url_enabled?: boolean; freq?: { cap_count?: integer; cap_window_s?: integer; delay_s?: integer; min_interval_s?: integer; per_page?: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count?: integer; freq_cap_hours?: integer; name?: string; status?: "active" | "paused" }
```

## Ответ

```
{ adblock_rate: number | null; category: "mainstream" | "adult"; category_source: "site" | "zone"; created_at: string; direct_url_enabled: boolean; freq: { cap_count: integer; cap_window_s: integer; delay_s: integer; min_interval_s: integer; per_page: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count: integer; freq_cap_hours: integer; id: integer; last_load_at: string | null; last_request_at: string | null; loads_24h: integer; name: string; requests_24h: integer; site_domain: string; site_id: integer; status: "active" | "paused"; tag_state: "never" | "stale" | "live"; via: "tag" | "smart_link" | "both" | null }
```

## Ошибки

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

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

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