# POST /v1/sites

Criar um site

Registra um site novo (201). Com a permissão `manage`, adicionar novamente o domínio de um site excluído restaura o mesmo site, mantém seu ID e status e aplica a categoria solicitada (200). Em caso de conflito (409), `reason` é `domain_exists` se o domínio já estiver em um site seu não excluído, `domain_taken` se estiver reservado por outro publisher ou `domain_archived` se você não tiver permissão para restaurar seu site excluído. 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

Sem parâmetros.

## Corpo da chamada

```
{ category: "mainstream" | "adult" | "network"; domain: string }
```

## 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 |
| 409 | Default Response |

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