Organisations

Endpoints

GET/organisations/{id}
PATCH/organisations/{id}
POST/organisations/{id}/graduate

Organisations are the top-level container for everything in Backstage. Each organisation has its own accounts, events, venues, and users-completely isolated from other organisations.

Organisation Structure#

Organisation
├── Accounts (divisions/departments)
│   ├── Events
│   └── Users (via role assignments)
├── Venues
└── Roles & Permissions

Key Concepts#

Slug - The URL-friendly identifier (e.g., "acme-corp")
Branding - Logo, colours, and styling for white-label use
Settings - Organisation-wide configuration options

Most API requests require the X-Ticketlayer-Org header to specify which organisation you're working with.

Operations#

getOrganisation
updateOrganisation
graduateOrganisation