# PUT /v1/sites/{id}

Atualizar um site

Altera a categoria do seu site para `mainstream`, `adult` ou `network`. Prefira `PATCH /v1/sites/{id}`. Retorna 200 quando a atualização é concluída. Algumas mudanças de categoria de sites já aprovados precisam de análise. A resposta 202 informa a categoria solicitada em `pending_category`, e o site mantém sua `category` atual até o fim da análise. Envie a categoria atual para cancelar a solicitação pendente. 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`.

- 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 |

## Corpo da chamada

```
{ category: "mainstream" | "adult" | "network" }
```

## Resposta

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

## 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 |

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