Website aktualisieren

PATCH /api/websites/:websitePublicId

Eine Anfrage gilt als Voll-Update, sobald customerId, name und url alle drei im Körper stehen. Sonst ist es ein Teil-Update.

Beispiel (cURL): Teil-UpdateAnkerlink kopieren

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

curl -X PATCH "$BASE_URL/api/websites/9a3d4d4d-7a4b-4f37-a9df-2a6f6d9d7a10" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Aktualisierter Name",
    "checkInterval": 5,
    "timeoutSeconds": 10
  }'

Beispiel (cURL): Voll-Update mit HTTP-KonfigurationAnkerlink kopieren

curl -X PATCH "$BASE_URL/api/websites/9a3d4d4d-7a4b-4f37-a9df-2a6f6d9d7a10" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "customerId": 5,
    "name": "API Endpoint Monitor",
    "url": "https://api.deinkunde.com/health",
    "httpMethod": "POST",
    "customHeaders": { "X-API-Key": "abc123", "Content-Type": "application/json" },
    "requestBody": "{\"check\": true}",
    "followRedirects": false,
    "cookieHandling": "jar",
    "mtlsEnabled": true,
    "mtlsClientCert": "<PEM-kodiertes Client-Zertifikat>",
    "mtlsClientKey": "<PEM-kodierter privater Schluessel>"
  }'

Anfrage (Request Body)Ankerlink kopieren

Für ein Voll-Update sind customerId, name und url Pflicht; jedes weitere Feld ist optional.

Ein Teil-Update übernimmt diese Felder: name, url, status, managementType, checkInterval, timeoutSeconds, expectedStatusCodes, searchTerm, checkExpectedResponseEnabled, expectedResponseMatchType, expectedResponseValue, expectedResponseJsonPath, heartbeatGracePeriodMinutes, connectHost, connectPort, connectTlsInsecure, die sechs Prüf-Felder, checkDomainExpiryEnabled, sslNoticeDays, sslErrorDays, domainExpiryNoticeDays, domainExpiryErrorDays, minPageSize und maxPageSize. Alles andere aus den Tabellen unten (monitoringType, allowedCheckCountryCodes, customFields, die Felder für Authentifizierung, HTTP-Anfrage, mTLS und Playwright sowie dnsConfig) greift nur im Voll-Update: allein geschickt bleibt es ohne Fehlermeldung wirkungslos. Schick customerId, name und url mit, oder nimm den jeweiligen eigenen Endpunkt, wo es einen gibt.

KernfelderAnkerlink kopieren

AuthentifizierungAnkerlink kopieren

HTTP-Anfrage konfigurierenAnkerlink kopieren

QUERY ist sicher und idempotent wie GET, trägt aber einen Anfragekörper. Den Hintergrund dazu erklärt Website erstellen.

ErsatzzielAnkerlink kopieren

Gilt im Teil-Update genauso wie im Voll-Update. Nicht verfügbar für playwright-Szenarien und heartbeat-Monitore: beide durchlaufen nicht die HTTP/SSL-Prüfkette, in die connectHost eingreift. Ist checkHttpsRedirectEnabled eingeschaltet, folgt auch die Umleitungsprüfung von http auf https dem connectHost und misst damit den Origin - eine von der WAF übernommene Umleitung kann den Monitor dann zu Recht rot werden lassen, obwohl die öffentliche Seite korrekt umleitet.

mTLS (gegenseitiges TLS)Ankerlink kopieren

Playwright-MonitoringAnkerlink kopieren

Erwartete Antwort prüfenAnkerlink kopieren

Prüfungen ein- und ausschaltenAnkerlink kopieren

Ein im Request fehlendes Prüf-Feld lässt den gespeicherten Wert unverändert. Das Paket der Organisation kann eine Prüfung verbieten: ein true für eine verbotene Prüfung wird nur dann auf false zurückgeklemmt, wenn die Prüfung noch nicht läuft; eine bereits als true gespeicherte Prüfung schaltet das Paket bei diesem oder jedem späteren Update nie ab.

Schwellen für Zertifikat und DomainAnkerlink kopieren

Seitengröße und SonstigesAnkerlink kopieren

Antwort (Response)Ankerlink kopieren

Gibt den aktualisierten Website-Datensatz zurück. Die verschlüsselt gespeicherten Felder gibt die API grundsätzlich nicht heraus.

{
  "id": 101,
  "customerId": 1,
  "name": "Aktualisierter Name",
  "url": "https://deinkunde.com",
  "status": "active",
  "monitoringType": "combined",
  "checkInterval": 5,
  "timeoutSeconds": 10,
  "httpMethod": "POST",
  "followRedirects": false,
  "cookieHandling": "jar",
  "mtlsEnabled": true,
  "connectHost": null,
  "connectPort": null,
  "connectTlsInsecure": false,
  "updatedAt": "2026-02-26T12:34:56.000Z"
}

Häufige FehlerAnkerlink kopieren

• 400 Website public ID (UUID) is required, wenn :websitePublicId fehlt
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden, wenn du auf die Website nicht schreiben darfst (etwa als Readonly- oder globaler Supporter-Zugang)
• 403 Forbidden (managed_by_organization), wenn ein kunden-gescopter Aufrufer einen managed-Monitor ohne die Ausnahme canEditManaged bearbeitet
• 403 Forbidden (managementTypeOrgOnly), wenn jemand ohne Org-Admin-Rechte managementType ändern will
• 403 Forbidden (selfServiceQuotaReached), wenn das Umstellen auf self_service das Kontingent des Kunden überschreiten würde
• 404 Customer not found, wenn sich customerId keinem bestehenden Kunden zuordnen lässt
• 400 Invalid check configuration (invalidCheckConfig), wenn ein Teil-Update ein Prüf-Feld ausserhalb seiner Grenzen schickt (etwa sslNoticeDays: 400)
• 400 Bad Request (connectHostInvalid), wenn connectHost kein gültiger Host ist oder Protokoll bzw. Pfad enthält
• 400 Bad Request (connectHostNotPublic), wenn connectHost auf eine private, Loopback-, Link-Local- oder sonst gesperrte Adresse auflöst
• 400 Bad Request (connectTlsInsecureWithoutHost), wenn das sich ergebende connectTlsInsecure true ist, während das sich ergebende connectHost leer bleibt
• 500 Failed to update website bei Serverfehlern