Operation
Delete Event Occurrence
DELETE
/events/{eventId}/occurrences/{occurrenceId}Remove an occurrence from an event.
This permanently deletes the occurrence. If tickets have been sold for this
occurrence, you'll need to handle refunds separately.
For shows that are cancelled but need to keep records, consider updating the
status to "cancelled" instead of deleting.
When to use this
- Removing a show that was added by mistake
- Cleaning up draft occurrences that won't happen
- Deleting test data
Path parameters
eventIdstringRequired- Event ID
occurrenceIdstringRequired- Occurrence 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
Event occurrence 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 is permanent and cannot be undone. If tickets have been sold, consider cancelling instead of deleting.
Note
Deleting an occurrence doesn't automatically refund tickets-handle refunds through the orders API.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Delete eventoccurrenceawait client.eventoccurrence.delete('{{EVENTOCCURRENCE_ID}}');console.log('EventOccurrence deleted successfully');Response 200
{
"success": true,
"id": "evoc_abc123"
}