Operation
Delete Layout Area
DELETE
/venues/{id}/layouts/{layoutId}/areas/{areaId}Remove an area from a venue layout.
This permanently deletes the area and all seats within it. You can't delete
an area if there are active events using this layout with tickets sold for
seats in this area.
If you need to temporarily remove an area from sale, consider updating its
status instead of deleting it.
When to use this
- Removing a section that's been permanently closed
- Cleaning up test areas during layout setup
- Restructuring a venue layout
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.
Returns
Area deleted 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
Important
This deletes all seats in the area. Make sure no events are using these seats.
Tip
Consider hiding the area from sale instead of deleting if you might need it later.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Delete venuelayoutareaawait client.venuelayoutarea.delete('{{VENUELAYOUTAREA_ID}}');console.log('VenueLayoutArea deleted successfully');Response 200
{
"success": true
}