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

# Create Invite

`POST /api/v1/workspaces/{workspace_id}/invites`

## Path parameters

- `workspace_id` string, uuid4, required

## Request body

- CreateInviteCommand
  - `email` string, email, required
  - `privilege` 'ROLE_WORKSPACE_OWNER' | 'ROLE_WORKSPACE_ADMIN' | 'ROLE_WORKSPACE_MEMBER', required

## Response `201`

Successful Response

- InviteResponse
  - `id` string, uuid4, required
  - `email` string, email, required
  - `workspaceId` string, uuid4, required
  - `inviterId` string, required
  - `privileges` WorkspacePrivilege[], required
  - `status` 'pending' | 'accepted' | 'declined' | 'revoked' | 'expired', required
  - `updatedAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `workspaceName` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/askui/apis/askui-workspaces-api.md) · [All operations](https://skmtc.dev/askui/apis/askui-workspaces-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/askui/askui-workspaces-api/revisions/b796c74292ac/schema)