# PUT /v1/zones/{id}

Atualizar uma zona

Atualiza campos de uma zona do publisher. Exige o escopo `publisher:write` (chave de API ou sessão web); não disponível em view-as. Nível de limite de taxa: `write`. Renomear e alterar a frequência não exigem confirmação. Com uma chave de API, pausar uma zona ativa ou desativar o Smart Link dela exige o cabeçalho `X-Adnet-Confirm: true` (caso contrário, 428). Alterar `direct_url_enabled` exige a permissão Direct Link (403 `direct_link_not_allowed`). Depois que o site for aprovado, a categoria de uma zona de um site do tipo `network` pode mudar de `mainstream` para `adult`. A mudança de `adult` para `mainstream` exige a permissão `manage` (409 `manage_not_allowed` sem essa permissão).

- Escopo exigido: `publisher:write`
- Limite de taxa: `write` — 20 requisições por janela de 60 s por chave de API ou sessão web

## Parâmetros

| Nome | Em | Tipo | Obrigatório |
|---|---|---|---|
| `id` | path | integer | sim |
| `x-adnet-confirm` | header | string | não |

## Corpo da chamada

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

## Resposta

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

## Erros

As rotas com limite de taxa retornam `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset` (segundos até o fim da janela); um 429 também traz `Retry-After`. Os headers podem estar ausentes enquanto o limitador estiver temporariamente indisponível (as requisições passam nesse caso).

| Status | Significado |
|---|---|
| 401 | Chave de API ausente, inválida ou revogada. |
| 403 | A chave não tem o escopo exigido, ou a operação não é permitida para este ator. |
| 429 | Limite de taxa excedido; aguarde `Retry-After` segundos. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |
| 428 | Default Response |

Documentação HTML: https://agimone.com/pt/developers/api/#update-zone
API 2026-10
