---
title: "Delete Incident (Manual only)"
description: "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)

```bash
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

```json
{
  "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