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

# Previsualizar invitación

> Muestra a qué lleva una invitación antes de aceptarla. Cualquier cuenta con sesión iniciada; una clave de API necesita el scope `workspaces:invites`.

> [!NOTE]
>
> Una clave de API necesita el scope `workspaces:invites`. Tiene un límite de **10 peticiones por minuto**, por sesión
>
> * IP a la vez: el token es adivinable en teoría (32 bytes aleatorios, pero sigue siendo un secreto de tipo bearer en la
>   URL), por eso esta ruta tiene un cupo más estricto que el resto de `/v1/workspaces`.

Cualquier cuenta con sesión iniciada puede llamar a esto: el propio token es la credencial, no la pertenencia al workspace.

> [!NOTE]
>
> `410 WORKSPACE_INVITE_EXPIRED` significa que la invitación existió y se le acabó el tiempo. `404
>     WORKSPACE_INVITE_NOT_FOUND` cubre las revocadas, las ya aceptadas y las agotadas (enlace con `max_uses`), porque esos
> tres casos deberían verse distintos para quien tiene el enlace que un «llegaste tarde».

### Ruta

**token** `string` *required*

El token de la invitación, de la URL o del correo. Opaco, de 16 a 128 caracteres.

### Respuesta

**response** `APIWorkspaceInvitePreview`

**Mostrar objeto**

**workspace** `object`

`{ id, name }`.

**inviter** `object`

`{ display_name }`.

**role\_name** `string`

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

**expires\_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`. |
| 404 | `WORKSPACE_INVITE_NOT_FOUND` | El token no existe, o la invitación fue revocada, aceptada o agotada. |
| 410 | `WORKSPACE_INVITE_EXPIRED` | La invitación existió, pero ya venció. |


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