Federate (SSO)
POST
/auth/federateExchange a Stagedoor token for Backstage API tokens.
If your users authenticate through Stagedoor, use this endpoint to convert their
Stagedoor JWT into Backstage access and refresh tokens. This enables seamless
single sign-on across the Ticketlayer platform.
The user must already exist in Backstage (typically created via invitation or
account linking).
When to use this
- Enabling single sign-on from Stagedoor to Backstage
- Building unified authentication across Ticketlayer products
- Letting box office staff access Backstage without a separate login
Request Body
Response
Federation successful
Notes
ℹ️The Stagedoor token must be valid and the user must have a linked Backstage account.
💡Use this for seamless navigation between Stagedoor and Backstage without requiring users to log in twice.
Code Samples
Federate using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
// Federate
const result = await client.auth.federate({ /* request body */ });
console.log('Operation completed:', result);