Delete Incident (Manual only)

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
• 400 Invalid Incident identifier if the ID is neither a numeric incident id nor a UUID
• 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