---
title: "POST /v1/workspaces/{workspaceId}/members/invite"
method: POST
path: "/v1/workspaces/{workspaceId}/members/invite"
tags: ["Workspaces"]
---

# POST /v1/workspaces/{workspaceId}/members/invite

`POST /v1/workspaces/{workspaceId}/members/invite`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/workspaces/{workspaceId}/members/invite`
- Auth: API key in header `x-api-key`

## Path parameters

- `workspaceId` string, required

## Request body

- InviteMemberRequestDto
  - `email` string, email, required: Email of the person to invite
  - `role` 'admin' | 'member' | 'restricted_member', required: Role to assign to the invited member

## Response `201`

- InviteMemberResponseDto
  - `message` string, required: Success message

---

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