# PUT /v1/zones/{id}

Update a zone

Update fields of a zone owned by the publisher. Requires scope `publisher:write` (API key or web session); not available in view-as. Renaming and changing frequency need no confirmation. With an API key, pausing an active zone or turning its Smart Link off requires the header `X-Adnet-Confirm: true` (otherwise 428). Changing `direct_url_enabled` needs the Direct Link permission (403 `direct_link_not_allowed`). After the site is approved, changing the category of a network-site zone from mainstream to adult is always allowed; from adult to mainstream requires the manage permission (409 `manage_not_allowed`). Rate limit tier: `write`.

- Required scope: `publisher:write`
- Rate limit: `write` — 20 requests per 60-second window per API key or web session

## Parameters

| Name | In | Type | Required |
|---|---|---|---|
| `id` | path | integer | yes |
| `x-adnet-confirm` | header | string | no |

## Request body

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

## Response

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

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |
| 428 | Default Response |

HTML documentation: https://agimone.com/en/developers/api/#update-zone
API 2026-10
