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

> Lista os convites pendentes e os passados. Exige `members:manage`; uma chave de API precisa do escopo `workspaces:invites`.

> [!NOTE]
>
> Uma chave de API precisa do escopo `workspaces:invites` (só no preset `full` ou em uma seleção
> personalizada). Criar convites continua exclusivo do painel.

Exige a permissão `members:manage`.

### Caminho

**id** `string` *required*

ID do workspace.

### Resposta

**response** `APIWorkspaceInvite[]`

**Mostrar objeto**

**id** `string`

**workspace\_id** `string`

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

**email** `string | null`

Preenchido apenas para `kind: \"email\"`.

**role\_id** `string`

**role\_name** `string`

**invited\_by** `object`

`{ id, display_name }`.

**expires\_at** `string`

7 dias após a criação para convites por e-mail, 24h fixas para convites por link.

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

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

**uses** `number`

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

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

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

Expiração de acesso aplicada ao membro assim que ele entra por este convite. `null` = sem expiração.

**created\_at** `string`

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `API_KEY_SCOPE_DENIED` | Chamada com uma chave de API que não tem o escopo `workspaces:invites`. |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quem chama não tem `members:manage`. |
| 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.