# Preview an invite by its token, without accepting it

> Preview an invite by its token, without accepting it: CustomDomain™ API reference in the members group. Covers parameters, request body and responses.

Source: https://docs.customdomain.ai/docs/api-reference/members/previewInvite

## `POST https://api.customdomain.ai/v1/members:preview`

What an invite link is for: the invited email, the workspace, the role, who sent it, and whether it still works. Nothing is accepted or spent. Public: the token is the capability, and it travels in the body so it never lands in an access log. A link that stopped working says why (`accepted`, `expired`, `revoked`, or `replaced` by a newer invite to the same address); a token that was never issued is a 404. Rate-limited per client address.

### Authentication

None.

### Request body (JSON)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `token` | string | yes | The invite token from the invite link. |

### Responses

| Status | Description |
| --- | --- |
| `200` | The invite |
| `400` | Error envelope: {code, title, details}. |
| `404` | Error envelope: {code, title, details}. |
| `429` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | `pending`, `accepted`, `expired`, `revoked`, `replaced` | yes | `pending`: the link works. `accepted`: it was used. `expired`: it lapsed. `revoked`: an admin withdrew the invite. `replaced`: a newer invite was sent to the same address. |
| `email` | string | yes | The invited address. |
| `role` | `owner`, `admin`, `member`, `viewer` | yes |  |
| `tenant_id` | string | yes |  |
| `workspace_name` | string | yes | The tenant's display name. |
| `inviter_name` | string | no |  |
| `inviter_email` | string | no |  |
| `invited_at` | string | no |  |
| `expires_at` | string | no | When the link stops (or stopped) working. Absent when it never expires. |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
