> ## 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 as stacks da sua conta ou de um workspace, com os membros, o status e as conexões.

Retorna todas as stacks que você possui, ou as stacks de um workspace quando você envia `workspace_id`. Uma stack agrupa apps, bancos de dados e pastas do Blob e as conexões entre eles. Veja [Stacks](https://docs.vertracloud.app/pt-br/templates/use/stacks.md) para o conceito.

Precisa do escopo `stacks:read` quando chamado com uma chave de API.

**workspace\_id** `string`

Lista as stacks deste workspace em vez das suas. Membros do workspace podem ler stacks; só o dono pode alterá-las.

### Resposta

**response** `object[]`

Um array de stacks. Cada item tem o mesmo formato do objeto retornado por [Obter stack](https://docs.vertracloud.app/pt-br/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"
    }
  ]
}
```

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `API_KEY_SCOPE_DENIED` | A chave não tem `stacks:read`. |
| 404 | `WORKSPACE_NOT_FOUND` | O workspace não existe ou você não é membro. |


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