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

# Configurar dominio automáticamente

> Reservada para la configuración automática del DNS. Todavía no está disponible: la ruta responde siempre 404 DOMAIN_CONNECT_UNAVAILABLE.

> [!WARNING]
>
> **Todavía no está disponible.** La configuración automática del DNS no se ha publicado, así que hoy esta ruta responde
> `404 DOMAIN_CONNECT_UNAVAILABLE` en todas las llamadas. Crea los registros tú mismo con
> [Registros DNS del dominio](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/domains/dns.md).

La ruta forma parte del contrato de la API para que los clientes puedan gestionarla. Requiere el scope `apps:write` cuando se llama con una
clave de API. El resto de esta página describe la forma de la respuesta, que hoy ninguna llamada devuelve.

**id** `string` *required*

El ID de la aplicación.

**domain\_id** `string` *required*

El ID del dominio, obtenido de [Listar dominios de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/domains/list.md).

**workspace\_id** `string`

Si la aplicación pertenece a un workspace, el ID de ese workspace. Obligatorio para los miembros del workspace que actúan sobre una aplicación que no les pertenece.

### Respuesta

**response** `APIApplicationDomainConnect`

**Mostrar objeto**

**url** `string`

El enlace que hay que abrir en el proveedor de DNS para aprobar los registros.

```json Response theme={null}
{
  "response": {
    "url": "https://dns-provider.example/v2/domainTemplates/providers/..."
  }
}
```

> [!NOTE]
>
> El enlace es para que lo abras tú, no para llamarlo. Después de aprobarlo, el dominio pasa a `active` cuando el DNS se propaga;
> consulta su estado con [Listar dominios de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/domains/list.md).

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `VALIDATION_ERROR`: Los parámetros de ruta no superaron la validación (`400`). La respuesta incluye también `message` y `path`.
* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas (`403`).
* `USER_NOT_FOUND`: No se pudo resolver el usuario autenticado (`401`).
* `ACCESS_DENIED`: El usuario no tiene permiso para actuar sobre la aplicación (`403`).
* `API_KEY_SCOPE_DENIED`: La clave de API no tiene el scope `apps:write` (`403`).
* `APP_NOT_FOUND`: La aplicación indicada no existe (`404`).
* `DOMAIN_NOT_FOUND`: La aplicación no tiene ningún dominio con ese ID (`404`).
* `DOMAIN_CONNECT_UNAVAILABLE`: La configuración automática todavía no está disponible, así que todas las llamadas responden este código (`404`). Usa los registros manuales.
* `RATE_LIMIT_EXCEEDED`: Se alcanzó el presupuesto de la ruta (`429`).
* `INTERNAL_SERVER_ERROR`: Error inesperado (`500`).

```json Error Response (404) theme={null}
{
  "code": "DOMAIN_CONNECT_UNAVAILABLE"
}
```

> [!NOTE]
>
> Esta ruta tiene su propio presupuesto de 10 peticiones por minuto. Consulta [Límites de peticiones](https://docs.vertracloud.app/es-es/api-reference/introduction.md#cómo-se-aplican-los-límites-de-peticiones-a-la-api).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.