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

> Lista los miembros del workspace. Requiere el permiso `members:read`.

Requiere el permiso `members:read` (el propietario siempre pasa). Una clave de API necesita el scope
`workspaces:read`.

### Ruta

**id** `string` *required*

ID del workspace.

### Respuesta

**response** `APIWorkspaceMember[]`

**Mostrar objeto**

**user\_id** `string`

**role\_id** `string`

**role\_name** `string`

**joined\_at** `string`

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

Vencimiento del acceso. `null` = sin vencimiento. Un miembro que pasa esta fecha se trata como no miembro en cada lectura: la limpieza semanal solo elimina la fila después; no es la barrera.

**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" }
    }
  ]
}
```

### Errores

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


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