---
title: "Preview Invitation"
method: POST
path: "/v1/invitations/preview"
tags: ["v1", "protected", "workspace-invitations"]
---

# Preview Invitation

`POST /v1/invitations/preview`

Describe an invitation the caller could accept: workspace, inviter, expiry.

The token travels in the body so it stays out of access logs.

## Request body

- InvitationPreviewBody
  - `token` string, required

## Response `200`

Successful Response

- InvitationPreviewResponse — What an invitee is shown before joining: who asked, where to, until when. The caller is not a member yet, so nothing else about the workspace leaves this endpoint. The inviter fields are nullable because the identity provider may not resolve them; the client states that rather than guessing.
  - `expires_at` string, required
  - `inviter_display_name` string, nullable, required
  - `inviter_email` string, nullable, required
  - `workspace_name` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `8ccf2531e936` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/invitations/preview/post.md)

---

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