Skip to main content

Create User

POST 
/users

Create a new user. Platform admin access only.

A non-admin user must be assigned to a workspace at creation — workspace_id and workspace_role add the new user as a member of that workspace with the given role. A platform admin (is_platform_admin=true) needs no workspace. Either way, a personal workspace is always provisioned for the new user alongside whatever workspace was requested.

Returns 403 if the caller is not a platform admin, 409 if the username is already taken, 404 if workspace_id is supplied but does not exist, and 422 if workspace_id is omitted for a non-admin user or workspace_role is not a recognized role.

Request​

Responses​

Successful Response