> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Définir un domaine personnalisé

> Reliez votre site web à un domaine personnalisé. Limité à 10 changements toutes les 5 minutes et 50 toutes les 24 heures.

**Il est nécessaire de disposer au minimum du [plan Standard](https://squarecloud.app/fr/pricing) pour utiliser cette route.**

Un même compte peut rattacher un domaine à plusieurs applications (load balancing) : jusqu'à 2 applications sur Standard, 5 sur Pro et 10 sur Enterprise. Voir [Lister les load balancers](/fr/api-reference/endpoint/apps/network/load-balancers).

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

### Paramètres

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID de l'application. Vous pouvez le trouver dans l'URL du tableau de bord de votre application.
</ParamField>

<ParamField body="custom" type="string" placeholder="example.com" required>
  Le domaine pleinement qualifié à rattacher, ou `@` pour supprimer le domaine personnalisé actuel de l'application. Il ne peut pas s'agir d'un domaine Square Cloud (`squareweb.app`, `squarecloud.app`, ...).
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

En cas d'échec, la réponse inclut un `code` d'erreur :

| Statut | Code                          | Signification                                                                               |
| ------ | ----------------------------- | ------------------------------------------------------------------------------------------- |
| `400`  | `REGEX_VALIDATION`            | Le domaine n'est pas un nom de domaine pleinement qualifié valide.                          |
| `400`  | `RESERVED_DOMAIN`             | Les domaines Square Cloud ne peuvent pas être utilisés comme domaine personnalisé.          |
| `403`  | `UPGRADE_REQUIRED`            | Le plan actif n'inclut pas les domaines personnalisés (Standard, Pro ou Enterprise requis). |
| `403`  | `LOAD_BALANCER_LIMIT_REACHED` | La limite d'applications du plan sur ce domaine a été atteinte.                             |
| `409`  | `DOMAIN_ALREADY_EXISTS`       | Le domaine est déjà rattaché à une application appartenant à un autre compte.               |
| `502`  | `DNS_FAILED`                  | Le rattachement du domaine a échoué au niveau du fournisseur edge.                          |

<ResponseExample>
  ```json theme={null}
  {
      "status": "success"
  }
  ```
</ResponseExample>