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

> Lista todos os workspaces que a conta autenticada possui ou dos quais é membro.

Disponível para qualquer conta logada — você não precisa de `members:read` em nenhum workspace para
listar os que você integra. Uma chave de API precisa do escopo `workspaces:read`.

### Resposta

**response** `APIWorkspace[]`

**Mostrar objeto**

**id** `string`

**name** `string`

**description** `string | null`

**owner\_id** `string`

**owner** `object`

`{ display_name }` do dono.

**members\_count** `number`

**deleted\_at** `string | null`

Marcador de exclusão lógica. Sempre `null` aqui — workspaces apagados não aparecem na lista.

**created\_at** `string`

**updated\_at** `string`

```json Response theme={null}
{
  "response": [
    {
      "id": "b7e2d1a4-...",
      "name": "Acme backend",
      "description": "Production apps and databases",
      "owner_id": "123456789012345678",
      "owner": { "display_name": "Alice" },
      "members_count": 4,
      "deleted_at": null,
      "created_at": "2026-09-01T12:00:00Z",
      "updated_at": "2026-09-01T12:00:00Z"
    }
  ]
}
```


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