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

# Imposta dominio personalizzato

> Integra il tuo sito web con un dominio personalizzato. Ha un limite di frequenza di 10 modifiche ogni 5 minuti e 50 ogni 24 ore.

**È necessario avere almeno il [piano Standard](https://squarecloud.app/it/pricing) per usare questa route.**

Lo stesso account può collegare un dominio a più applicazioni (load balancing): fino a 2 applicazioni su Standard, 5 su Pro e 10 su Enterprise. Vedi [Elenca Load Balancer](/it/api-reference/endpoint/apps/network/load-balancers).

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La chiave API del tuo account. Puoi trovarla nelle [impostazioni del tuo account](https://squarecloud.app/it/account/security).
</ParamField>

### Parametri

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID dell'applicazione. Puoi trovarlo nell'URL della dashboard della tua applicazione.
</ParamField>

<ParamField body="custom" type="string" placeholder="example.com" required>
  Il dominio completo (fully qualified) da collegare, oppure `@` per rimuovere l'attuale dominio personalizzato dell'applicazione. Non può essere un dominio Square Cloud (`squareweb.app`, `squarecloud.app`, ...).
</ParamField>

### Risposta

<ResponseField name="status" type="string">
  Indica se la chiamata è andata a buon fine. `success` in caso di successo, `error` in caso contrario.
</ResponseField>

In caso di errore, la risposta include un `code` di errore:

| Status | Code                          | Significato                                                                                 |
| ------ | ----------------------------- | ------------------------------------------------------------------------------------------- |
| `400`  | `REGEX_VALIDATION`            | Il dominio non è un nome di dominio completo (fully qualified) valido.                      |
| `400`  | `RESERVED_DOMAIN`             | I domini Square Cloud non possono essere usati come dominio personalizzato.                 |
| `403`  | `UPGRADE_REQUIRED`            | Il piano attivo non include i domini personalizzati (richiesto Standard, Pro o Enterprise). |
| `403`  | `LOAD_BALANCER_LIMIT_REACHED` | È stato raggiunto il limite di applicazioni del piano su questo dominio.                    |
| `409`  | `DOMAIN_ALREADY_EXISTS`       | Il dominio è già collegato a un'applicazione di proprietà di un altro account.              |
| `502`  | `DNS_FAILED`                  | Il collegamento del dominio è fallito presso il provider edge.                              |

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