Update Layout Area
PATCH
/venues/{id}/layouts/{layoutId}/areas/{areaId}Update an area's properties within a venue layout.
Change the area name, capacity limits, or general admission settings. This
doesn't affect the individual seats within the area-use the seat endpoints
for that.
When to use this
- Renaming an area to match updated signage
- Adjusting capacity limits for safety compliance
- Converting between reserved seating and general admission
Parameters
idpathrequiredVenue ID
layoutIdpathrequiredLayout ID
areaIdpathrequiredArea ID
Request Body
namestringArea name
descriptionstringArea description
type"unallocated" | "allocated"Area type
status"active" | "inactive"Area status
capacitynumberTotal capacity
displayOrdernumberDisplay order in UI
colorstringHex color
seatsany[]Seats array
x*number
y*number
width*number
height*number
categoryIdstringCategory ID for pricing (especially for GA areas)
Response
Area updated successfully
Notes
ℹ️Changing capacity limits won't affect existing ticket sales for this area.
💡Use clear, venue-specific names that customers will recognise when choosing seats.
Code Samples
Update Venue Layout Area using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Update venuelayoutarea
const updated = await client.venuelayoutarea.update('{{VENUELAYOUTAREA_ID}}', {
name: 'Updated Name',
// Add fields to update
});
console.log(`Updated venuelayoutarea: ${updated.name}`);