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

# Visualizar convite

> Mostra para onde um convite leva, antes de aceitar. Qualquer conta logada; uma chave de API precisa do escopo `workspaces:invites`.

> [!NOTE]
>
> Uma chave de API precisa do escopo `workspaces:invites`. Limitada a **10 requisições por minuto**,
> por sessão e IP combinados — o token é adivinhável em teoria (32 bytes aleatórios, mas continua sendo
> um segredo de portador na URL), então esta rota tem um limite mais apertado que o resto de `/v1/workspaces`.

Qualquer conta logada pode chamar isto — o próprio token é a credencial, não a participação no workspace.

> [!NOTE]
>
> `410 WORKSPACE_INVITE_EXPIRED` significa que o convite existiu e o prazo acabou — `404
>     WORKSPACE_INVITE_NOT_FOUND` cobre convites revogados, já aceitos e esgotados (link com `max_uses`),
> porque esses três casos devem aparecer de forma diferente para quem tem o link do que um "você chegou tarde demais".

### Caminho

**token** `string` *required*

O token do convite, vindo da URL ou do e-mail. Opaco, de 16 a 128 caracteres.

### Resposta

**response** `APIWorkspaceInvitePreview`

**Mostrar objeto**

**workspace** `object`

`{ id, name }`.

**inviter** `object`

`{ display_name }`.

**role\_name** `string`

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

**expires\_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`. |
| 404 | `WORKSPACE_INVITE_NOT_FOUND` | O token não existe, ou o convite foi revogado, aceito ou esgotado. |
| 410 | `WORKSPACE_INVITE_EXPIRED` | O convite existiu, mas o prazo dele já passou. |


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