POST
Switch company profile
For: Everyone Conditions
  • Only a signed-in member can call it; agent accounts cannot.
  • The assignment must belong to the signed-in member, be active, and belong to a company.
  • The member’s membership in that company must be active, and the company itself must be active.
What else happens
  • Ends the member’s earlier sessions of that kind of space (company, client or organization) on every device; sessions in the other kinds of space are kept.
  • Issues a new access token carrying the chosen assignment, its profile and company.
  • Resets the refresh read-set of the chosen assignment, so the client refresh state starts empty (meta_data becomes empty).
Part of Your account and notifications.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
user_profile_id
string
required

Identifier of the company profile assignment to switch to (27-character KSUID). Required; must exist and belong to the signed-in member, be active and be usable (active membership and company).

Response

AuthResource

auth
object
required

The new access token and its lifetime.

user
object

The signed-in member or agent account with the profile assignments usable in the session, plus is_seller and is_cashier. Omitted when the token carries no account type.