Delete Incident (Manual only)

Deletes a manually created (status-page) incident. Monitor-generated incidents cannot be deleted.

DELETE /api/incidents/:id

Deletes a manual incident (a status-page announcement created by an admin) together with its timeline updates. Monitor-generated incidents are worker-owned and can never be deleted — the endpoint rejects them with 403 notManualIncident.

Authentication

Requires a valid session with editor/admin rights, scoped to the incident's customer.

Header: Authorization: Bearer <token>

Path Parameters

id (required): The incident's numeric ID or its publicId (UUID).

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X DELETE "$BASE_URL/api/incidents/8d1f0c2e-6a2b-4f1e-9b7c-2e5a1d3c4b5a" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Example Response

{
  "ok": true
}

Common Errors

400 Incident id is required if no ID is supplied
401 Unauthorized if you are not authenticated
403 Forbidden if you do not have write access to the incident's customer
403 Only manual incidents can be deleted (data.code: notManualIncident) if the incident is monitor-generated
404 Incident not found if no incident matches the ID