Uptimeify Docs

Change Request anlegen

Eröffnet einen Change Request gegen einen beliebigen Monitor (alle Monitor-Typen).

POST /api/monitors/:monitorType/:monitorId/change-requests

Lesezugriff auf den Monitor genügt — der typische Aufrufer ist ein Kundenportal-Nutzer, der auf einem managed-Monitor keinen Schreibzugriff hat.

Pfad-Parameter

ParameterBeschreibung
monitorTypeEiner von website, dns, icmp, smtp, ssh, ftp, imap_pop, domain, dnsbl
monitorIdNumerische ID des Monitors

Request Body

FeldTypPflichtStandardBeschreibung
kindstringNeinchangechange (Freitext-Wunsch) oder request_managed (die Org bitten, den Monitor zu übernehmen)
messagestringJaDer Anfragetext (1–2000 Zeichen)

Beispiel (cURL)

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

curl -X POST "$BASE_URL/api/monitors/website/103/change-requests" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "change",
    "message": "Bitte das Check-Intervall auf 1 Minute senken."
  }'

Response

{
  "id": 12,
  "status": "open"
}

Häufige Fehler

  • 400 Invalid monitor type (invalidMonitorType), wenn monitorType keiner der unterstützten Typen ist
  • 400 Invalid monitor identifier, wenn monitorId keine positive Ganzzahl ist
  • 401 Unauthorized, wenn du nicht angemeldet bist
  • 403 Forbidden / 404 Not found, wenn der Monitor außerhalb deines Scopes liegt
  • 429 Too many open requests (tooManyOpenRequests), wenn der Kunde bereits 10 offene Anfragen hat

Auf dieser Seite