Add a member to the workspace

Add an existing organization member to this workspace, or invite a new user to the org and grant them workspace access.

If the email matches an existing org member, they are added directly. Otherwise an invitation email is sent (when sendInvite is true) and invited: true is returned.

roleId must reference a workspace role on the current workspace — discover available roles via GET /api/v1/workspace-roles.

Permission required: MANAGE_MEMBERS on the workspace.

POST /api/v1/members

Add a member to the workspace

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/members \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "email": "[e-mail]",
  "roleId": "<string>",
  "sendInvite": true
}
'

200

{
  "userId": "<string>",
  "email": "<string>",
  "name": "<string>",
  "roleId": "<string>",
  "roleName": "<string>",
  "workspaceId": "<string>",
  "organizationId": "<string>",
  "invited": true,
  "addedAt": "<unknown>"
}

Headers

authorization · string · required

Bearer token for API authentication

Body

application/json

Body

Add a member to the workspace

email · string<email> · required

User email

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

roleId · string · required

Workspace role ID. Look up available role IDs via GET /api/v1/workspace-roles.

sendInvite · boolean · default: true · required

If the user does not already exist, send an invitation email

Response

200

application/json

Workspace member

Workspace member

userId · string | null · required

Null when an invite was sent for a non-existent user

email · string · required

name · string | null · required

roleId · string · required

The immutable role identifier

roleName · string · required

Human-readable role name (may be renamed by org admins)

workspaceId · string · required

organizationId · string · required

invited · boolean · required

True if an invitation was sent rather than an immediate add

addedAt · any · required