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

# Establecer dominio personalizado

> Integra tu sitio web con un dominio personalizado. Tiene un límite de 10 cambios cada 5 minutos y 50 cada 24 horas.

**Es necesario tener al menos el [plan Standard](https://squarecloud.app/es/pricing) para usar esta ruta.**

La misma cuenta puede asociar un dominio a varias aplicaciones (balanceo de carga): hasta 2 aplicaciones en Standard, 5 en Pro y 10 en Enterprise. Consulta [Listar balanceadores de carga](/es/api-reference/endpoint/apps/network/load-balancers).

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clave de API de tu cuenta. Puedes encontrarla en la [configuración de tu cuenta](https://squarecloud.app/es/account/security).
</ParamField>

### Parámetros

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.
</ParamField>

<ParamField body="custom" type="string" placeholder="example.com" required>
  El dominio completamente cualificado que se va a asociar, o `@` para eliminar el dominio personalizado actual de la aplicación. No puede ser un dominio de Square Cloud (`squareweb.app`, `squarecloud.app`, ...).
</ParamField>

### Respuesta

<ResponseField name="status" type="string">
  Indica si la llamada fue exitosa. `success` si fue exitosa, `error` si no.
</ResponseField>

En caso de fallo, la respuesta incluye un `code` de error:

| Status | Code                          | Significado                                                                                 |
| ------ | ----------------------------- | ------------------------------------------------------------------------------------------- |
| `400`  | `REGEX_VALIDATION`            | El dominio no es un nombre de dominio completamente cualificado válido.                     |
| `400`  | `RESERVED_DOMAIN`             | Los dominios de Square Cloud no pueden usarse como dominio personalizado.                   |
| `403`  | `UPGRADE_REQUIRED`            | El plan activo no incluye dominios personalizados (se requiere Standard, Pro o Enterprise). |
| `403`  | `LOAD_BALANCER_LIMIT_REACHED` | Se alcanzó el límite de aplicaciones del plan en este dominio.                              |
| `409`  | `DOMAIN_ALREADY_EXISTS`       | El dominio ya está asociado a una aplicación de otra cuenta.                                |
| `502`  | `DNS_FAILED`                  | La asociación del dominio falló en el proveedor edge.                                       |

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