Update Event Occurrence
PATCH
/events/{eventId}/occurrences/{occurrenceId}Change the details of an existing occurrence.
Need to reschedule a show? Adjust capacity? Change the doors-open time? This
endpoint lets you update any aspect of an occurrence.
Only the fields you include in the request will be updated-everything else
stays the same.
When to use this
- Rescheduling a show to a different time
- Adjusting capacity based on venue changes
- Updating status (e.g., marking as sold out)
Parameters
eventIdpathrequiredEvent ID
occurrenceIdpathrequiredOccurrence ID
Request Body
startDatestring (date-time)Start date (ISO date)
startTimestringStart time (HH:mm:ss)
endDatestring (date-time)End date (ISO date)
endTimestringEnd time (HH:mm:ss)
timezonestringOccurrence timezone
venueIdstringnullVenue ID
venueLayoutIdstringnullVenue layout ID
ticketSchemeIdstringnullTicket scheme to use for this occurrence
priceSchemeIdstringnullPrice scheme to use (must belong to the ticket scheme)
categoryMappingarraynullCategory mapping for template mode ticket schemes
status"draft" | "on_sale" | "sold_out" | "completed" | "cancelled"Occurrence status
Response
Event occurrence updated successfully
Notes
⚠️Changing the date or time of an occurrence with existing bookings may confuse customers. Consider communicating changes proactively.
💡Use PATCH semantics-only send the fields you want to change.
Code Samples
Update Event Occurrence using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Update eventoccurrence
const updated = await client.eventoccurrence.update('{{EVENTOCCURRENCE_ID}}', {
name: 'Updated Name',
// Add fields to update
});
console.log(`Updated eventoccurrence: ${updated.name}`);