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

> Lista os membros do workspace. Exige a permissão `members:read`.

Exige a permissão `members:read` (o dono sempre passa). Uma chave de API precisa do escopo
`workspaces:read`.

### Caminho

**id** `string` *required*

ID do workspace.

### Resposta

**response** `APIWorkspaceMember[]`

**Mostrar objeto**

**user\_id** `string`

**role\_id** `string`

**role\_name** `string`

**joined\_at** `string`

**expires\_at** `string | null`

Expiração de acesso. `null` = sem expiração. Um membro depois dessa data é tratado como não membro em toda leitura — a varredura semanal apenas limpa a linha depois; ela não é a barreira.

**user** `object`

`{ display_name, email }`.

```json Response theme={null}
{
  "response": [
    {
      "user_id": "123456789012345678",
      "role_id": "c1a2...",
      "role_name": "Developer",
      "joined_at": "2026-09-01T12:00:00Z",
      "expires_at": null,
      "user": { "display_name": "Bob", "email": "bob@example.com" }
    }
  ]
}
```

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quem chama não tem `members:read`. |
| 404 | `WORKSPACE_NOT_FOUND` | O workspace não existe, foi apagado de forma lógica ou você não é membro. |


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