Delete timeline entry
Permanently remove a timeline entry from an event.
DELETE /app/events/{id}/timeline/{statusId}
Permanently removes a timeline entry. The event's current status, startTime, endTime, and resolvedAt are not modified — those fields are stored independently of the timeline array. Removing an entry that your users have already seen on the status dashboard will leave a visible gap in the public timeline history.
The status label of a timeline entry cannot be changed after posting. If the wrong label was used, delete the entry and post a new one with the correct label.
Path parameters
| Parameter | Description |
|---|---|
id | The event ID. |
statusId | The timeline entry ID. |
Request
See API Basics for required headers.
This endpoint takes no request body.
Sample request
curl -X DELETE https://api.statusdashboard.com/app/events/4f8b2e1a-3c7d-4e9f-a0b1-c2d3e4f56789/timeline/7a3f9d2e-1b4c-4e8a-90b2-c3d4e5f67890 \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
403 | Insufficient permissions. |
404 | Event or timeline entry not found. |

