Delete Status Page Incident

Remove an incident from a status page

Overview

Permanently removes an incident post from a status page, together with its timeline. To close an incident and keep its history, use Resolve Status Page Incident instead.

DELETE /api/projects/{projectId}/status-pages/{statusPageId}/incidents/{id}

Authentication

Header	Required	Description
X-API-Key	Yes	Your API key (Authorization: Bearer {jwt} also works). API keys need the read_write scope.

Required access: project admin. No X-Project-ID header is needed.

Path parameters

Parameter	Type	Description
projectId	UUID	The project
statusPageId	UUID	The status page
id	UUID	The incident

Response

200 OK

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Errors

Status	Code	Cause
401	AUTHENTICATION_REQUIRED	Missing or invalid credentials, or the caller is not a project admin (message Access denied)
403	API_KEY_ORGANIZATION_MISMATCH	The API key belongs to a different organization than the project
403	READ_ONLY_API_KEY	The API key has the read scope
404	RESOURCE_NOT_FOUND	The status page or incident does not exist, or the incident belongs to a different status page

Example

cURL

curl -X DELETE https://api.uptimeio.com/api/projects/YOUR_PROJECT_ID/status-pages/YOUR_STATUS_PAGE_ID/incidents/YOUR_INCIDENT_ID \
  -H "X-API-Key: YOUR_API_KEY"