Delete Event

Delete a custom event definition. This page documents the OpenSend-owned API contract for DELETE /events/{identifier}.

DELETE /events/{identifier}

Legacy OpenSend callers may continue to use DELETE /api/events?id={id}. The legacy collection delete form accepts only an event definition ID in the id query parameter.

Authentication

Use an OpenSend API key in the Authorization header. Dashboard session cookies are not API credentials for public API clients.

http

Authorization: Bearer os_YOUR_API_KEY

Identifier

identifier may be either the event definition id or the exact event name. OpenSend resolves it inside the authenticated tenant only. If an identifier looks like a UUID, OpenSend checks event IDs first and then checks event names.

Response

json

{
  "object": "event",
  "id": "41f2a3a9-6cb2-4c94-9ec6-f9be3f0ee4e8",
  "deleted": true
}

Errors

Cross-tenant or missing events return 404 without revealing whether the identifier exists for another tenant.