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

# Cambiar el subdominio de la aplicación

> Renombra el subdominio vertraweb.app de una aplicación que ya está publicada en la web.

**id** `string` *required*

El ID de la aplicación.

**workspace\_id** `string`

Si la aplicación pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una aplicación que no les pertenece.

**subdomain** `string` *required*

El nuevo subdominio, sin el sufijo `.vertraweb.app` (por ejemplo, `myapp`). Entre 3 y 50
caracteres, que cumpla `^[a-z0-9][a-z0-9-]*[a-z0-9]$`: letras minúsculas, dígitos y guiones, sin empezar ni terminar en guion.

### Respuesta

**response** `object`

**Mostrar objeto**

**subdomain** `string`

El subdominio completo que sirve ahora la aplicación, con el sufijo incluido.

```json Response theme={null}
{
  "response": {
    "subdomain": "myapp.vertraweb.app"
  }
}
```

> [!NOTE]
>
> Esta ruta solo renombra un subdominio existente. Una aplicación creada sin publicación web responde `APP_HAS_NO_SUBDOMAIN`: activa antes la publicación con
> [Publicar la aplicación en la web](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/network/publish.md).

> [!WARNING]
>
> El subdominio anterior se libera en el momento en que el cambio se completa. No queda reservado para ti,
> y cualquiera puede tomarlo después.

### Respuestas de error

**code** `string`

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

* `VALIDATION_ERROR`: El parámetro de ruta o el cuerpo no superaron la validación (`400`). La respuesta
  también incluye `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`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`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`).
* `PLAN_DOES_NOT_SUPPORT_CUSTOM_SUBDOMAIN`: El plan del propietario no permite elegir el nombre
  del subdominio (`403`).
* `APP_NOT_FOUND`: La aplicación indicada no existe (`404`).
* `APP_HAS_NO_SUBDOMAIN`: La aplicación no está publicada en la web, así que no hay nada que renombrar (`400`).
* `INVALID_SUBDOMAIN_FORMAT`: El valor no es un subdominio válido después de la normalización (`400`).
* `SUBDOMAIN_FORBIDDEN`: El subdominio solicitado está en la lista de nombres reservados de la plataforma (`400`).
* `SUBDOMAIN_TAKEN`: Otra aplicación ya usa ese subdominio (`409`).
* `SUBDOMAIN_CHANGE_RATE_LIMITED`: El subdominio de esta aplicación se cambió hace menos de 5
  minutos (`429`).
* `INTERNAL_SERVER_ERROR`: Fallo inesperado (`500`).

**message** `string`

Un mensaje descriptivo con más detalles sobre el error.

```json Error Response (400) theme={null}
{
  "code": "APP_HAS_NO_SUBDOMAIN"
}
```

```json Error Response (409) theme={null}
{
  "code": "SUBDOMAIN_TAKEN"
}
```

```json Error Response (429) theme={null}
{
  "code": "SUBDOMAIN_CHANGE_RATE_LIMITED"
}
```

> [!NOTE]
>
> Esta ruta tiene su propio presupuesto de 5 peticiones por minuto, además del enfriamiento de 5 minutos entre cambios de la dirección pública de una aplicación. Ese enfriamiento es **compartido con
> [Publicar](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/network/publish.md)**: publicar una aplicación también la inicia, y despublicar y volver a publicar con otro nombre no lo evita. Consulta
> [Límite 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.