Add Area to Layout
POST
/venues/{id}/layouts/{layoutId}/areasCreate a new seating area within a venue layout.
Areas group seats together-think "Stalls", "Circle", "Balcony", or "GA Floor".
Each area can have its own capacity, either as assigned seats or general
admission.
After creating an area, you'll typically add seats to it using the seat
endpoints or the bulk generation tools.
When to use this
- Setting up a new seating section in a venue
- Creating a general admission standing area
- Adding accessible seating sections
Parameters
idpathrequiredVenue ID
layoutIdpathrequiredLayout ID
Request Body
name*stringArea name
descriptionstringArea description
type*"unallocated" | "allocated"Area type (unallocated for GA, allocated for assigned seating)
status"active" | "inactive"Area status
capacity*numberTotal capacity for this area
displayOrdernumberDisplay order in UI (auto-assigned if not provided)
colorstringHex color for visual distinction
seatsany[]Seats array (only for allocated seating areas, leave empty for GA)
x*number
y*number
width*number
height*number
categoryIdstringCategory ID for pricing (especially for GA areas)
Response
Area added successfully
Notes
ℹ️Areas are containers for seats-create the area first, then add seats to it.
💡Give areas clear names that match what's printed on physical signage at the venue.
Code Samples
Add Area To Venue Layout using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Add Area To Venue Layout
const result = await client.areatovenuelayout.addAreaToVenueLayout('{{ID}}', { /* request body */ });
console.log('Operation completed:', result);