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

# Detalles de la aplicación

> Devuelve los detalles de una aplicación a partir de su ID.

**id** `string` *required*

El ID de la aplicación cuyos detalles quieres obtener. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta `workspace_id`.

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

### Respuesta

**response** `object`

Los detalles de la aplicación.

**Mostrar objeto**

**id** `string`

El ID de la aplicación.

**cluster** `integer`

El ID del clúster de la aplicación.

**type** `integer`

El tipo de aplicación.

**name** `string`

El nombre de la aplicación.

**description** `string`

La descripción de la aplicación.

**owner\_id** `string`

El ID del propietario de la aplicación.

**owner\_plan** `string | null`

El nombre del plan del propietario (por ejemplo, `pro` o `enterprise-8`), o `null` si el propietario no tiene plan.

**language** `string`

El lenguaje de programación de la aplicación (por ejemplo, `javascript`).

**ram** `integer`

La RAM de la aplicación, en MB.

**status** `string`

El estado de la aplicación: `up`, `down` o `building` (creación en curso; la mayoría de las acciones responden `409 APP_BUILDING`).

**last\_build\_error** `string | null`

El código del último fallo de build o de instalación, o `null` tras un build correcto. Es uno de
`BUILD_FAILED`, `BUILD_TIMEOUT`, `BUILD_INTERRUPTED`, `INSTALL_FAILED`, `INSTALL_OUT_OF_MEMORY`,
`INSTALL_TIMEOUT` o `INSTALL_SHIELD_BLOCKED`. El detalle está en los logs de la aplicación; consulta
[Errores](https://docs.vertracloud.app/es-es/api-reference/errors.md#códigos-de-fallo-del-build) para saber qué hacer con cada código.

**subdomain** `string | null`

El subdominio de la aplicación, si aplica.

**domains** `APIApplicationDomain[]`

Los dominios personalizados de la aplicación, con su estado, el estado del SSL, el puerto, el prefijo de ruta y la redirección. Vacío si no tiene ninguno.
Cada elemento se describe en [Listar dominios de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/domains/list.md#respuesta).

**public\_url** `string | null`

La URL pública canónica de la aplicación, ya calculada por el servidor: el dominio personalizado principal si existe; si no, el `subdomain`
(`null` si la aplicación no tiene ninguno de los dos, es decir, no está publicada en la web). Construye los enlaces a partir de este campo,
nunca directamente desde `subdomain`: un despliegue autoalojado detrás de un edge no estándar puede devolver aquí otro host o esquema.

**last\_snapshot** `string | null`

La fecha y hora del último snapshot de la aplicación.

**main\_file** `string`

El archivo principal de la aplicación.

**version** `string`

La versión del runtime (por ejemplo, `recommended` o `latest`).

**start\_command** `string | null`

El comando de inicio de la aplicación, si se ha especificado.

**build\_command** `string | null`

El comando de build, si se ha especificado. Se ejecuta después de instalar las dependencias y antes de que la aplicación arranque,
en un entorno de build aislado. `null` cuando no hay ningún comando de build configurado.

**offline\_since** `string | null`

La fecha y hora desde la que la aplicación está fuera de línea, si aplica.

**shield\_cooldown** `object | null`

Aparece mientras Vertra Shield tiene la aplicación en pausa. Incluye `until` (la hora en que termina el enfriamiento), `reason` (`burst` o `rate_limit`)
y `direction` (`in` o `out`); `null` cuando no hay ningún enfriamiento activo.

**github** `object | null`

El repositorio de GitHub vinculado (`repo_owner`, `repo_name`) cuando el auto-deploy está conectado; `null` si la aplicación se creó desde un zip
o un snapshot. La URL del webhook no se incluye: para obtenerla, usa `GET /v1/apps/{id}/deploys/webhook`.

**custom\_image** `object | null`

La imagen Docker personalizada desde la que se ejecuta la aplicación; `null` en una aplicación normal. Con una imagen, `language`, `version`, `main_file`, `start_command`
y `build_command` no aplican: vienen de la imagen. Consulta [Imágenes Docker personalizadas](https://docs.vertracloud.app/es-es/guides/custom-docker-images.md).

**Propiedades de custom\_image**

**image\_id** `string`

El ID de la imagen. `id` y `name` de este objeto son los de la aplicación, no los de la imagen.

**port** `integer | null`

El puerto en el que escucha la aplicación y al que la plataforma enruta el tráfico; `null` en una aplicación sin tráfico web.

**version\_id** `string | null`

La versión de la imagen que ejecuta la aplicación, o `null` si todavía no ha arrancado con ninguna versión.

**outdated** `boolean`

`true` cuando la imagen tiene una versión más reciente que la que ejecuta la aplicación. La aplicación pasará a ella en el siguiente reinicio o despliegue que pidas.

**template** `object | null`

Desde dónde se creó la aplicación, cuando se creó desde una [plantilla](https://docs.vertracloud.app/es-es/templates/use/using-a-template.md), o `null` en una aplicación normal.

**Propiedades de template**

**template\_id** `string`

El ID de la plantilla.

**slug** `string`

El slug de la plantilla.

**name** `object`

El nombre de la plantilla por idioma: `pt-br`, y `en` y `es` cuando está traducida.

**icon\_url** `string | null`

La URL estable del icono de la plantilla, o `null` para una plantilla privada sin icono o una plantilla que se ha eliminado.

**origin** `string`

`vertra`, `community` o `private`.

**version\_id** `string`

El ID de la versión con la que se creó la aplicación o a la que se actualizó por última vez.

**version** `string`

El número de esa versión.

**closed** `boolean`

`true` cuando la plantilla está cerrada: el código de la aplicación no es accesible.

**detached** `boolean`

`true` cuando la aplicación se desvinculó de la plantilla y ya no recibe versiones.

**update\_available** `boolean`

`true` cuando la plantilla tiene una versión más reciente a la que la aplicación puede actualizarse.

**latest\_version** `string | null`

El número de la versión más reciente, o `null` si no hay ninguna.

**removed** `boolean`

`true` cuando el autor eliminó la plantilla; la aplicación sigue funcionando, pero ya no recibe actualizaciones.

**via\_share\_link** `boolean`

`true` cuando la aplicación se creó desde un enlace para compartir.

**service\_id** `string | null`

El ID del servicio de la plantilla que es esta aplicación, o `null` cuando la plantilla tiene un único servicio.

**permissions** `object`

Lo que la plantilla te permite hacer con esta aplicación: `code_view`, `code_edit`, `ram_change`, `ram_below_min`, `ram_above_max`, `env_add`, `commands_edit`, `terminal`, `save_as_template` y `detach`, todos booleanos.

**locked\_deploy\_settings** `string[]`

Los ajustes de despliegue que la plantilla bloquea para esta aplicación: `zero_downtime` y/o `auto_rollback`. Cambiarlos a otro valor en [`PATCH /v1/apps/:id/config`](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/updateconfig) devuelve `403 TEMPLATE_SETTING_LOCKED`. Vacío cuando la aplicación está desvinculada.

**stack\_id** `string | null`

El ID del [stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/get.md) al que pertenece la aplicación, o `null` si no está en ninguno.

**stack\_service\_key** `string | null`

El ID del servicio de la plantilla que es esta aplicación dentro del stack, o `null` si la añadiste tú mismo.

**deploy** `object`

Cómo un despliegue reemplaza la versión en ejecución y qué pasa si falla.

**Propiedades de deploy**

**zero\_downtime** `string`

La opción guardada: `off` (la predeterminada), `auto` u `on`. Cámbiala con [Actualizar la configuración de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/updateconfig.md).

**zero\_downtime\_active** `boolean`

Lo que se aplica al siguiente reinicio o despliegue: `true` en Enterprise cuando `zero_downtime` es `on`, o cuando es `auto` y la aplicación recibe tráfico web.

**auto\_rollback** `boolean`

La opción guardada, `false` por defecto. Devuelve el valor guardado en cualquier plan, pero solo surte efecto desde Intermediary.

**health\_check\_path** `string | null`

La ruta HTTP a la que se llama en una nueva versión para comprobar que está sana. `null` significa `/`.

**created\_at** `string`

La fecha y hora en que se creó la aplicación.

**updated\_at** `string`

La fecha y hora de la última actualización de la aplicación.

```json Response theme={null}
{
  "response": {
    "id": "app-abc123def456",
    "cluster": 1,
    "type": 1,
    "name": "API Simples",
    "description": "I have a description :)",
    "owner_id": "user-123456789012345678",
    "owner_plan": "pro",
    "language": "javascript",
    "ram": 128,
    "status": "up",
    "subdomain": "myapp.vertraweb.app",
    "domains": [],
    "public_url": "https://myapp.vertraweb.app",
    "last_snapshot": "2026-03-09T15:51:47.234Z",
    "main_file": "index.js",
    "version": "recommended",
    "start_command": "node index.js",
    "build_command": null,
    "offline_since": null,
    "shield_cooldown": null,
    "github": null,
    "custom_image": null,
    "deploy": {
      "zero_downtime": "off",
      "zero_downtime_active": false,
      "auto_rollback": false,
      "health_check_path": null
    },
    "created_at": "2026-03-09T15:51:47.234Z",
    "updated_at": "2026-03-20T15:06:41.449Z"
  }
}
```

### Respuestas de error

**code** `string`

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

* `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`).
* `ACCESS_DENIED`: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (`403`).
* `APP_NOT_FOUND`: La aplicación indicada no existe.

**message** `string`

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

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

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```


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