Skip to main content

Create Workspace User

POST 
/workspaces/:workspace_id/users

Create a new user scoped to this workspace and add them as a member.

Workspace admin or platform admin access only. The created user is always a non-platform-admin with no platform-wide visibility; they are added as a member of only this workspace with the chosen role. This lets a workspace admin onboard users without the platform-admin-only global user CRUD.

Returns 404 if the workspace does not exist. Returns 403 if the caller is not a workspace_admin member of it (or a platform admin). Returns 422 if the workspace is personal (single-user, so it cannot gain a second member this way) or role is not a recognized workspace role. Returns 409 if the username is already taken.

Request​

Responses​

Successful Response