Komponente löschen

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

Entfernt die Komponente von der Seite. Der Monitor selbst bleibt unberührt. Schließt die Seite die Monitore des Kunden automatisch ein (includeCustomerMonitors), erscheint ein Monitor dieses Kunden dort auch nach dem Löschen seiner Komponente, sofern er nicht in hiddenMonitors steht.

ZugriffAnkerlink kopieren

Organisations-admin und editor. Ein kundengebundener Nutzer oder API-Token erreicht nur Seiten eines Kunden in seinem Bereich; eine Seite ohne Kunde (customerId: null) beantwortet ihm 403 (forbidden). Eine Seite einer anderen Organisation antwortet 404 (statusPageNotFound). IDs im Pfad nehmen die numerische ID oder die publicId. Die Änderung steht im Audit-Protokoll der Organisation.

Beispiel (cURL)Ankerlink kopieren

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

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

AntwortAnkerlink kopieren

204 No Content ohne Body.

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidIdentifier), wenn eine ID im Pfad weder Zahl noch UUID ist
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden (forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
• 403 Forbidden (statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist
• 404 Not Found (statusPageNotFound), wenn die Status-Seite nicht existiert oder zu einer anderen Organisation gehört
• 404 Not Found (statusPageComponentNotFound), wenn es die Komponente auf dieser Seite nicht gibt