---
title: "Invite user to workspace"
method: POST
path: "/users"
tags: ["workspaces"]
---

# Invite user to workspace

`POST /users`

Invites a new team member to the workspace by email. The invitee will receive an email to accept the invitation before gaining access to workspace resources.

## Request body

- object
  - `email` string, email

## Response `200`

successful operation

- PendingInvitation — Owner fields for Persistence
  - `createdAt` string — The date and time when the resource was created
  - `updatedAt` string — The date and time when the resource was updated
  - `createdBy` string — The user or service account who created the resource
  - `updatedBy` string — The user or service account who updated the resource
  - `email` string — User email
  - `expiresAt` string — The date and time when the invitation expires
  - `invitedBy` string — User sub
  - `role` string — ACL role
  - `workspace` string — Workspace name

## Other responses

- `400` — invalid email format
- `404` — workspace not found

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/revisions/dfa264bc72ee/schema)