Add a member to the workspace
Adds a member of the organization to this workspace with the role roleId, and returns the new member. To list roles, call GET /api/v1/roles.
If the email address is on a domain that your organization manages through SSO, and no account has it yet, the request creates the account, makes it a member of the organization and this workspace, and returns it. The person signs in through SSO, so there’s no invitation to accept.
Otherwise, if no member of the organization has the email address, the request returns 404. To invite someone who isn’t a member of the organization yet, call POST /api/v1/member-invites.
Permission required: MANAGE_WORKSPACE_MEMBERS on the workspace.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 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
Response
Workspace member
Workspace member
User ID of the member. Address the member with it in /api/v1/members/{userId}.
Full name. Null when the user has no name.
Workspace role
ACTIVE once the member has signed in at least once
ACTIVE, INACTIVE When the user was added to the workspace

