---
title: "Add Workspace User"
method: POST
path: "/open/workspaces/{workspaceId}/users/add"
tags: ["Workspace Users"]
---

# Add Workspace User

`POST /open/workspaces/{workspaceId}/users/add`

Requires `workspace-users-write`. Add an existing user or send an invite if the email is unknown. Self-hosted Community instances are limited to 2 users total across the instance; adding or inviting more users requires a self-hosted Enterprise license.

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `email` string, email, required
  - `role` 'admin' | 'user' | 'readonly', required

## Response `200`

User added

## Other responses

- `403` — Forbidden, insufficient privileges, or self-hosted Community user limit reached

---

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