> ## 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 papéis

> Lista os papéis de um workspace. Exige a permissão `members:read`.

Exige `members:read` (não é um `roles:read` separado — ler a lista de papéis vem junto com ler os
membros). Uma chave de API precisa do escopo `workspaces:read`.

### Caminho

**id** `string` *required*

ID do workspace.

### Resposta

**response** `APIWorkspaceRole[]`

**Mostrar objeto**

**id** `string`

**workspace\_id** `string`

**name** `string`

**permissions** `WorkspacePermission[]`

Veja o [catálogo de permissões](https://docs.vertracloud.app/pt-br/knowledge-base.md#10-workspaces) — 20 entradas entre aplicações, bancos de dados, snapshots, Blob Storage, membros, papéis e atividades.

**preset** `'admin' | 'developer' | 'operator' | 'viewer' | null`

Papel inicial de que este foi criado. `null` para um papel feito à mão. Apenas informativo — um papel inicial é editável e apagável como qualquer outro.

**position** `number`

Ordem de exibição.

**members\_count** `number`

**created\_at** `string`

**updated\_at** `string`

### 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 ou você não é membro. |


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