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.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
Bearer token for API authentication
Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
255Body
Body
Add a member to the workspace
User email
^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$Workspace role ID. Look up available role IDs via GET /api/v1/workspace-roles.
If the user does not already exist, send an invitation email
Response
Workspace member
Workspace member
Null when an invite was sent for a non-existent user
The immutable role identifier
Human-readable role name (may be renamed by org admins)
True if an invitation was sent rather than an immediate add

