This is a destructive action. Deleting an event will also remove all associated ticket tiers, orders, and tickets. This action cannot be undone.
This endpoint requires authentication. Only the event organizer can delete their events.
Authentication
Include the JWT token in the Authorization header:
Authorization: Bearer YOUR_JWT_TOKEN
Path Parameters
The unique identifier of the event to delete
Response
The ID of the deleted event
curl -X DELETE https://api.gatepass.app/api/events/clx1234567890abcdef \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
{
"message": "Event successfully deleted",
"deletedEventId": "clx1234567890abcdef"
}
Business Rules
Deletion Restrictions
Events cannot be deleted if:
- There are confirmed ticket sales (orders with
COMPLETED payment status)
- Tickets have been minted on the blockchain
- The event has already occurred
In these cases, you should update the event status to CANCELLED instead of deleting it.
Alternative: Cancel Event
Instead of deleting an event with existing sales, update the status to CANCELLED:
curl -X PUT https://api.gatepass.app/api/events/clx1234567890abcdef \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"status": "CANCELLED"}'
This preserves the event record and all associated data while preventing new ticket sales.