---
title: "Create Workspace Invite"
method: POST
path: "/workspaces/{workspace_id}/invites"
tags: ["invites"]
---

# Create Workspace Invite

`POST /workspaces/{workspace_id}/invites`

Create a magic-link invite for a workspace. Returns the token.

## Path parameters

- `workspace_id` string, required

## Request body

- CreateInviteRequest
  - `invitee_email` string, required
  - `role` 'owner' | 'editor' | 'viewer' | 'commenter'
  - `message` string, nullable
  - `notify_people` boolean
  - `review` ReviewMetadata — Optional review request metadata for combined invite + review flow. snapshot_id anchors the request to the node being shared; the reviewer binds in on invite acceptance.
    - `snapshot_id` string, required
    - `message` string, nullable

## Response `200`

Successful Response

- InviteResponse
  - `id` string, required
  - `workspace_id` string, required
  - `invitee_email` string, required
  - `role` 'owner' | 'editor' | 'viewer' | 'commenter', required
  - `message` string, nullable, required
  - `token` string, nullable, required
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `accepted_at` string, date-time, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.net/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/versions/28bdface01df/schema)