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

# Obtener stack

> Devuelve un stack con sus miembros, estado, conexiones, memoria total y la plantilla de la que procede.

Devuelve un stack y todo lo que contiene: aplicaciones, bases de datos y carpetas de Blob, las conexiones entre ellas, el estado de los miembros sumado y, cuando el stack procede de una plantilla, la plantilla y su versión. Requiere el scope `stacks:read` cuando se llama con una clave de API.

**stack\_id** `string` *required*

El ID del stack.

**workspace\_id** `string`

El workspace al que pertenece el stack. Es obligatorio para un miembro del workspace que actúe sobre un stack que no le pertenece; el propietario puede omitirlo.

### Response

**response** `object`

El stack.

**Mostrar objeto**

**id** `string`

El ID del stack.

**name** `string`

El nombre del stack.

**description** `string | null`

Descripción opcional, o `null`.

**network\_mode** `string`

Cómo se comunican entre sí los miembros. El valor es `public`: los servicios usan sus direcciones públicas y las bases de datos se alcanzan con certificados de cliente.

**owner\_id** `string`

La cuenta que es propietaria del stack.

**workspace\_id** `string | null`

El workspace al que pertenece el stack, o `null` cuando es tuyo.

**members** `object[]`

Los miembros. Cada uno tiene `resource_type` (`application`, `database` o `blob`), `resource_id`, `name`, `status` (`null` para una carpeta de Blob), `ram` en MB (`0` para una carpeta de Blob), `service_key` (el ID del servicio en la plantilla, `null` para un miembro que añadiste tú), `database_type` (el motor de una base de datos, si no `null`), `closed` (`true` para una aplicación de una [plantilla cerrada](https://docs.vertracloud.app/es-es/templates/use/closed-templates.md): su código no es accesible) y `blob`.

Para un miembro Blob, `blob` tiene el `prefix` de la carpeta, `visibility` (`private` o `public`), `used_bytes` (o `null`) y `api_key_id`, la clave que creó la plataforma para el stack y restringida a esa carpeta. Consulta [Añadir carpeta de Blob](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/blob/create.md).

**status** `object`

Miembros en línea, fuera de línea y en build, sumados: `up`, `down`, `building` y `total` (los miembros que tienen estado).

**ram\_total** `integer`

Memoria de todos los miembros, en MB.

**bindings** `object[]`

Las conexiones entre miembros. Cada una tiene `id`, `stack_id`, `app_id` (la aplicación que recibe las variables), exactamente uno de `database_id`, `blob_id` y `target_app_id`, `env_map` (nombre de variable y lo que recibe), `certs_path` (la carpeta dentro de la aplicación donde se escriben los certificados de cliente de una base de datos, `null` sin base de datos) y `created_at`. Consulta [Crear conexión](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/bindings/create.md).

**template** `object | null`

La plantilla y la versión de las que procede el stack, o `null` para un stack montado a mano. Tiene los mismos campos que el `template` de una [aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/get.md), incluido `icon_url`, la URL estable del icono de la plantilla (`null` cuando no hay ninguno).

**update\_available** `boolean`

`true` cuando la plantilla tiene una versión más nueva a la que el stack puede actualizarse.

**created\_at** `string`

Cuándo se creó el stack.

**updated\_at** `string`

Cuándo se actualizó por última vez el stack.

```json Response theme={null}
{
  "response": {
    "id": "stk-abc123def456",
    "name": "shop",
    "description": null,
    "network_mode": "public",
    "owner_id": "usr-abc123",
    "workspace_id": null,
    "members": [
      { "resource_type": "application", "resource_id": "app-abc123def456", "name": "web", "status": "up", "ram": 512, "service_key": null, "database_type": null, "closed": false, "blob": null },
      { "resource_type": "database", "resource_id": "db-abc123def456", "name": "main", "status": "up", "ram": 256, "service_key": null, "database_type": "postgres", "closed": false, "blob": null }
    ],
    "status": { "up": 2, "down": 0, "building": 0, "total": 2 },
    "ram_total": 768,
    "bindings": [
      {
        "id": "bnd-abc123def456",
        "stack_id": "stk-abc123def456",
        "app_id": "app-abc123def456",
        "database_id": "db-abc123def456",
        "blob_id": null,
        "target_app_id": null,
        "env_map": { "DATABASE_URL": "url" },
        "certs_path": "/app/.vertra/certs/db-abc123def456/",
        "created_at": "2026-10-27T12:00:00.000Z"
      }
    ],
    "template": null,
    "update_available": false,
    "created_at": "2026-10-27T12:00:00.000Z",
    "updated_at": "2026-10-27T12:00:00.000Z"
  }
}
```

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `API_KEY_SCOPE_DENIED` | La clave no tiene `stacks:read`. |
| 404 | `STACK_NOT_FOUND` | El stack no existe o pertenece a otra cuenta. |


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