Operation
Bulk Add Seats
POST
/venues/{id}/layouts/{layoutId}/areas/{areaId}/seats/bulkAdd multiple seats to an area in a single request.
Pass an array of seat definitions and create them all at once. This is much
faster than making individual API calls for each seat.
Use this when you have a list of seats to import from another system or when
the auto-generate function doesn't fit your seating layout.
When to use this
- Importing seats from a CSV or spreadsheet
- Migrating from another ticketing system
- Creating complex seating arrangements
Path parameters
idstringRequired- Venue ID
layoutIdstringRequired- Layout ID
areaIdstringRequired- Area ID
Headers
Idempotency-KeystringOptional- Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.
Body
sectionstringSection identifier
row*stringRow identifier
number*stringSeat number
labelstringDisplay label (auto-generated if not provided)
categoryIdstringCategory ID for pricing
status"available" | "blocked" | "accessible" | "held" | "removed"Seat status
holdTypestringHold type if status is held
attributes"aisle_left" | "aisle_right" | "accessible" | "wheelchair_space" | "companion_seat" | "easy_access" | "obstructed_view" | "restricted_view" | "excellent_view" | "stage_view" | "extra_legroom" | "premium_comfort" | "front_row" | "back_row" | "center"[]Seat attributes
companionSeatsstring[]IDs of companion seats (for wheelchair spaces)
companionTostringID of wheelchair space this is companion to
internalNotesstringInternal notes
publicNotesstringPublic notes shown to customers
Returns
Seats added successfully
Errors
- 400
- Bad Request - Invalid input
- 401
- Unauthorized - Authentication required
- 403
- Forbidden - Insufficient permissions
- 404
- Not Found - Resource not found
- 500
- Internal Server Error
Every error names its code and links to it. All error codes
Notes
Note
Maximum 500 seats per request for performance reasons.
Tip
For standard row-based seating, generateSeatsForArea is usually easier.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Bulk Add Seats To Areaconst result = await client.addseatstoarea.bulkAddSeatsToArea('{{ID}}', { /* request body */ });console.log('Operation completed:', result);Response 201
{
"seatsAdded": 50
}