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

# Listar stacks

> Lista los stacks de tu cuenta, o de un workspace, con sus miembros, estado y conexiones.

Devuelve todos los stacks que posees, o los stacks de un workspace cuando pasas `workspace_id`. Un stack agrupa aplicaciones, bases de datos y carpetas de Blob, y las conexiones entre ellos. Consulta [Stacks](https://docs.vertracloud.app/es-es/templates/use/stacks.md) para ver el concepto.

Requiere el scope `stacks:read` cuando se llama con una clave de API.

**workspace\_id** `string`

Lista los stacks de este workspace en lugar de los tuyos. Los miembros del workspace pueden leer los stacks; solo el propietario puede modificarlos.

### Response

**response** `object[]`

Un array de stacks. Cada elemento tiene la misma forma que el objeto que devuelve [Obtener stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/get.md).

```json Response theme={null}
{
  "response": [
    {
      "id": "stk-abc123def456",
      "name": "shop",
      "description": null,
      "network_mode": "public",
      "owner_id": "usr-abc123",
      "workspace_id": null,
      "members": [],
      "status": { "up": 2, "down": 0, "building": 0, "total": 2 },
      "ram_total": 768,
      "bindings": [],
      "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 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |


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