Skip to main content
POST
Exchange this session for one in another tenant the same person holds an account in.

Headers

Prefer
enum<string>

Preference

Available options:
params=single-object

Body

Exchange this session for one in another tenant the same person holds an account in.

Carries nothing across but the person: the token names the other tenant's user row, and that row's own roles and site access are what RLS answers to. Refuses anything that is not a live account in a live tenant linked to this one, and says the same sentence for "no such organisation" as for "not yours".

Applies the door rules of the tenant being entered rather than the one being left: an SSO-only tenant is refused with SSO_REQUIRED, and a tenant that asks for a second factor answers MFA_REQUIRED with a challenge api.verify_mfa finishes.

p_organization_id
string<uuid>
required
p_device_identifier
string<text>
p_platform
string<text>

Response

200

OK