# PUT /v1/zones/{id}

Actualizar una zona

Actualiza campos de una zona del editor. Requiere el scope `publisher:write` (clave de API o sesión web); no disponible en el modo «ver como». Nivel de límite de uso: `write`. Cambiar el nombre o la frecuencia no necesita confirmación. Con una clave de API, pausar una zona activa o desactivar su Smart Link requiere el encabezado `X-Adnet-Confirm: true` (si no, 428). Cambiar `direct_url_enabled` requiere el permiso Direct Link (403 `direct_link_not_allowed`). Una vez aprobado el sitio, la categoría de una zona de un sitio de tipo `network` puede cambiar de `mainstream` a `adult`. El cambio de `adult` a `mainstream` requiere el permiso `manage` (409 `manage_not_allowed` si falta el permiso).

- Scope requerido: `publisher:write`
- Límite de uso: `write` — 20 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

| Nombre | En | Tipo | Requerido |
|---|---|---|---|
| `id` | path | integer | sí |
| `x-adnet-confirm` | header | string | no |

## Cuerpo petición

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

## Respuesta

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

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |
| 428 | Default Response |

Documentación HTML: https://agimone.com/es/developers/api/#update-zone
API 2026-10
