> ## 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 cada workspace del que la cuenta autenticada es propietaria o miembro.

Disponible para cualquier cuenta con sesión iniciada: no necesitas `members:read` en ningún workspace para listar
aquellos a los que perteneces. Una clave de API necesita el scope `workspaces:read`.

### Respuesta

**response** `APIWorkspace[]`

**Mostrar objeto**

**id** `string`

**name** `string`

**description** `string | null`

**owner\_id** `string`

**owner** `object`

`{ display_name }` del propietario.

**members\_count** `number`

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

Marca de eliminación lógica. Siempre `null` aquí: los workspaces eliminados no aparecen en la 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.