Delete Status Page Component

DELETE /api/status-pages/{id}/components/{componentId}

Removes the component from the page. The monitor itself is not touched. If the page includes the customer's monitors automatically (includeCustomerMonitors), a monitor of that customer still appears there after its component is deleted, unless it is in hiddenMonitors.

AccessCopy Anchor Link

Organization admin and editor. A customer-scoped user or API token only reaches pages of a customer in its scope; a page without a customer (customerId: null) answers it with 403 (forbidden). A page of another organization answers 404 (statusPageNotFound). Path ids take the numeric id or the publicId. The change is written to the organization's audit log.

Example (cURL)Copy Anchor Link

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

curl -X DELETE "$BASE_URL/api/status-pages/1/components/8" \
  -H "Authorization: Bearer $TOKEN"

ResponseCopy Anchor Link

204 No Content without a body.

Common errorsCopy Anchor Link

• 400 Bad Request (invalidIdentifier) when an id in the path is neither a number nor a UUID
• 401 Unauthorized when you are not logged in
• 403 Forbidden (forbidden) when your role may not do this, or for a customer-scoped caller on a page without a customer or of another customer
• 403 Forbidden (statusPagesModuleDisabled) when the status pages module is not activated
• 404 Not Found (statusPageNotFound) when the status page does not exist or belongs to another organization
• 404 Not Found (statusPageComponentNotFound) when the component does not exist on this page