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

> Lista las invitaciones pendientes y pasadas. Requiere `members:manage`; una clave de API necesita el scope `workspaces:invites`.

> [!NOTE]
>
> Una clave de API necesita el scope `workspaces:invites` (solo en el preset `full` o en una selección personalizada).
> Crear invitaciones sigue siendo exclusivo del panel.

Requiere el permiso `members:manage`.

### Ruta

**id** `string` *required*

ID del workspace.

### Respuesta

**response** `APIWorkspaceInvite[]`

**Mostrar objeto**

**id** `string`

**workspace\_id** `string`

**kind** `'email' | 'link'`

**email** `string | null`

Solo se rellena para `kind: \"email\"`.

**role\_id** `string`

**role\_name** `string`

**invited\_by** `object`

`{ id, display_name }`.

**expires\_at** `string`

7 días desde la creación para invitaciones por correo, 24 h fijas para invitaciones por enlace.

**accepted\_at** `string | null`

**revoked\_at** `string | null`

**uses** `number`

**max\_uses** `number | null`

Solo para `kind: \"link\"`; `null` = ilimitado.

**expires\_in\_days** `number | null`

Vencimiento del acceso que se aplica al miembro cuando entra por esta invitación. `null` = sin vencimiento.

**created\_at** `string`

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `API_KEY_SCOPE_DENIED` | Se llamó con una clave de API que no tiene el scope `workspaces:invites`. |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `members:manage`. |
| 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.