Delete Status Page

Delete a status page and take its public URL offline

Overview

Deletes a status page. The page’s public URL stops working immediately, its subdomain becomes available again, and the page no longer counts against your plan’s status page limit. Deleted pages cannot be restored through the API.

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

Authentication

Header	Required	Description
X-API-Key	Yes	Your API key (Authorization: Bearer {jwt} also works). API keys need the read_write scope.
X-Project-ID	Yes	Must be the same project UUID as in the URL.

Required access: project admin.

Path parameters

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

Response

200 OK

{
  "success": true,
  "data": {
    "message": "Status page deleted successfully"
  }
}

Deleting a status page does not delete its monitors or their incidents.

Errors

Status	Code	Cause
400	PROJECT_ID_REQUIRED / INVALID_PROJECT_ID	X-Project-ID header missing or not a UUID
401	AUTHENTICATION_REQUIRED	Missing or invalid credentials
403	INSUFFICIENT_PERMISSIONS	Caller is not a project admin
403	ACCESS_DENIED	The page belongs to another project
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 does not exist or is already deleted

Example

cURL

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