/bff/admin/switch-to-organisation

Switches the admin's session context to the specified organisation. Creates a new login identity and sets an auth cookie. Useful for customer support to impersonate an organisation context. Requires internal admin membership.

AdminpostBffAdminSwitch-to-organisation

Parameters

JSON body

Request body

application/json

organisationSlugstringRequired

Slug of the organisation to switch into.

Exampleacme-corp

Response schema

1 status code documented

200Success

successbooleanRequired

Whether the switch was successful.

identityIdstringOptional

New identity ID after switching.

Response example

application/json

{
  "success": false,
  "identityId": "example_identityId"
}

Request example

POST /bff/admin/switch-to-organisation

post

curl -X POST "https://api.bizkithub.com/bff/admin/switch-to-organisation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationSlug": "acme-corp"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key