Operation
Delete Event
DELETE
/events/{id}Delete an event from your organisation. This is a soft delete - the event
is marked as deleted but can potentially be restored by support if needed.
Deleting an event will also delete all associated occurrences and price schemes.
Any sold tickets will need to be handled separately (refunds, etc.).
When to use this
- Removing test events created during development
- Cleaning up duplicate events
- Removing events that were created in error
Path parameters
idstringRequired- Event 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 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
Deleting an event also deletes all its occurrences and price schemes. This cannot be undone via the API.
Important
If tickets have been sold, consider cancelling the event instead of deleting it.
Note
Events with sold tickets may be blocked from deletion. Cancel and refund first.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Delete an eventconst result = await client.events.delete('evt_abc123');if (result.success) { console.log('Event deleted successfully');}Response 200
{
"success": true,
"id": "evt_abc123"
}