# Domaines

Les domaines d’un projet se gèrent comme chez Vercel. Ajouter et retirer demandent la portée `host:domains` ; lire, `host:read`. Un domaine ajouté attend son enregistrement TXT de preuve et son CNAME (ou A et AAAA pour un domaine racine) : voir [Brancher un domaine](/host/docs/guides/brancher-un-domaine/).

## GET `/v9/projects/:p/domains`

Liste les domaines du projet. Chaque domaine porte `verified` et, tant qu’il n’est pas vérifié, `verification` : l’enregistrement TXT à publier.

## POST `/v10/projects/:p/domains`

Ajoute un domaine. Corps : `name`, et en option `redirect` (autre domaine du projet), `redirectStatusCode`, `gitBranch`. Un domaine de la plateforme (`hgdc.cloud`, `hgdc.ch`) ou déjà vérifié par une autre organisation répond `400`.

La CLI passe par `POST /projects/:p/alias` (`vercel domains add <domaine> <projet>`), qui fait la même chose.

## GET `/v9/projects/:p/domains/:domain`

Lit un domaine du projet.

## POST `/v9/projects/:p/domains/:domain/verify`

Relance la vérification DNS. Limitée par organisation.

## DELETE `/v9/projects/:p/domains/:domain`

Retire le domaine. Un domaine vers lequel un autre redirige répond `400` : retire d’abord la redirection.

## Domaines de l’organisation

`GET /v5/domains` (`vercel domains ls`), `GET /v5/domains/:domain` (`vercel domains inspect`), `GET /v6/domains/:domain/config`, `GET /v1/domains/:domain/project-domains` et `DELETE /v3/domains/:domain` (`vercel domains rm`) lisent et retirent les domaines de tous les projets de l’organisation. Ajouter un domaine sans projet n’existe pas : précise le projet.