/bff/cms/switch-organisation

Switches the user session to a different organisation. Creates a new identity session for the target organisation. User must be a member of the target organisation. Updates the organisation order in the user menu (most recently accessed first).

CMSpostBffCmsSwitch-organisation

Parameters

JSON body

Request body

application/json

identityCookiesstringRequired

Current user identity cookie value.

Exampleabc123-identity-token

organisationstringRequired

Slug of the organisation to switch to.

Exampleacme-corp

Response schema

1 status code documented

200SuccessOrganisation switch result.

successbooleanRequired

Always true on success.

Default: true

identityIdstringOptional

New identity ID for the switched organisation session.

Examplexyz789-new-identity

Response example

application/json

{
  "success": true,
  "identityId": "xyz789-new-identity"
}

Request example

POST /bff/cms/switch-organisation

post

curl -X POST "https://api.bizkithub.com/bff/cms/switch-organisation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "identityCookies": "abc123-identity-token",
  "organisation": "acme-corp"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key