# POST /v1/sites

Créer un site

Enregistre un nouveau site (201). Avec la permission `manage`, ajouter de nouveau le domaine d’un site supprimé restaure le même site, conserve son identifiant et son statut et applique la catégorie demandée (200). En cas de conflit (409), `reason` vaut `domain_exists` si le domaine appartient à l’un de vos sites non supprimés, `domain_taken` si un autre éditeur réserve le domaine, ou `domain_archived` si vous n’avez pas la permission de restaurer votre site supprimé. Nécessite la portée `publisher:write` (clé API ou session web) ; indisponible en view-as. Niveau de limite de débit : `write`.

- Portée requise: `publisher:write`
- Limite débit: `write` — 20 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

Aucun paramètre.

## Corps de requête

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

## Réponse

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

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |
| 400 | Default Response |
| 409 | Default Response |

Documentation HTML: https://agimone.com/fr/developers/api/#create-site
API 2026-10
