API · Events
Delete Event
Delete an event definition by ID or name (requires full access). Related cleanup may finish after the response.
DELETE
/events/{id}Full accessRequest parameters
| Parameter | Type | Description |
|---|---|---|
idpath · required | string | Event id or name. |
Request example
Set OPENSEND_BASE_URL=https://api.example.com and OPENSEND_API_KEY=os_replace_me on your server.
bash
curl -X DELETE "$OPENSEND_BASE_URL/events/YOUR_id" \
-H "Authorization: Bearer $OPENSEND_API_KEY"Response
200 · application/json. Example IDs stand for IDs returned by your installation.
json
{
"object": "event",
"id": "YOUR_ID",
"deleted": true
}Behavior and errors
Names beginning with opensend: are reserved. This manages custom event definitions, not webhook subscriptions.
Use a full-access credential. Resource IDs belong to your team; an unknown or foreign resource returns 404. See authentication, errors, rate limits, and compatibility for the shared contract.