/bff/vendor/switch

Lets a technical manager (member of a vendor organisation) switch their session into a managed customer organisation. If the caller is not yet a member of the target org, a cas__organisation_member row is auto-created first (idempotent). Throws PUBLIC_VENDOR_RELATION_NOT_FOUND when the target org is not a child of any org the caller belongs to.

VendorpostBffVendorSwitch

Parameters

JSON body

Request body

application/json

organisationSlugstringRequired

Slug of the managed organisation to switch into.

Examplemy-shop

Response schema

1 status code documented

200Success

successbooleanRequired

identityIdstring | undefinedOptional

One of 2:

Variant 1

string

Variant 2

undefined

targetOrganisationIdnumberRequired

targetMemberIdnumberRequired

New or existing member row in the target org.

vendorOrganisationIdnumberRequired

Vendor org through which access was granted.

Response example

application/json

{
  "success": false,
  "targetOrganisationId": 0,
  "targetMemberId": 0,
  "vendorOrganisationId": 0
}

Request example

POST /bff/vendor/switch

post

curl -X POST "https://api.bizkithub.com/bff/vendor/switch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationSlug": "my-shop"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key