---
title: "Preview a token-bound invite and select its required authentication path"
method: POST
path: "/auth/invites/preview"
tags: ["Auth"]
---

# Preview a token-bound invite and select its required authentication path

`POST /auth/invites/preview`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/auth/invites/preview`
- Auth: none required

## Request body

- InviteTokenInput
  - `token` string, required

## Response `200`

Invite display data

- InvitePreviewResponse
  - `success` boolean
  - `data` InvitePreview
    - `email` string, email
    - `companyId` string, uuid
    - `companyName` string, nullable
    - `role` 'Admin' | 'CFO' | 'Member'
    - `expiresAt` string, date-time
    - `status` 'valid' | 'expired' | 'revoked' | 'accepted'
    - `existingAccount` boolean: True only when this valid high-entropy invite is bound to an existing Median account.

## Other responses

- `404`: Invite not found
- `422`: Validation error

---

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