Skip to main content
DELETE
https://app.cometly.com
/
public-api
/
v1
/
events
/
{event_id}
Delete Event
curl --request DELETE \
  --url https://app.cometly.com/public-api/v1/events/{event_id} \
  --header 'Authorization: Bearer <token>'
{
  "status": 123,
  "message": "<string>"
}

​
Overview

This endpoint allows you to delete a previously created event from Cometly. Once deleted, the event data will be removed from your tracking and reporting. This endpoint implements idempotent delete behavior - attempting to delete an event that doesn’t exist will still return a success response (200).

​
Path Parameters

​
event_id
string
required
The unique identifier of the event to delete

​
Response

​
Success Response

​
status
number
HTTP status code (200)
​
message
string
Success message confirming the event was deleted

​
Error Response

​
message
string
Error description explaining what went wrong

​
Example Requests

curl -X DELETE https://app.cometly.com/public-api/v1/events/evt_123456 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

​
Status Codes

Status CodeDescription
200Event successfully deleted (or already doesn’t exist)
401Missing or invalid API key
403API key doesn’t have permission or subscription is inactive
422Invalid event ID provided
429Too many requests - rate limit exceeded. See Rate Limiting

​
Notes

  • Rate Limit: This endpoint has a limit of 60 requests per minute per Space. See Rate Limiting for details.
Deleting an event is permanent and cannot be undone. Make sure you have the correct event ID before deleting.