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

> Lista los roles de un workspace. Requiere el permiso `members:read`.

Requiere `members:read` (no es un `roles:read` aparte: leer la lista de roles viene incluido con leer los miembros).
Una clave de API necesita el scope `workspaces:read`.

### Ruta

**id** `string` *required*

ID del workspace.

### Respuesta

**response** `APIWorkspaceRole[]`

**Mostrar objeto**

**id** `string`

**workspace\_id** `string`

**name** `string`

**permissions** `WorkspacePermission[]`

Ver el [catálogo de permisos](https://docs.vertracloud.app/es-es/knowledge-base.md#10-workspaces): 20 entradas entre aplicaciones, bases de datos, snapshots, Blob Storage, miembros, roles y actividades.

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

Rol inicial del que se creó. `null` para un rol hecho a mano. Es solo informativo: un rol inicial se puede editar y eliminar como cualquier otro.

**position** `number`

Orden de visualización.

**members\_count** `number`

**created\_at** `string`

**updated\_at** `string`

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `members:read`. |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |


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