Joins the workspace with the role the invitation grants. You must be signed in with the email address the invitation was sent to.
Requires a session JWT for the invited account. API keys are rejected with 401. Any plan.
Email verification
The invitation email is proof that you own the address, so for invitations sent by the current version of Syntext you don't need to verify your email first. Accepting one with an unverified account marks the address as verified.
Invitations created before that change may have been visible to other workspace members, so they still need an account whose email is already verified. Those return 403 email_unverified until you verify. Resending an older invitation doesn't change this — ask an admin for a new invitation instead.
For self-hosted deployments: the cutoff is the INVITE_EMAIL_PROOF_SINCE environment variable, an ISO-8601 timestamp with a time zone (for example 2026-11-10T12:00:00Z). Invitations created at or after it count as proof of the address. When it is unset, the cutoff is the time the API server process started, so a restart makes earlier invitations require a verified email again. An invalid value stops the server from starting.
Path Parameters
tokenResponse — 200 OK
Accepting also closes any other pending invitations to the same address in that workspace. It is recorded in the audit log as org.invite.accepted, with emailVerifiedByInvite: true in the metadata when the invitation verified your address.
Error Responses
400 Bad Request
bad_request — the invitation can't be used:
expired at the same time.401 Unauthorized
unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session has been signed out.
403 Forbidden
invite_email_mismatch — you are signed in with a different address than the invitation's. The comparison ignores case and surrounding whitespace:
email_unverified — only for invitations created before the cutoff described in Email verification, when your account's email isn't verified:
404 Not Found
not_found ("Invitation not found") — no invitation has this token.
409 Conflict
conflict ("You are already a member of this organization"). The invitation is marked accepted so it can't be used again.
See also Invitation errors.