---
title: "Preview an invite"
method: GET
path: "/invites/{token}"
tags: ["Invites"]
---

# Preview an invite

`GET /invites/{token}`

## Request

- Base URL: `https://tasg.app/api/v1`
- URL: `https://tasg.app/api/v1/invites/{token}`
- Auth: none required

No auth. Rate-limited (30/15 min per IP). Tells the client whether the invitee already has an account.

## Path parameters

- `token` string, required

## Response `200`

Invite.

- object
  - `invite` InvitePreview, required
    - `token` string, required
    - `email` string, email, required
    - `role` 'owner' | 'editor' | 'viewer', required
    - `project_name` string, required
    - `inviter_name` string, required
    - `is_new_user` boolean, required: `true` if no account exists for the email yet; the acceptor must supply `name`.

## Other responses

- `404`: Not found, or not visible to the caller (tenancy is enforced: foreign resources look identical to missing ones).
- `410`: Already used or expired.
- `429`: Too many lookups.

---

[API](https://skmtc.dev/tasg/apis/tasg-api.md) · [All operations](https://skmtc.dev/tasg/apis/tasg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tasg/apis/tasg-api/revisions/cd2a1dbaf5cf?raw)
