Bericht löschen

DELETE /api/organization/reports/:id

Löscht eine Berichtskonfiguration. :id ist die id des Berichts (eine UUID). Die Organisation wird aus Ihrer authentifizierten Sitzung oder Ihrem API-Token abgeleitet, und der Bericht muss zu ihr gehören. Erfordert die Rolle admin der Organisation (API-Tokens gelten als Organisations-Admins). Nur-Lese-Benutzer können keine Berichte löschen.

Dadurch werden künftige geplante Läufe des Berichts gestoppt. Bereits erzeugte Bericht-Läufe für diesen Bericht bleiben davon unberührt und weiterhin abrufbar.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<ihr-api-token>"
REPORT_ID="3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90"

curl -X DELETE "$BASE_URL/api/organization/reports/$REPORT_ID" \
  -H "Authorization: Bearer $TOKEN"

Antwort

{ "success": true }

Häufige Fehler

• 401 Unauthorized — nicht authentifiziert.
• 403 Forbidden (forbidden) — kein Organisations-Admin.
• 404 Not Found (notFound) — es existiert kein Bericht mit dieser ID für Ihre Organisation.