---
title: "Create an invite: email (sent to an address) or shareable link (member/viewer only)"
method: POST
path: "/v1/workspaces/active/invites"
tags: ["workspaces"]
---

# Create an invite: email (sent to an address) or shareable link (member/viewer only)

`POST /v1/workspaces/active/invites`

## Request

- Base URL: `https://api.tently.dev`
- URL: `https://api.tently.dev/v1/workspaces/active/invites`
- Auth: none declared

## Request body

- object
  - `role` 'owner' | 'member' | 'viewer', required
  - `kind` 'email' | 'link', required
  - `email` string, email
  - `maxUses` integer
  - `expiresInDays` integer

## Response `201`

Default Response

- object
  - `id` string, uuid, required
  - `role` 'owner' | 'member' | 'viewer', required
  - `kind` 'email' | 'link', required
  - `invitedEmail` string, nullable, required
  - `token` string, required
  - `status` string, required
  - `maxUses` number, nullable, required
  - `usedCount` number, required
  - `expiresAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `409`: Default Response
- `503`: Default Response

---

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