Invite someone to the workspace
Invites someone who isn’t a member of the organization to join it and this workspace with the role roleId, and emails them the invitation. The invitation expires after two days; to send it again, call POST /api/v1/member-invites/{id}/resend. When they accept, they become a member of the workspace.
To add someone who is already a member of the organization, or whose email address is on a domain that your organization manages through SSO, call POST /api/v1/members. If the email address already has a pending invitation, the request returns 409 ALREADY_EXISTS, and if it’s on an SSO-managed domain, 409 INVALID_STATE.
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
Invite someone to the workspace
Email address of the person to invite. They must not be a member of the organization.
^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$Workspace role ID the invitee gets on accepting. To list roles, call GET /api/v1/roles.
Response
An invitation to join the workspace
An invitation to join the workspace
Invitation ID
The workspace role the invitee gets on accepting
PENDING until the invitee accepts, then ACCEPTED
DRAFT, PENDING, ACCEPTED, DECLINED The member who sent the invitation
When the invitation was created.

