Skip to Content
Uptimeify Docs

Fehlerliste und bekannte API-Fallen

Diese Seite dokumentiert reale Fehlerbilder, die bei Integrationen aufgetreten sind.

Schema

Error CodeGrundLösung / Bug
404 Website not foundEinige Website-Unterendpunkte haben früher nur die alte numerische Website-ID akzeptiert, obwohl die Docs websitePublicId gezeigt haben.Behoben. GET /api/websites/:websitePublicId/check-history und GET /api/websites/:websitePublicId/uptime-stats akzeptieren jetzt Public IDs und weiterhin Legacy-IDs.
403 Forbidden auf GET /api/organizations/:organizationPublicIdDie Route hat die Pfad-ID früher direkt als Zahl interpretiert. Eine UUID wurde dadurch schon in der Berechtigungsprüfung verworfen.Behoben. Die Organisations-Detail- und Billing-Routen lösen jetzt publicId korrekt auf.
400 Bad Request mit ZodError bei customer-ips oder customer-domainsQuery-Parameter wie organizationId=, page= oder perPage= wurden als leere Strings gesendet. Zod coerct leere Strings zu 0, was dann an den Mindestwerten scheitert.Behoben für organizationId, page und perPage. Optional bedeutet trotzdem: ungenutzte Parameter komplett weglassen statt leere Strings zu senden.

Betroffene Fälle

Website not found bei Website-Monitoring-Endpunkten

Betroffene Endpunkte:

  • GET /api/websites/:websitePublicId/check-history
  • GET /api/websites/:websitePublicId/uptime-stats

Früherer Effekt:

{
  "error": true,
  "statusCode": 404,
  "statusMessage": "Website not found",
  "message": "Website not found"
}

Grund:

  • Die Route hat nur die alte numerische id direkt geparsed.
  • Eine UUID wurde nicht in die interne numerische ID aufgelöst.

Aktueller Stand:

  • Public IDs funktionieren jetzt wie in der Doku beschrieben.
  • Legacy-Integer-IDs bleiben aus Kompatibilitätsgründen gültig.

Forbidden bei Organisations-Details mit Public ID

Betroffener Endpoint:

  • GET /api/organizations/:organizationPublicId

Grund:

  • Die Berechtigungsprüfung lief früher gegen Number(id).
  • Bei einer UUID wurde daraus NaN, was zu 403 Forbidden führte.

Aktueller Stand:

  • Die Route und die Billing-Routen lösen organizationPublicId jetzt korrekt in die interne ID auf.

ZodError bei optionalen Listen-Parametern

Betroffene Endpunkte:

  • GET /api/customer-ips
  • GET /api/customer-domains

Typisches Muster:

{
  "error": true,
  "statusCode": 400,
  "statusMessage": "Bad Request"
}

Grund:

  • Nicht das Weglassen der Parameter war das Problem.
  • Das Problem waren leere Query-Werte wie ?page=&perPage=.

Lösung:

  • Unbenutzte optionale Parameter weglassen.
  • Die API ignoriert für diese Felder jetzt leere Strings robuster.

Monitor-Ownership-Fehlercodes

Seit dem Managed-vs.-Self-Service-Modell können Monitor-Schreib-Endpunkte aller Typen (Website, DNS, ICMP, SMTP, SSH, FTP, IMAP/POP, Domain, DNSBL) diese 403-Codes in data.code liefern:

CodeBedeutung
managed_by_organizationEin kunden-gescopter Aufrufer wollte einen managed-Monitor ohne die canEditManaged-Ausnahme bearbeiten/löschen. Stattdessen einen Change Request eröffnen. Gilt auch für eine managed-Statusseite und was an ihr hängt (Einstellungen, Komponenten, Gruppen, Domain, Abonnenten, Vorfälle und Wartungen auf der Seite), für kundengebundene Nutzer mit jeder Rolle (auch readonly und editor) und kundengebundene Tokens; stattdessen mit Änderungsanfrage zu einer Statusseite anlegen fragen.
selfServiceNotAllowedEin kunden-gescopter Aufrufer wollte einen Monitor anlegen, aber das aufgelöste allowSelfService des Kunden ist false.
selfServiceQuotaReachedDas Anlegen (oder Umstellen auf) eines self_service-Monitors würde maxSelfServiceUrls des Kunden überschreiten: das Kontingent zählt alle Monitor-Typen zusammen.
managementTypeOrgOnlyEin Nicht-Org-Admin wollte den managementType eines Monitors ändern. Klassen-Wechsel sind Organisations-Admins vorbehalten, und seit dem 04.09.2026 gilt das auch gegenüber kunden-gescopten API-Tokens: Ein solcher Token führt zwar eine Admin-Rolle, aber einen eingeschränkten Scope, und der Wechsel verlangt jetzt einen uneingeschränkten.
readonlyMayNotDeleteEin Aufrufer mit der Rolle readonly wollte einen Monitor löschen. Löschen ist dieser Rolle bei jeder Besitzklasse verwehrt, auch bei self_service, und ein von einem Nur-Lese-Zugang ausgestellter API-Token erbt die Sperre. Das Bearbeiten eines self_service-Monitors bleibt erlaubt.
tooManyOpenRequests(429) Der Kunde hat bereits 10 offene Change Requests.

Monitorkontingent-Fehlercodes

Eine Organisation hat ein Monitorkontingent. Ist es erschöpft, scheitert das Anlegen eines Monitors - oder es hebt die Organisation auf die nächste Kontingentstufe, wenn sie selbst hochstuft. Diese Stufe hat einen höheren Monatspreis, und die Differenz wird für den Rest des laufenden Zeitraums abgerechnet.

CodeBedeutung
monitorQuotaReached(403) Die Organisation steht an ihrem Monitorkontingent und stuft NICHT selbst hoch. Einen Monitor freigeben oder das Kontingent anheben.
monitorQuotaNoHigherTier(403) Die Organisation steht am Kontingent, stuft selbst hoch und ist bereits auf der höchsten vorgesehenen Stufe. Support ansprechen.
paidQuotaUpgradeNotAuthorized(403) Der Aufruf hätte eine KOSTENPFLICHTIGE Hochstufung ausgelöst und hat sie nicht erlaubt. Das kann nur ueber eine Agentenverbindung (MCP) passieren: ein Mensch im Dashboard sieht Stufe und Preis, ein Modell nicht - deshalb startet eine Abrechnungswirkung abgewählt. Die Meldung nennt Stufe und Monatspreis, die der Aufruf gekauft hätte. Sende allowPaidQuotaUpgrade: true, sobald ein Mensch der höheren Rechnung zugestimmt hat, oder gib vorher einen Monitor frei. Jeder andere Aufrufer, auch ein API-Token, bleibt unberührt und sieht diesen Code nie.

Kundenpaket-Fehlercodes

POST /api/customers und PATCH /api/customers/:customerPublicId lösen das Paket eines Kunden auf. Beide weisen ein Paket zurück, das die Organisation nicht hat:

CodeBedeutung
invalidPackageType(400) Die packageId gehört nicht zu dieser Organisation, oder der Legacy-packageType passte weder auf einen konfigurierten Paketschlüssel noch auf einen Paket-Anzeigenamen dieser Organisation.

PATCH hat einen unbekannten packageType früher unverändert gespeichert und packageId leer gelassen. Ein solcher Kunde hing an gar keiner Paketkonfiguration, wodurch sich seine Datenaufbewahrung nicht auflösen liess. Sende packageId oder einen packageType, den die Organisation hat.

Fehlercodes beim Kundenlöschen und bei der Kundenzuordnung

CodeBedeutung
invalidUserAction(400) DELETE /api/customers/:customerPublicId (Query userAction) oder POST /api/customers/bulk mit action: "delete" (payload.userAction): der Wert ist weder deactivate noch delete. Nutzer, die nur dem gelöschten Kunden zugeordnet sind, werden immer deaktiviert oder gelöscht; sie zu behalten, ist nicht vorgesehen. Bei diesem Fehler wird nichts gelöscht.
customerUserDeleteAdminOnly(403) DELETE /api/customers/:customerPublicId mit userAction=delete oder POST /api/customers/bulk mit action: "delete" und payload.userAction: "delete", gesendet von einem Editor. Seit 04.11.2026 dürfen Editoren Kunden löschen, Nutzerkonten löschen bleibt aber Sache der Organisations-Admins. Nutze die Voreinstellung deactivate. Es wird nichts gelöscht.
cannotDeleteOwnLastCustomer(409) Ein Editor mit Kundenzuordnung würde mit DELETE /api/customers/:customerPublicId oder POST /api/customers/bulk (action: "delete") seinen letzten Kunden löschen. Er stünde danach ohne Kunden da und würde sein eigenes Konto deaktivieren. Wende dich an einen Organisations-Admin. Die Bulk-Anfrage wird als Ganzes abgelehnt; es wird kein Kunde gelöscht.
customerIdsReadonlyOnly(400) POST /api/users: eine nicht leere customerIds-Liste wurde mit einer anderen Rolle als readonly gesendet. Nur Nur-Lesen-Nutzer werden Kunden zugeordnet. Vor dem 06.10.2026 wurde die Liste still ignoriert, und der Nutzer bekam Zugriff auf die ganze Organisation.

Fehlercodes fürs Website-Prüfintervall

checkInterval hat je nach Monitor-Art eine andere Obergrenze, weil der Wert zweierlei bedeutet: bei aktiv getakteten Monitoren ist er die Abfragefrequenz und bleibt bei 1 bis 1440 Minuten (24 Stunden), bei heartbeat-Monitoren ist er das erwartete Ping-Intervall und reicht von 1 bis 43200 Minuten (30 Tage), ein monatlicher Cron-Job ist ein legitimer Monitor.

CodeBedeutung
checkIntervalTooLow(400) POST /api/websites: checkInterval liegt unter dem Minimum, das das Kundenpaket erlaubt. Die statusMessage nennt das Minimum.
checkIntervalTooHigh(400) PATCH /api/websites/:id: checkInterval überschreitet die Obergrenze der Monitor-Art. Die Art kommt aus monitoringType, wenn der Request es mitschickt, sonst vom gespeicherten Monitor, ein Intervall über 1440 auf einem Nicht-Heartbeat wird also auch dann abgewiesen, wenn monitoringType fehlt.
invalidCheckInterval(400) PATCH /api/websites/:id (Teil-Update ohne customerId, name und url): checkInterval ist keine ganze Zahl zwischen 1 und der Obergrenze der Art. Das Paketminimum gilt auch hier und antwortet mit checkIntervalTooLow.
invalidTimeout(400) PATCH /api/websites/:id (Teil-Update): timeoutSeconds ist keine ganze Zahl zwischen 1 und 60.
invalidCheckConfig(400) PATCH /api/websites/:id (Teil-Update): ein Prüf-Feld liegt ausserhalb seiner Grenzen, etwa sslNoticeDays über 365 oder minPageSize unter 0. Die sechs Prüf-Felder, checkDomainExpiryEnabled, die SSL- und Domain-Ablauf-Schwellen und die Seitengrössen übernimmt auch das Teil-Update; die Paketregeln gelten dabei genauso wie im Voll-Update.
checkNotInPackage(403) POST /api/websites, PATCH /api/websites/:id und PATCH /api/websites/:id/check-config: ein ausdrückliches true würde eine der sechs Prüfungen anschalten, die das Paket des Kunden verbietet. data.check nennt das Feld. Eine schon laufende (oder nie gesetzte) Prüfung darf weiter als true kommen; ein weggelassenes Feld richtet seine Voreinstellung weiter ohne Fehler nach dem Paket. Vor dem 22.10.2026 wurde die Prüfung still als false gespeichert.
checkRequiresValue(400) Dieselben Endpunkte: checkKeywordEnabled: true ohne nicht-leeren searchTerm (data.field: searchTerm) oder checkSizeEnabled: true ohne minPageSize und maxPageSize (data.field: minPageSize), bei einer Prüfung, die noch nicht läuft. data.check nennt die Prüfung. Ein PATCH nimmt den Wert aus dem Body, sonst den gespeicherten. Eine vom Paket verbotene Prüfung antwortet zuerst mit checkNotInPackage. Vor dem 22.10.2026 wurde die Prüfung still als false gespeichert.
invalidUrl(400) PATCH /api/websites/:id (Teil-Update): url zeigt auf eine private, Loopback-, Link-Local- oder sonst nicht öffentliche Adresse. Dieselbe Prüfung wie bei POST /api/websites. heartbeatToken wird auf diesem Pfad ignoriert; das Token entsteht nur serverseitig.

POST /api/websites meldet dieselbe Obergrenze als Validierungsfehler auf dem Pfad checkInterval statt als data.code, weil die Art dort schon aus dem Request-Body feststeht.

Fehlercodes fürs Ersatzziel (connect target)

connectHost, connectPort und connectTlsInsecure verbinden die Prüfung mit einem anderen Host als dem aus url, während url, der Host-Header und das TLS-SNI unverändert bleiben - die Semantik von curl --resolve. Sowohl POST /api/websites als auch PATCH /api/websites/:id (Teil-Update eingeschlossen) prüfen sie gleich.

CodeBedeutung
connectHostInvalid(400) connectHost liess sich nicht einlesen: es trägt ein Protokoll oder einen Pfad, enthält Leerzeichen, hat eine IPv6-Adresse ohne eckige Klammern, oder sein Port ist keine Zahl zwischen 1 und 65535.
connectHostNotPublic(400) connectHost löst auf eine private, Loopback-, Link-Local- oder sonst gesperrte Adresse auf - dieselbe SSRF-Sperre wie bei url.
connectTlsInsecureWithoutHost(400) connectTlsInsecure wurde als true gesendet, während das sich ergebende connectHost leer ist. Beim PATCH greift das auch, wenn ein Request connectHost löscht (null), aber trotzdem connectTlsInsecure: true mitschickt.

Nicht verfügbar für playwright-Szenarien und heartbeat-Monitore: beide durchlaufen nicht die HTTP/SSL-Prüfkette, in die connectHost eingreift - die Felder werden bei diesen Monitor-Arten angenommen, wirken sich aber nicht aus.

Check-Mode-Fehlercodes (SSH-/SMTP-/FTP-/IMAP-POP-Monitore)

Die Monitor-Typen mit Zugangsdaten (SSH, SMTP, FTP, IMAP/POP) unterstützen ein Feld checkMode (protocol | tcp, Standard protocol). Im Modus tcp führt der Monitor nur eine reine TCP-Port-Erreichbarkeitsprüfung durch, Zugangsdaten sind weder erforderlich noch werden sie gespeichert. Die Create- und Update-Endpunkte dieser vier Typen können diese 400-Codes in data.code liefern:

CodeBedeutung
portRequiredForTcpIMAP/POP Create oder Update: checkMode ist (oder ergibt sich zu) tcp, aber es ist weder im Request noch bereits am Monitor gespeichert ein port vorhanden. Nur IMAP/POP benötigt für den Modus tcp einen expliziten port. SSH, SMTP und FTP nutzen dafür ihren protokollspezifischen Default-Port.
invalidCheckModeNur bei Update-Endpunkten (PATCH): checkMode wurde übergeben, ist aber weder protocol noch tcp.

Incident-Fehlercodes

Nur manuelle (Statusseiten-)Incidents können gelöscht werden. DELETE /api/incidents/:id liefert diesen data.code:

CodeBedeutung
notManualIncident(403) Der Incident wurde vom Monitoring erzeugt. Nur von einem Admin erstellte manuelle Incidents können gelöscht werden; automatische Incidents gehören den Workern und sind über die API niemals löschbar.

Fehlercodes für Wartungsfenster

POST /api/maintenance-windows/preview-occurrences (Doku) kann diesen data.code liefern:

CodeBedeutung
invalidWindow(400) endTime liegt nicht nach startTime.

Anlegen, Ändern und Löschen eines Fensters (POST /api/maintenance-windows, PATCH /api/maintenance-windows/{id}, DELETE /api/maintenance-windows/{id}) können diese liefern:

CodeBedeutung
endTimeBeforeStartTime(400, anlegen und ändern) endTime liegt nicht nach startTime. Dieselbe Bedingung, die der Vorschau-Endpunkt mit invalidWindow beantwortet; die beiden Codes sind verschieden, also auf beide verzweigen.
missingTargetId(400, anlegen) Die Anfrage nennt eine Zielart, aber keine Id dazu. Ein Fenster braucht mindestens einen Monitor, einen Kunden, eine Kunden-IP oder eine Kundendomain, die es abdeckt.
maintenanceWindowNotFound(404, ändern und löschen) Es gibt kein Fenster dieser Id, das dieser Aufrufer sehen darf. Ausserhalb des Geltungsbereichs und nicht vorhanden sind absichtlich dieselbe Antwort.
customerNotFound, customerIpNotFound, customerDomainNotFound(404, anlegen) Das genannte Ziel liegt in keiner Organisation, die dieser Aufrufer sehen darf.
maintenanceWindowTargetMissing(500, ändern und löschen) Dem gespeicherten Fenster fehlt die Zeile, die es abgedeckt hat. Das ist eine Dateninkonsistenz und kein Anfragefehler: melden statt wiederholen.

Ein wiederholter Anlege-Aufruf ist ungefährlich: ein Fenster, dessen vollständiger Anfragekörper einem bereits vorhandenen entspricht, entsteht kein zweites Mal, das vorhandene kommt zurück, und seine Abonnenten werden nicht ein zweites Mal angekündigt.

Organisationsberichte-Fehlercodes

Endpunkte unter /api/organization/reports und /api/organization/report-runs können diese data.code-Werte liefern:

CodeBedeutung
invalidReportScheduleWöchentlicher Bericht ohne weekday oder monatlicher Bericht ohne dayOfMonth (1-28).
invalidReportScopeScope-IDs gehören nicht zur Organisation, oder Schwellenwert-Modus ohne Schwellenwert.
reportRunNotFoundDer angeforderte Bericht-Lauf existiert für diese Organisation nicht.
reportRunNoPdfDer Bericht-Lauf hat kein archiviertes PDF (Nur-E-Mail oder übersprungen).
reportPdfNotFound(404) Der Lauf-Datensatz hat einen PDF-Pfad, aber das Objekt konnte nicht aus dem Object Storage gelesen werden.

Fehlercodes Dependency-Status

Die öffentlichen Endpunkte unter /api/public/dependencies können diese data.code-Werte liefern:

CodeBedeutung
providerNotFound(404) Kein aktiver Anbieter mit diesem Slug. Unbekannt und inaktiv ergeben absichtlich dieselbe Antwort.
invalidIncidentPage(400) incidentPage ist keine Ganzzahl von 1 bis 100000.

Fehlercodes Meldeformular

Die öffentlichen Endpunkte unter /api/public/im/report-form/:token, auf denen die Seite des Meldeformulars aufsetzt, können diese data.code-Werte liefern. Eine Meldung (POST) antwortet sonst immer 202 {"status":"received"}, auch wenn sie verworfen wurde oder der Token unbekannt ist.

CodeBedeutung
reportFormNotFound(404, GET) Hinter diesem Link liegt kein Meldeformular. Unbekannter Token, Token einer anderen Quellart und gelöschte Organisation ergeben absichtlich dieselbe Antwort.
invalidRequestBody(400, POST) Ein Feld verletzt die Regeln des Formulars, etwa ein Text unter 10 Zeichen oder eine ungültige E-Mail-Adresse.
unavailable(503) Formular oder Warteschlange waren nicht erreichbar. Die Meldung später erneut senden.

Datenexport-Fehlercodes

Endpunkte unter /api/organization/data-export (siehe Datenexport anfordern) können diese data.code-Werte liefern:

CodeBedeutung
invalidExportRecipient(400) recipientEmails enthält eine Adresse, die kein Mitglied dieser Organisation ist. Die abgelehnten Adressen stehen in data.unknown.
exportAlreadyRunning(409) Für diese Organisation läuft bereits ein Export (queued oder generating). Der laufende Export steht in data.export.
exportCooldown(429) Innerhalb des Cooldown-Fensters (data.cooldownHours, Standard 6) wurde bereits ein Export angefordert.
exportNotReady(409) Download angefragt, während der Export in der Warteschlange, in Arbeit oder fehlgeschlagen ist. Aktueller Stand in data.status.
exportExpired(410) Das 7-Tage-Download-Fenster ist geschlossen, die Datei wurde gelöscht.
missingExportId(400) Die Route wurde ohne Export-ID aufgerufen.

Fehlercodes des Audit-Log-Exports

Audit-Log exportieren kann zusätzlich zu invalidRequestBody und invalidDateRange diesen data.code-Wert liefern:

CodeBedeutung
auditExportRangeTooLarge(400) Der Zeitraum ist länger als 366 Tage oder enthält mehr als 100.000 Einträge. Teile ihn auf mehrere Exporte auf.

Agent-Auth-Fehlercodes

Agent-Zugriffstokens (wsma_, siehe Agent-Authentifizierung) sind standardmässig hart auf eine GET/HEAD-Allowlist beschränkt. Ein Token mit Schreib-Scope (api.write.monitors, api.write.incidents) wird stattdessen je Methode und Pfad geprüft, gegen eine feste Positivliste, die heute nur diese beiden Bereiche abdeckt -- alles andere, einschließlich Abrechnung, Zugangsdaten und jeder Pfad auf der gemeinsamen Schreib-Sperrliste, bleibt unabhängig vom Scope unerreichbar. Beide Token-Arten erreichen weiterhin nichts außerhalb ihrer eigenen Lese-Allowlist.

CodeBedeutung
agentTokenReadOnly(403) Antwort auf jeden Schreibversuch, während der plattformweite Schreib-Kill-Switch aus ist, unabhängig vom Scope des Tokens -- und, auch beim Lesen, wenn der Pfad außerhalb der eigenen Lese-Allowlist des Tokens liegt. data.reason nennt die greifende Regel: agentTokenWriteDisabled, agentTokenReadOnly, agentTokenPathForbidden oder agentTokenPathAmbiguous.
agentTokenScopeForbidden(403) Der Kill-Switch ist an, aber genau diese Methode und dieser Pfad stehen nicht auf der Schreib-Positivliste des Tokens -- eingeschlossen ein Token ganz ohne Schreib-Scope. Bewusst unterschieden von agentTokenReadOnly: Dieses Token darf schreiben, nur nicht dies -- ein anderer Schreibzugriff oder ein anderer Bereich kann trotzdem gelingen.

API-Token-Fehlercodes

Ein kundengebundenes API-Token (wsm_ mit customerId) bleibt in seinem Kunden. Organisationsweite Pfade haben keine Kundendimension, das Token erreicht sie deshalb gar nicht: alles unter /api/organizations/**, /api/organization/** (außer GET /api/organization), /api/users/**, /api/admin/**, /api/platform-admin/**, /api/escalation-config/**, /api/custom-pricing, /api/custom-fields/**, /api/im/**, /api/notifications/send-alert, Schreibzugriffe auf /api/package-configs/**, Anlegen und Löschen von Kunden sowie /api/customers/bulk. Kein API-Token, ob kundengebunden oder nicht, kann weitere Tokens erzeugen.

CodeBedeutung
customerScopedTokenForbidden(403) Ein kundengebundener Aufrufer hat einen organisationsweiten Pfad oder eine organisationsweite Ressource erreicht. Seit dem 04.09.2026 gilt das nicht nur für kundengebundene API-Token, sondern für jede kundengebundene Sitzung: ein editor mit Kundenzuweisungen oder ein Plattform-Admin im Kundenkontext, der einen Kunden anlegt oder ein organisationsweites Wartungsfenster (customerId: null) ändert oder löscht. Für Organisationseinstellungen, Abrechnung, Nutzer, Reports und organisationsweite Fenster ein organisationsweites Token oder eine unbeschränkte Nutzersitzung verwenden.
apiTokenCannotMintTokens(403) POST /api/customer/tokens wurde mit einem API-Token aufgerufen. Tokens erzeugt ein angemeldeter Nutzer, nie ein anderes Token.
apiTokenScopeForbidden(403) Das API-Token wurde mit scopes angelegt, und keiner davon deckt diesen Pfad und diese Methode ab (api.read.<bereich> für GET/HEAD, sonst api.write.<bereich>), oder der Pfad gehört zu gar keinem Scope. Tokens ohne Scopes sind nicht betroffen. Siehe Token-Scopes. data.requiredScope nennt den fehlenden Scope (fehlt, wenn der Pfad zu keinem Scope gehört).
apiTokenPathAmbiguous(403) Der Pfad enthält einen kodierten Schrägstrich, ein Punktsegment oder einen doppelten Schrägstrich. Die Token-Sperren normalisieren solche Pfade nicht, sie lehnen sie ab.
csrfOriginRejected(403) Ein Schreibzugriff mit Cookie-Sitzung kam von einer fremden Seite: Sec-Fetch-Site: cross-site oder ein Origin, der weder zum Host der Anfrage noch zu einem vertrauten Origin passt. API-Tokens sind nie betroffen; Browser-Integrationen rufen vom Origin der App selbst auf.

Claim-Flow-Fehlercodes

Die service_auth-Registrierung und die Claim-Zeremonie (siehe Claim-Flow) können zusätzlich zu den obigen Basis-Agent-Auth-Codes diese error-/data.code-Werte liefern:

CodeBedeutung
service_auth_not_enabled(400) POST /agent/identity: der Identitätstyp service_auth ist auf diesem Deployment nicht aktiviert.
invalid_claim_token(400 bei POST /agent/identity/claim und POST /api/agent-claim/confirm, 404 bei GET /api/agent-claim/context) Der Claim-Token, Claim-Attempt-Token oder user_code ist unbekannt/abgelaufen/vom falschen Typ, der angemeldete Nutzer ist nicht die gebundene E-Mail, oder der Zugriff des bestätigenden Nutzers lässt sich nicht auf einen einzelnen Organisations-/Kunden-Scope auflösen.
claimed_or_in_flight(409) POST /agent/identity/claim: die Registrierung ist bereits geclaimt.
claim_expired(400) POST /agent/identity/claim: das äußere 24h-Claim-Fenster (ab Erstellung der Registrierung) ist verstrichen.
authorization_pending(400) POST /oauth2/token mit dem Claim-Grant: der Nutzer hat noch nicht bestätigt; weiter pollen.
slow_down(400) POST /oauth2/token mit dem Claim-Grant: schneller als das zurückgegebene interval (5s) gepollt; drossle dich.
expired_token(400) POST /oauth2/token mit dem Claim-Grant: der Claim-Token/die Registrierung ist abgelaufen, wurde widerrufen oder bereits eingelöst.

ID-JAG-Fehlercodes

Registrierungen vom Typ identity_assertion (siehe Identity Assertion (ID-JAG)) können zusätzlich liefern:

CodeBedeutung
issuer_not_enabled(400) POST /agent/identity: Uptimeify vertraut in dieser Installation keinem Identity-Provider, identity_assertion ist also aus.
login_required(401) POST /agent/identity: die auth_time des ID-JAG ist älter als max_age (3600 s, wird mitgeliefert); beim Identity-Provider neu anmelden.
interaction_required(401) POST /agent/identity: die bestätigte E-Mail gehört zu einem Uptimeify-Konto, und der Agent ist noch nicht freigegeben; schick die Person zu claim.verification_uri_complete und polle mit claim_token.
invalid_grant(400) POST /oauth2/token mit dem jwt-bearer-Grant für einen freigegebenen ID-JAG-Agenten: der verlangte Scope geht über die Freigabe hinaus (scope_exceeds_grant), die Kundenbindung der Person hat sich geändert (binding_changed), die freigebende Person gibt es nicht mehr (no_human), oder nach dem Streichen der Schreibrechte für einen Global Supporter bleibt nichts übrig (nothing_left). Der Grund steht in error_description.
invalid_request (err)(400) POST /agent/event/notify: falscher Content-Type, leerer Körper, oder das Security Event Token wurde nicht angenommen. Welche Prüfung gescheitert ist, wird bewusst nicht gesagt.

Verbundene-Apps-Fehlercodes (OAuth-Verbindungen)

GET /api/oauth/connections und DELETE /api/oauth/connections/:clientId (siehe Verbundene Apps) können zusätzlich zum Standard-401 unauthorized diese data.code-Werte liefern:

CodeBedeutung
missingClientId(400) Nur DELETE: der Pfad-Parameter :clientId fehlt.
unknownOauthConnection(404) Nur DELETE: der Aufrufer hat keine OAuth-Verbindung mit dieser client_id (bereits widerrufen, abgelaufen oder nie verbunden).

Fehlercodes der OAuth-Zustimmung

Diese Codes stammen von der Zustimmungsseite, über die jede OAuth-/MCP-Autorisierung jetzt läuft (POST, auf /api/oauth/consent). Wie die Step-up- und die Kontolöschungs-Route ist sie session-gebunden und nicht Teil der öffentlichen API-Oberfläche, und Methode und Pfad stehen hier aus demselben Grund getrennt: eine METHOD /api/...-Routenzeile auf diesen Seiten ist es, was einen Endpunkt in /openapi.json veröffentlicht. Sie stehen hier, weil die Codes das sind, worüber die Seite und jede Supportanfrage sprechen. Der Scope-Katalog selbst steht unter Verbundene Apps.

Die Prüfungen laufen in der Reihenfolge unten, du bekommst also den Code der ersten, die fällt. Die letzte Zeile ist die Ausnahme: sie kommt von Better Auth, nachdem jede Prüfung dieser Liste bestanden ist.

CodeStatusBedeutung
unauthorized401Keine aktive Sitzung. Der Endpunkt löst die Sitzung selbst auf, statt hinter der gemeinsamen Middleware zu liegen.
invalidConsentDecision400accept fehlt oder ist kein echtes Boolean. Bewusst kein Rückfall auf false: eine fehlerhafte Anfrage darf die Autorisierung nicht im Namen des Nutzers ablehnen.
missingOauthQuery400oauth_query fehlt. Die Zustimmungsseite reicht die signierte Autorisierungsanfrage weiter, mit der sie geöffnet wurde; ohne sie gibt es nichts zu entscheiden. Starte die Autorisierung im Client neu.
emptyConsentSelection400Nur beim Ja: es standen Lesebereiche zur Wahl und keiner wurde ausgewählt. Lehne die Autorisierung ab, statt sie leer anzunehmen. Ein Client, der gar keinen MCP-Scope anfragt, sieht keine Kästchen und trifft diesen Fall nie.
consentScopeEscalation400Nur beim Ja: die Auswahl nennt einen Scope, den der Client nicht angefragt hat, oder einen, der gar kein feiner Scope ist. Eine Auswahl kann das Angefragte immer nur verengen.
consentForwardRejected4xxDer Autorisierungsserver hat die Anfrage abgelehnt, nachdem die Prüfungen oben bestanden waren; der Status ist der, den er geliefert hat. Neben dem Code steht ein reason: meist ist die signierte Anfrage abgelaufen oder wurde verändert. Ein zweiter Versuch hilft nicht; starte die Autorisierung im Client neu.

Fehlercodes für Statusseiten-Abonnenten

Die Endpunkte zum Auflisten, Löschen und Exportieren von Statusseiten-Abonnenten können zusätzlich zum Standard-401 unauthorized und dem zweistufigen statusPageNotFound-Verhalten (auf jeder Seite beschrieben: eine fehlerhafte oder unbekannte :id ist ein code-loses 400/404 aus der Public-ID-Auflösung; nur eine :id, die sich auflöst, aber an der Organisations-/Kunden-Scope-Prüfung scheitert, trägt data.code: statusPageNotFound) diese data.code-Werte liefern:

CodeBedeutung
invalidSubscriberId(400, nur Löschen) :subscriberId lässt sich nicht als positive Ganzzahl parsen.
subscriberNotFound(404, nur Löschen) :subscriberId existiert nicht oder gehört zu einer anderen Statusseite als :id.

Public IDs in DNS- und DNSBL-Monitoren

Die folgenden Pfad-Endpunkte können in den Docs und in Clients mit Public IDs verwendet werden:

  • GET /api/customer-domains/:customerDomainPublicId
  • PATCH /api/customer-domains/:customerDomainPublicId
  • DELETE /api/customer-domains/:customerDomainPublicId
  • GET /api/customer-ips/:customerIpPublicId
  • PATCH /api/customer-ips/:customerIpPublicId
  • DELETE /api/customer-ips/:customerIpPublicId

Legacy-Integer-IDs bleiben auch dort weiterhin kompatibel, die Public ID ist aber die bevorzugte Form für Integrationen und Postman-Collections.

Incident-Management-(IM)-API-Fehlercodes

Die öffentliche Incident-Management-API (POST /api/im/events, GET/POST /api/im/incidents/**, GET /api/im/teams, GET/POST /api/im/schedules/**, GET /api/im/on-call) erfordert einen organisationsweiten API-Token und kann diese data.code-Werte liefern:

CodeBedeutung
imAccessDenied(403) Der Aufrufer hat keinen Zugriff auf Incident Management: keine Session/kein Token, ein kunden-gescopter API-Token, ein Kunden-Login (readonly) oder globalsupporter-Login, oder ein Org-Login ohne IM-berechtigte Rolle (admin, editor, responder).
imNotEnabled(403) Incident Management wurde für diese Organisation nicht aktiviert.
payloadTooLarge(413, nur Events Ingest) Der Request-Body überschreitet 256 KB.
invalidJson(422, nur Events Ingest) Der Request-Body ist kein gültiges JSON oder weder JSON-Objekt noch -Array.
payloadTooDeep(422, nur Events Ingest) Das geparste JSON-Payload ist mehr als 20 Ebenen tief verschachtelt.
imIncidentNotFound(404) Der Incident existiert nicht oder gehört zu einer anderen Organisation.
imIncidentInvalidStatusTransition(422, Incident bestätigen / Status ändern) Der angeforderte status ist für diesen Endpunkt kein gültiges Ziel (resolved und merged sind es nicht, stattdessen Incident lösen nutzen), der aktuelle Status des Incidents kann über diesen Endpunkt nicht überführt werden, oder status entspricht dem aktuellen Status des Incidents.
imIncidentAlreadyClosed(422, Incident lösen) Der Incident ist bereits resolved oder merged.
imIncidentStatusConflict(409, Status-/Resolve-Endpunkte) Der Status des Incidents hat sich zwischen Lesen und Schreiben gleichzeitig geändert. Sicher wiederholbar.
imTeamWriteDenied(403, Incident erstellen, Schedules, Schedule-Overrides) Die Rolle des Aufrufers ist nicht admin, und er ist kein Team-Admin (im_team_member.imRole = 'admin') des Ziel-Teams.
imShiftGiveAwayDenied(403, Schedule-Overrides) Ein einfaches Teammitglied (weder Team-Admin noch Organisationsrolle admin) hat einen Override geschickt, der nicht die Abgabe der eigenen Schicht ist, oder wollte einen Override löschen, der nicht seine eigene Abgabe ist. data.reason nennt die verletzte Bedingung: not_self, type, scope, tier, covered_by, window, coverer_not_in_team, already_given_away, no_duty, not_own_giveaway.
imShiftGiveAwayRateLimited(429, Schedule-Overrides) Ein einfaches Teammitglied hat mehr als 10 Schichten innerhalb einer Stunde abgegeben. data.retryAfter ist die Wartezeit in Sekunden.
imTeamMembershipRequired(403, Incident lösen, merge, escalate-now, snooze, Statuswechsel, Schweregrad, Kommentar, Zuweisen, add-responder, Massenaktionen) Der Aufrufer ist IM-Nutzer, aber kein Mitglied des Teams des Incidents (incident.teamId) und weder Organisations-admin noch Plattform-Admin. Das Bestätigen bleibt jedem IM-Nutzer offen. Massen-Endpunkte lehnen die ganze Anfrage ab und nennen die betroffenen Ids in deniedIncidentIds.
imTeamAdminRequired(403, add-responder mit notify: true) Einen weiteren Responder zu alarmieren verlangt einen Team-Admin (im_team_member.imRole = 'admin') des Incident-Teams oder einen Organisations-admin; ein einfaches Teammitglied darf einen Responder ohne Benachrichtigung hinzufügen.
imUserNotEligible(400, Teammitglieder, Team-Einladung eines bestehenden Kontos, Schedule-Overrides) Der Zielnutzer ist deaktiviert oder hat keine IM-fähige Rolle (admin, editor, responder).
imSnoozeRangeInvalid(400, snooze) snoozedUntil liegt nicht in der Zukunft oder mehr als 7 Tage voraus.
imTeamNotFound(404, Schedules erstellen) teamId existiert nicht oder gehört zu einer anderen Organisation.
imScheduleNotFound(404, Schedule-Overrides) :id existiert nicht oder gehört zu einer anderen Organisation.
invalidTeamId(422, Incident erstellen) teamId gehört nicht zu deiner Organisation.
invalidCustomerId(422, Incident erstellen) customerId ist angegeben, gehört aber nicht zu deiner Organisation.
imRoutingInvalidPolicyId(422, Incident erstellen) escalationPolicyId ist angegeben, gehört aber nicht zu deiner Organisation.
userNotFound(404, Schedule-Overrides hinzufügen) userId gehört nicht zu deiner Organisation.
organizationIdRequired(400, Aktivieren, Einrichtungsstand) Für den Request ließ sich keine Organisation bestimmen.
forbidden(403, Aktivieren, Einrichtungsstand, Organisationseinstellungen) Du bist kein admin der Organisation.
imUserSessionRequired(403, Mein Bereitschaftsstatus, Benachrichtigungsprotokoll) Der Endpunkt beschreibt eine Person und braucht eine Benutzersitzung; ein organisationsweiter API-Token wird abgelehnt.
monitoringAccessDenied(403, IM-Zugriffsprüfung) Die Sitzung hat keine Organisation.
imAuditLogAccessDenied(403, Audit-Log) Nur Organisations-Admins dürfen das Audit-Log lesen.
imChannelWriteDenied(403, Kanäle) Du darfst diesen Kanal nicht schreiben (organisationsweite Kanäle brauchen admin, Team-Kanäle admin oder Team-Admin).
imOutboundWriteDenied(403, Ausgehende Integrationen) Du darfst ausgehende Integrationen nicht schreiben.
imChannelNotFound(404, Kanäle) Der Kanal existiert nicht oder gehört zu einer anderen Organisation.
imEscalationTierNotFound(404, Team-Stufen) Die Stufe existiert in diesem Team nicht.
imNotificationRuleNotFound(404, Benachrichtigungseinstellungen) Die Regel existiert nicht oder gehört nicht dir.
imOutboundNotFound(404, Ausgehende Integrationen) Die ausgehende Integration existiert nicht oder gehört zu einer anderen Organisation.
imOutboundDeliveryNotFound(404, Outbound-Retry) Die Zustellung existiert für diese Integration nicht.
imOverrideNotFound(404, Schedule-Overrides, Team-Overrides) Die Vertretung existiert in diesem Dienstplan oder Team nicht.
imRoutingRuleNotFound(404, Routing-Regeln) Die Routing-Regel existiert nicht oder gehört zu einer anderen Organisation.
imSourceNotFound(404, Alarmquellen) Die Alarmquelle existiert nicht oder gehört zu einer anderen Organisation.
imStatuspageRuleNotFound(404, Statusseiten-Regeln) Die Statusseiten-Regel existiert nicht oder gehört zu einer anderen Organisation.
imTeamMemberNotFound(404, Team-Mitglieder) Das Mitglied existiert in diesem Team nicht.
imChannelInactive(400, Organisationseinstellungen) fallbackChannelId zeigt auf einen deaktivierten Kanal.
imFallbackChannelDeprecated(400, Organisationseinstellungen) fallbackChannel ist nicht mehr schreibbar; setze stattdessen fallbackChannelId auf einen Kanal aus Kanäle.
imNoTestPayloadAvailable(400, Test-Alarm / Test-Mapping einer Quelle) Kein Payload gesendet, keiner für die Quelle zwischengespeichert, und ihr Typ hat kein eingebautes Beispiel.
imReportRangeRequired(400, Berichte, Analytics) Ein gültiger Zeitraum from/to ist erforderlich (NIS-2-Leitungsbericht: oder ein quarter).
imReportRangeInvalid(400, Berichte, Analytics) from/to sind keine gültigen Daten, oder from liegt nicht vor to.
imReportRangeTooLarge(400, Berichte, Analytics) Der Zeitraum ist länger als 400 Tage (366 beim NIS-2-Leitungsbericht).
imSourceHasNoIngestToken(400, rotate-token) Der Quellentyp hat keinen eingehenden Webhook, also keinen Ingest-Token zum Rotieren.
invalidPhoneNumber(400, Benachrichtigungseinstellungen) phoneNumber ist nicht im E.164-Format (z. B. +491701234567).
imChannelIsOrgFallback(409, Kanäle) Der Kanal ist der Fallback-Kanal der Organisation und kann nicht deaktiviert werden.
imChannelReferencesExist(409, Kanäle) Der Kanal ist noch der Fallback-Kanal der Organisation und kann nicht gelöscht werden.
imTeamChannelReferencesExist(409, Teams löschen) Ein Kanal dieses Teams ist noch der Fallback-Kanal der Organisation.
imTeamRoutingReferencesExist(409, Teams löschen) Eine Routing-Regel schickt noch Alarme an dieses Team.
imTeamSourceReferencesExist(409, Teams löschen) Eine Alarmquelle gehört noch zu diesem Team.
imTeamIncidentReferencesExist(409, Teams löschen) Es gehören noch Incidents zu diesem Team; ein Team mit Incident-Historie kann nicht gelöscht werden.
imIncidentAssignmentExists(409, add-responder) Die Person hat diese Rolle am Incident bereits.
imNotificationRuleExists(409, Benachrichtigungseinstellungen) Dieselbe Regel aus Dringlichkeit, Verzögerung und Kanal existiert bereits.
imSourceProtected(409, Alarmquellen löschen) Die Quelle der Monitoring-Brücke kann nicht gelöscht werden.
imSourceReferencesExist(409, Alarmquellen löschen) Offene Alarme oder Incidents verweisen noch auf die Quelle.
imTeamMemberExists(409, Team-Mitglieder, Team-Einladung) Die Person ist bereits Mitglied dieses Teams.
imTierOrderConflict(409, Team-Stufen anlegen) Zwei Stufen wurden im selben Moment angelegt. Wiederholen ist sicher.
imAuthModeNotProvisionable(422, Alarmquellen) HMAC oder Bearer wurde direkt in authMode eingeschaltet; nimm die Endpunkte set-hmac-secret / rotate-bearer-token, die das Secret anlegen.
imIncidentAlreadyMerged(422, Incidents zusammenführen) Der Incident ist bereits zusammengeführt.
imIncidentCannotMergeIntoSelf(422, Incidents zusammenführen) Quelle und Ziel sind derselbe Incident.
imIncidentTargetAlreadyMerged(422, Incidents zusammenführen) Der Ziel-Incident ist selbst zusammengeführt.
imMergeSuggestionNotFound(404, Vorschlag zum Zusammenführen verwerfen) Der Incident hat keinen offenen Vorschlag für dieses Ziel (nie vorgeschlagen oder schon verworfen).
imMergeTargetClosed(422, Incidents zusammenführen) Der Ziel-Incident ist gelöst.
imIncidentClosed(422, Snooze) Ein gelöster oder zusammengeführter Incident kann nicht gesnoozt werden.
imIncidentNotEscalating(422, Sofort eskalieren) Escalate-now geht nur, solange der Incident triggered ist (noch nicht bestätigt).
imNoFurtherTier(422, Sofort eskalieren) Der Incident steht bereits auf der letzten Stufe.
imInviteEmailNotEligible(422, Team-Einladung) Für diese E-Mail gibt es in deiner Organisation kein einladbares Konto.
imRoutingInvalidMatchReference(422, Routing-Regeln) match.source_ids oder match.customer_ids nennt eine ID außerhalb deiner Organisation; field und foreignIds sagen, welche.
imTierReorderMismatch(422, Team-Stufen umsortieren) tierIds muss genau die aktuellen Stufen-IDs des Teams enthalten.
invalidStatusPageId(422, Statusseiten-Regeln) statusPageId gehört nicht zu deiner Organisation.
imPhoneCountryNotAllowed(400, Benachrichtigungseinstellungen) Ein Bestätigungscode wurde für eine Nummer außerhalb von EU/EWR, Schweiz und Vereinigtem Königreich oder für eine Mehrwertnummer angefordert.
imPhoneNotSet(422, Benachrichtigungseinstellungen) Ein Bestätigungscode wurde ohne gespeicherte Telefonnummer angefordert.
imPhoneVerifyCodeInvalid(422, Benachrichtigungseinstellungen) Der Bestätigungscode ist falsch.
imPhoneVerifyCodeExpired(422, Benachrichtigungseinstellungen) Der Bestätigungscode ist älter als 10 Minuten.
imPhoneVerifyTooManyAttempts(422, Benachrichtigungseinstellungen) Der Code wurde 5-mal versucht; fordere einen neuen an.
imPhoneVerifyRateLimited(429, Benachrichtigungseinstellungen) Mehr als 3 Bestätigungscodes in einer Stunde; retryAfterSeconds sagt, wann es wieder geht.
imTestNotificationRateLimited(429, Benachrichtigungseinstellungen, Test-Alarm der Einrichtung) Mehr als 5 Test-Benachrichtigungen oder Test-Alarme in einer Stunde; retryAfterSeconds sagt, wann es wieder geht.
generic(500, IM-Schreib-Endpunkte) Der Schreibvorgang lieferte keine Zeile zurück; die Ursache steht im Server-Log.
imBulkActionNotImplemented(501, Sammelaktionen) Das Team mehrerer Incidents auf einmal zu ändern, ist nicht umgesetzt.
imPhoneVerifySendFailed(502, Benachrichtigungseinstellungen) Der SMS-Anbieter hat die Bestätigungsnachricht abgelehnt; error nennt den Grund.
unavailable(503, Events Ingest, Test-Alarm einer Quelle) Der Alarm konnte nicht in die Warteschlange. Mit Backoff wiederholen.

GET /api/im/incidents, Incident erstellen, die Status-/Resolve-Endpunkte, Schedules erstellen und Schedule-Overrides hinzufügen können außerdem den generischen 400 invalidRequestBody bei fehlerhafter Eingabe liefern (z. B. ein unbekannter status-Filterwert, eine nicht-ganzzahlige :id, eine fehlende oder fehlerhafte Rotationsschicht). POST /api/im/events kann zusätzlich 429 Too Many Requests liefern (600 Anfragen/Minute pro Organisation, mit einem retryAfter-Feld, aber ohne data.code), oder 503 mit data.code: unavailable, wenn das Event nicht eingereiht werden konnte, sicher wiederholbar.

Fehlercodes der NIS-2-Meldefälle

NIS-2-Einstellungen und Meldefälle gehen nur mit Sitzung und können diese data.code-Werte liefern:

CodeBedeutung
nis2AdminRequired(403) Nur Organisations-Admins dürfen die NIS-2-Einstellungen ändern.
nis2InvalidOfficer(400) Eine verantwortliche Person ist kein Nutzer Ihrer Organisation mit der Rolle admin, editor oder responder.
nis2NotEnabled(403) NIS-2-Meldefälle sind für Ihre Organisation nicht eingeschaltet.
nis2OfficerRequired(403) Der Aufruf kommt von einem API-Token oder von einer Person, die weder Organisations-Admin noch Meldeverantwortliche ist.
reportCaseAlreadySubmitted(409) Nach einer Abgabe kann der Fall nicht mehr als not_reportable entschieden werden.
reportCaseAwareAtReasonRequired(400) awareAt später zu setzen, braucht eine reason.
reportCaseCannotClose(409) Ein Fall schließt erst nach der Abschlussmeldung oder bei not_reportable.
reportCaseClosed(409) Der Fall ist geschlossen und nimmt keine Änderung mehr an.
reportCaseCriteriaOpen(409) Vor der Entscheidung muss jedes Kriterium bestätigt oder verworfen sein.
reportCaseDraftInvalid(400) text und draftToken einer Abgabe gehören nicht zusammen: anderer Text, Fall oder andere Stufe, oder der Token ist älter als 90 Tage. GET .../draft neu holen und genau dessen text mit dessen draftToken senden.
reportCaseIncidentAlreadyLinked(409) Der Vorfall ist schon mit diesem Fall verknüpft.
reportCaseIncidentNotLinked(404) Der Vorfall ist nicht mit diesem Fall verknüpft.
reportCaseInvalidTransition(409) Die Stufe passt nicht zum Status des Falls, z. B. final vor notification oder eine zweite early_warning.
reportCaseNotFound(404) Der Meldefall existiert nicht oder gehört einer anderen Organisation.
reportCaseNotReportable(409) Abgaben gibt es nur bei Fällen, die als reportable entschieden sind.
reportCaseReasonRequired(400) not_reportable braucht eine reason.
reportCaseSubmittedInFuture(400) submittedAt liegt in der Zukunft.
reportCaseTestIncident(400) Test-Vorfälle lassen sich nicht mit einem Meldefall verknüpfen.

Fehlercodes von Postmortem und Nachbereitung

Postmortem und Nachbereitung können diese data.code-Werte liefern:

CodeBedeutung
causeArchived(409) Die Ursache ist archiviert und lässt sich nicht neu wählen. Eine schon am Postmortem gesetzte Ursache bleibt gültig.
causeNameTaken(409) Eine Ursache mit diesem Namen (ohne Groß/Klein) gibt es in Ihrer Organisation schon.
causeNotFound(404) Die Ursache existiert nicht oder gehört einer anderen Organisation.
imServiceNotFound(404) Der Dienst existiert nicht oder gehört einer anderen Organisation.
imServiceNameTaken(409) Einen Dienst mit diesem Namen (ohne Groß/Klein) gibt es in Ihrer Organisation schon.
imServiceMonitorNotFound(404) Ein Monitor in monitors existiert nicht oder gehört einer anderen Organisation; data.monitors nennt sie.
imServiceWriteDenied(403) Nur ein Admin der Organisation darf Dienste anlegen, ändern oder löschen.
postmortemActionNotFound(404) Die Maßnahme existiert nicht oder gehört zu einem anderen Postmortem.
postmortemActionOwnerInvalid(400) ownerUserId ist kein Nutzer Ihrer Organisation.
postmortemCauseRequired(400) Zum Abschließen braucht es eine causeId.
postmortemCompleted(409) Das Postmortem ist abgeschlossen. Inhalt ändern geht erst nach POST .../reopen; Maßnahmen bleiben änderbar.
postmortemIncidentNotResolved(409) Der Vorfall ist nicht gelöst (oder wurde in einen anderen zusammengeführt).
postmortemIncomplete(400) Zum Abschließen braucht es summary und rootCause.
postmortemNotFound(404) Zu diesem Vorfall gibt es noch kein Postmortem, oder es gehört einer anderen Organisation.
postmortemOrphaned(409) Der Vorfall dieses Postmortems wurde gelöscht. Das Postmortem bleibt lesbar, lässt sich aber nicht wieder öffnen.
quarterlyReviewExists(409) Dieses Quartal ist schon abgezeichnet. Eine Abzeichnung lässt sich nicht ändern.
quarterlyReviewNotDue(409) Das Quartal ist in der Zeitzone Ihrer Organisation noch nicht zu Ende.

Nutzerverwaltungs-Fehlercodes

PATCH /api/users/:id (Doku) und DELETE /api/users/:id (Doku) schützen die Organisation davor, sich selbst auszusperren:

CodeBedeutung
userSelfChangeForbidden(400, update) Du hast versucht, deine eigene Rolle zu ändern oder dein eigenes Konto auf isActive: false zu setzen. Ein anderer Organisations-Admin muss das tun.
lastAdminProtected(400, update und delete) Das Ziel ist der letzte aktive Organisations-admin; er kann weder herabgestuft noch deaktiviert noch gelöscht werden. Zuerst einen weiteren Nutzer befördern.
globalUserProtected(403, update und delete) Das Ziel trägt ein Plattform-Flag (isGlobalAdmin oder isGlobalSupporter) und darf nur von einem Plattform-Admin geändert werden.

Etiketten-Fehlercodes

POST /api/tags hält in created_by fest, welcher Mensch ein Etikett angelegt hat. Diese Spalte ist NOT NULL und trägt keinen Fremdschlüssel. Ein Aufruf über eine Agenten-Sitzung (eine MCP-Verbindung, create_tag) wird deshalb abgewiesen, statt einen Ersatzwert zu bekommen: irgendetwas dort hineinzuschreiben würde den Zweig „der Urheber darf ändern“ der Rechteprüfung still und dauerhaft kaputt machen.

CodeBedeutung
authorizingUserUnresolved(403, anlegen) Der Mensch, der diese Agenten-Sitzung autorisiert hat, ist nicht mehr auflösbar, es gibt also keine Nutzer-Id, die als Urheber des Etiketts festgehalten werden könnte. Das Etikett entsteht nicht. Ein Etikett hält immer den autorisierenden Menschen fest, nie den Agenten. Autorisiere die Verbindung neu oder lege das Etikett mit einer Sitzung an, die zu einer Person gehört.

Die übrige Etikettenfläche (POST /api/tags, PATCH /api/tags/{id}, DELETE /api/tags/{id} sowie Anhängen und Abnehmen mit POST /api/monitor-tags und DELETE /api/monitor-tags) kann diese liefern:

CodeBedeutung
invalidTagColor(400, anlegen und ändern) Die Farbe gehört nicht zur Palette. Die Palette ist eine feste Menge und kein freies Hex-Feld.
tagCustomerRequired(400, anlegen) Ein kundengebundener Aufrufer mit mehr als einem Kunden im Geltungsbereich hat nicht gesagt, zu welchem das Etikett gehört. Wer genau einen Kunden im Geltungsbereich hat, bekommt diesen als Vorgabe.
invalidCustomer(400, anlegen und ändern) Der genannte Kunde gehört zu einer anderen Organisation.
tagNotFound(404) Es gibt kein Etikett dieser Id, das dieser Aufrufer sehen darf.
invalidMonitorType(400, anhängen und abnehmen) monitorType gehört nicht zu den unterstützten Monitorfamilien.
monitorNotFound(404, anhängen und abnehmen) Es gibt keinen Monitor dieser Art und Id, den dieser Aufrufer sehen darf.
tagMonitorOrgMismatch(400, anhängen) Etikett und Monitor gehören zu verschiedenen Organisationen.
tagLimitReached(422, anhängen) Der Monitor trägt bereits die höchstens fünf erlaubten Etiketten.

Das Anhängen ist wiederholbar: ein Etikett, das schon am Monitor hängt, wird kein zweites Mal angehängt, und der Aufruf gelingt trotzdem.

Fehlercodes für Änderungswünsche

POST /api/monitors/:type/:id/change-requests und die ältere, nur für Websites gedachte Route unter /api/websites/:id/change-requests halten den anfragenden Menschen in requested_by fest, einer NOT NULL-Spalte mit Fremdschlüssel auf user. Ein Aufruf über eine Agenten-Sitzung wird deshalb abgewiesen statt mit einem Ersatzwert versehen:

CodeBedeutung
authorizingUserUnresolved(403, anlegen) Der Mensch, der diese Agenten-Sitzung autorisiert hat, ist nicht mehr auflösbar. Es entsteht keine Anfrage. Das Entscheiden einer Anfrage (PATCH /api/change-requests/:id) ist nicht betroffen: resolved_by ist nullable und bleibt dann einfach leer.

Benachrichtigungskanal-Fehlercodes

CodeBedeutung
configRequiredForTypeChange(400, Benachrichtigungskanal aktualisieren) type wurde geändert, aber die Anfrage enthält keine config. Ein Typwechsel baut die Konfiguration aus der Anfrage neu auf; Felder des alten Typs werden nie übernommen, also die vollständige Konfiguration des neuen Typs mitsenden.
notificationChannelRecipientExists(409, Benachrichtigungskanal erstellen) im selben Geltungsbereich stellt bereits ein AKTIVER Kanal desselben Typs an dieselbe Adresse zu; data.channelId nennt ihn. Ein wiederholter Anlege-Aufruf, dessen Antwort nie ankam, landet hier, statt einen zweiten Kanal anzulegen, der jeden Alarm doppelt zustellen würde. Deaktivierte Kanäle blockieren nie, und der Name gehört nicht zur Prüfung.
invalidRequestBody(400, Kanal erstellen und Kanal aktualisieren) Eine Ziel-URL in config ist nicht parsebar, nutzt ein anderes Schema als http/https oder zeigt auf eine private, Loopback- oder Link-Local-Adresse, auf localhost, auf einen reservierten Privatnamen (.local, .internal, .home.arpa) oder auf einen Hostnamen ohne Punkt. Als Ziel-URL gilt jede Zeichenkette der obersten config-Ebene, die mit http:// oder https:// beginnt; Felder mit Nachrichteninhalt (bodyTemplate, webhookBodyTemplate, headers) sind ausgenommen. Es wird kein DNS aufgelöst, den Namen, der erst später privat auflöst, fängt die Prüfung bei der Zustellung ab.
sourceChannelIdRequired(400, anlegen) Die Anfrage will eine website-spezifische Ausnahme, nennt aber keine sourceChannelId. Eine Ausnahme leitet sich immer von einem vorhandenen Kanal der Organisation ab.
invalidSourceChannelId(400, anlegen) sourceChannelId ist keine brauchbare Id für eine Website-Ausnahme.
sourceChannelNotFound(404, anlegen) Der genannte Ausgangskanal liegt in keiner Organisation, die dieser Aufrufer sehen darf.
websiteChannelOverrideExists(409, anlegen) Für diese Website gibt es zu diesem Ausgangskanal schon eine Ausnahme. Die vorhandene ändern statt eine zweite anzulegen.
channelIdRequired, invalidChannelId(400, ändern und löschen) Der Pfad trägt keine Kanal-Id oder eine, die keine brauchbare Id ist.
channelNotFound(404, ändern und löschen) Es gibt keinen Kanal dieser Id, den dieser Aufrufer sehen darf.

Ein Matrix-Kanal ist ein Sonderfall, den man kennen sollte: seine homeserverUrl wird beim Speichern auf ihre Form geprüft und bei der Zustellung noch einmal aufgelöst. Ein Homeserver, der nur auf eine private oder reservierte Adresse auflöst, wird bei der Zustellung abgewiesen, und die Abweisung steht an diesem Alarm, nicht als Fehler an diesem Endpunkt.

Fehlercodes für eigene Domains

Die Verify- und Activate-Endpunkte der White-Label-Domains und der Statusseiten-Domains beanspruchen einen Hostnamen für deine Organisation. Seit dem 04.09.2026 ist ein Hostname nur unter beanspruchten Einträgen (verified/active) eindeutig; ein pending-Eintrag blockiert niemanden und verfällt nach 7 Tagen.

CodeBedeutung
domainAlreadyClaimed(409) Eine andere Organisation hat diesen Hostnamen bereits verifiziert oder aktiviert. Die Antwort nennt diese Organisation nie.
hostnameReserved(400, Domain hinzufügen) Der Hostname ist einer der Plattform-Hosts, eine Subdomain davon oder liegt unter uptimeify.io.

Abgelöste Felder (Umbenennungen, 20.10.2026)

Ein Feld, das die Namensregeln verletzt, bekommt einen Nachfolger daneben. Beide werden bis zum Entfallsdatum ausgeliefert; das alte Feld ist in der OpenAPI-Spec als deprecated markiert und nennt seinen Nachfolger in x-replaced-by. Request-Bodies nehmen bis dahin beide Schreibweisen an. Ein zu tief verschachtelter Pfad bekommt auf dieselbe Weise einen flachen Nachfolger; die alte Operation ist als deprecated mit x-replaced-by markiert und funktioniert bis zum Entfallsdatum. Stell jetzt auf den Nachfolger um.

Altes FeldNachfolgerWoEntfällt am
duration (Text, z. B. 1h 5m 3s)durationMs (Ganzzahl, Millisekunden)Vorfallzeilen in incident-history und details jedes Monitors18.01.2027
started_atstartedAtZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
total (SMS-Summe des Monats)smsTotalCurrentMonthGET /api/customers/sms-usage; mit ?envelope=items ist total die Zahl der Kunden18.01.2027
Pfad POST /api/im/teams/:id/tiers/:tierId/schedulesPfad POST /api/im/tiers/:tierId/schedulesgleicher Body und gleiche Antwort; das Team kommt aus der Stufe18.01.2027
Pfad POST /api/organizations/:id/package-configs/:packageType/apply-report-defaultPfad POST /api/package-configs/:packageType/apply-report-defaultgleiche Antwort; die Organisation kommt aus der Sitzung18.01.2027
resolved_atresolvedAtZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
last_notified_atlastNotifiedAtZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
error_messageerrorMessageZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
status_codestatusCodeZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
response_time_msresponseTimeMsZeilen der Vorfallliste, mit und ohne includeTotal18.01.2027
errorerrorMessageDatenexporte der Organisation (Liste, einzelner Export, neue Anforderung)18.01.2027
recurrencePattern.intervalrecurrencePattern.intervalCount (Wiederholung alle N Einheiten von frequency)Wartungsfenster: jede Antwort sowie die Bodies von Anlegen, Ändern und Terminvorschau. Beide mit verschiedenen Werten antworten 400 invalidRequestBody18.01.2027
match.source_idsmatch.sourceIdsRouting-Regeln im Incident Management (Antworten und Request-Bodies)18.01.2027
match.customer_idsmatch.customerIdsRouting-Regeln im Incident Management (Antworten und Request-Bodies)18.01.2027
match.monitor_idsmatch.monitorIdsRouting-Regeln im Incident Management (Antworten und Request-Bodies)18.01.2027
match.field_matchesmatch.fieldMatchesRouting-Regeln im Incident Management (Antworten und Request-Bodies)18.01.2027
filters.event_kindsfilters.eventKindsOutbound-Integrationen im Incident Management (Antworten und Request-Bodies)18.01.2027
authMode.url_tokenauthMode.urlTokenAlarmquellen im Incident Management (Antworten und Request-Bodies)18.01.2027
errorerrorMessageBenachrichtigungsprotokoll, Ergebnisse der Testbenachrichtigung und Mapping-Test einer Alarmquelle im Incident Management18.01.2027
themeNeutralthemeSecondary (der Name, den die Antwort schon nutzt)Request-Body von PATCH /api/organization/whitelabel/branding; kommen beide, gilt themeSecondary01.02.2027

404 für Ressourcen außerhalb des Scopes

Seit dem 04.09.2026 antwortet jeder Ressourcen-Endpunkt mit 404 und seinem üblichen Not-found-Code (websiteNotFound, monitorNotFound, customerNotFound, customerDomainNotFound, customerIpNotFound, statusPageNotFound), sowohl wenn die Ressource nicht existiert als auch wenn sie existiert, aber nicht in deiner Organisation oder deinem Kundenscope liegt. Ein 403 bleibt rollenbasierten Ablehnungen vorbehalten (falsche Rolle, kundengebundenes Token auf einem Organisationspfad). Tests, die für „gehört einem anderen Kunden“ ein 403 erwarteten, müssen angepasst werden.

Seit dem 20.10.2026 folgen auch die übrigen Kundenpfade dieser Regel: GET, PATCH und DELETE /api/customers/:id, GET /api/customers/:id/users, POST /api/customers/:id/ips, GET und PATCH /api/customer-ips/:id sowie GET und PATCH /api/customer-domains/:id. Bis dahin antworteten sie für einen Kunden außerhalb deines Scopes mit 403 forbidden, jetzt mit 404 und ihrem üblichen Not-found-Code (customerNotFound, ipNotFound, domainNotFound). Global Supporter können GET /api/customer-ips/:id jetzt lesen, wie jedes andere Monitor-Detail.

Fehlercodes für Rate-Limits und Größen

CodeBedeutung
imIngestRateLimited(429, an der Webhook-URL einer Alert-Quelle) Mehr als 300 Anfragen pro Minute für eine Alert-Quelle. data.retryAfter nennt die Wartezeit in Sekunden.
imIngestByteBudgetExceeded(429, an der Webhook-URL einer Alert-Quelle) Die Organisation hat innerhalb einer Stunde mehr als 50 MiB Ingest-Bodies gesendet. data.retryAfter nennt die Wartezeit in Sekunden.
imOutboundRetryRateLimited(429, POST /api/im/outbound/:id/retry) Mehr als 10 manuelle Wiederholungen pro Minute für eine Integration.
invalidDateRange(400, jeder check-history-, alert-history- und incident-history-Endpunkt sowie der Audit-Log-Export) from oder to ist kein lesbares Datum, oder from liegt nach to. Vorher wurden solche Werte stillschweigend ignoriert.
invalidRequestBody(400, jeder check-history-, alert-history- und incident-history-Endpunkt) Ein Query-Parameter ist ungültig: page/limit keine positive Ganzzahl, format weder json noch csv, download weder 0 noch 1, ein unbekannter status/type, oder minMs/maxMs keine nicht-negative Zahl. Bisher wurden solche Werte still ersetzt (Seite 1, JSON, kein Filter).
noLocationsConfigured(400, POST /api/websites/:id/trigger-check) Die Website hat keinen Prüfstandort, auf dem sie laufen könnte.
invalidScreenshotId(400, Screenshot-Download) Die Screenshot-Id ist keine UUID.
invalidHostname(400, TCP-/SSH-/FTP-Monitor anlegen und ändern) Der Hostname ist kein öffentliches Ziel. Das kam vorher als 500 an.

POST /api/organizations/:id/vat-id/validate ist auf 10 Prüfungen pro Stunde und Organisation begrenzt (429 mit data.retryAfter). POST /api/im/sources/:id/test-alert wendet jetzt dieselben Body-Grenzen an wie die Ingest-URL (payloadTooLarge, invalidJson, payloadTooDeep).

Fehlercodes für Webhook- und SMTP-Ziele

CodeBedeutung
webhookHostHeaderForbidden(400, Eskalationskonfiguration und IM-Kanal-Konfiguration) Ein eigener Host-Header wird für Webhooks nicht akzeptiert; der Header kommt immer aus der URL.
smtpHostNotPublic(400, PATCH /api/organization/smtp) Der SMTP-Host löst auf eine private, Loopback-, Link-local-, CGNAT- oder sonst nicht öffentliche Adresse auf. Dieselbe Prüfung läuft beim Versand erneut; ein Host, der nicht mehr öffentlich ist, fällt auf den Plattform-Mailanbieter zurück.

Fehlercodes der Absenderdomain

Alle auf /api/organization/sender-domain und /api/organization/sender-domain/verify (Eigene Absenderdomain).

CodeBedeutung
senderDomainNotEnabled(403) Absenderdomains sind eine Enterprise-Funktion und für diese Organisation nicht freigeschaltet.
senderDomainNotConfigured(404, GET, verify, DELETE) Es ist keine Absenderdomain eingetragen.
senderDomainReserved(400, PUT) Eine Uptimeify-Domain oder eine ihrer Subdomains kann keine Absenderdomain sein.
senderDomainTaken(409, PUT) Eine andere Organisation nutzt die Domain, oder sie ist beim Mailanbieter bereits registriert.
senderDomainProviderError(502) Der Mailanbieter hat die Anfrage nicht angenommen. Es wurde nichts geändert; versuch es später noch einmal.
senderDomainUnavailable(503) Absenderdomains sind vorübergehend nicht verfügbar.

Organisation gesperrt oder gelöscht

Ein Gate vor dem Kontozustand-Gate weiter unten sperrt jede /api/*-Anfrage, Sitzung, wsm_-API-Token oder wsma_-Agenten-Token gleichermaßen, anhand des Organisationsstatus. Plattform-Admins und -Supporter sind ausgenommen, wie überall sonst auch.

Eine suspended (gesperrte) Organisation bekommt 423 Organization suspended ohne data.code, außer für eine schmale Freigabeliste, die erreichbar bleibt, damit sie sich zurückzahlen kann: die Organisation lesen, das Kontingent ändern, die Datenexport-Endpunkte oben, die Tenant-Abfrage sowie die Mollie-Mandat-Rückkehr/-Reconcile- und Rabattcode-Route. Jede andere Route ist gesperrt.

Eine deleted (gelöschte) Organisation bekommt diese Freigabeliste NICHT und verliert zusätzlich zwei Routen, die bei suspended noch offen bleiben: Abmelden (POST auf /api/auth/sign-out) und beide Sitzungs-Bootstrap-Abfragen (GET auf /api/auth/get-session und /api/_internal/auth/get-session) antworten ebenfalls mit 423 Organization deleted und data.code organizationSuspended, bewusst, denn Abmelden löscht die Sitzungszeile aus Redis, und genau diese Zeile ist Beweismittel für die Löschprüfung. Vor dem 15.09.2026 erreichten Sitzung, API-Token und Agenten-Token einer gelöschten Organisation unverändert jede Route, genau die Lücke, die das schließt. „Gelöscht“ heißt hier status = 'deleted' ODER der dauerhafte Marker deletion_completed_at ist gesetzt. Maßgeblich ist, ob die Löschung abgeschlossen ist; der angezeigte Status der Organisation ist dafür nicht entscheidend. Zwei weitere Flächen folgen derselben Regel: /mcp weist API-Tokens und OAuth-Verbindungen einer gelöschten Organisation mit 423 ab, bevor ein Server aufgebaut wird, und eine Passwort-Reset-Mail wird nicht verschickt; der Endpunkt antwortet genau wie bei einer unbekannten Adresse. Eine gekündigte Organisation in ihrer Karenzzeit ist von diesem Gate nur unbetroffen, solange ihre Löschung noch nicht abgeschlossen ist. Diese Sperre greift innerhalb weniger Sekunden statt augenblicklich, weil der Kontozustand dahinter kurz zwischengespeichert wird.

Kontozustand an den Auth-Endpunkten

Better Auths eigene Routen (/api/auth/**, etwa change-password, update-user, two-factor/*, mcp/token-Refresh) weisen ein deaktiviertes Konto oder eine gesperrte Organisation genauso ab wie die API. Sign-in, Sign-out, Passwort-Reset, E-Mail-Verifikation und get-session bleiben erreichbar. Bei einer gelöschten Organisation ist die Liste enger: nur Sign-in, Registrierung, Passwort-Reset und E-Mail-Verifikation bleiben erreichbar, sign-out und get-session antworten wie oben mit 423, und eine neue Anmeldung scheitert ohnehin nach der Zugangsdatenprüfung, weil die Sitzungsanlage selbst abweist.

CodeBedeutung
accountDeactivated(403) Der angemeldete Nutzer ist deaktiviert.
organizationSuspended(423) Die Organisation des Nutzers ist gesperrt oder gelöscht. Eine gekündigte Organisation in ihrer Karenzzeit ist nicht betroffen, außer ihre Löschung ist bereits abgeschlossen.

MFA-Fehlercodes

Diese Fehlercodes gehören zur Zwei-Schritt-Bestätigung (MFA) und können von ansonsten unabhängigen Endpunkten geliefert werden, sobald das jeweilige Gate greift:

CodeStatusBedeutung
mfa_enrollment_required403Wird von jedem gegateten /api/*-Aufruf geliefert, wenn der Aufrufer (ein Plattform-Admin/-Supporter, sofern MFA_ENFORCE_PLATFORM_ADMINS aktiv ist, oder ein Mitglied einer Organisation, bei der der passende rollenbezogene Schalter requireMfaAdmins, requireMfaEditors oder requireMfaReadonly aktiv ist) die Zwei-Schritt-Bestätigung noch nicht eingerichtet hat. Richte die Zwei-Schritt-Bestätigung ein und wiederhole den Request.
mfa_step_up_required403Wird nur bei ändernden API-Token-Aufrufen geliefert (POST, PATCH und DELETE auf /api/organization/tokens sowie POST und DELETE auf /api/customer/tokens; kundenbezogene Tokens lassen sich nicht aktualisieren) wenn der Aufrufer in den letzten 5 Minuten nicht bestätigt hat: mit einem Code aus der Authenticator-App (data.method: "totp") oder, bei einem Konto ohne Zwei-Schritt-Bestätigung, mit dem aktuellen Passwort (data.method: "password", seit 17.11.2026). Bestätige im Dialog des Dashboards und wiederhole den Request innerhalb des 5-Minuten-Fensters. Konten, die sich nur per SSO anmelden und kein Passwort haben, sehen diesen Code nie. Weitere Aktionen, die nur mit Sitzung gehen, antworten genauso, siehe den Abschnitt vom 17.11.2026 am Ende dieser Seite.
mfa_step_up_locked429Wird vom internen, nur session-basierten Step-up-Endpoint (POST, /api/account/mfa/step-up, nicht Teil der öffentlichen API-Oberfläche) geliefert, nachdem für dasselbe Konto 5 falsche Codes eingegeben wurden. 15 Minuten gesperrt (data.retryAfterSeconds); warte die Sperrzeit ab und bestätige dann erneut mit deinem Authenticator.
nonUserSessionForbidden403Wird von POST /api/users/:id/mfa/reset für jeden Aufruf mit API-Token oder Agent-Access-Token geliefert, von POST /api/users mit role: "admin" und PATCH /api/users/:id mit Wechsel von role auf admin für diese Aufrufer (seit 17.11.2026), sowie von PATCH /api/organization(s), wenn der Request Body requireMfaAdmins, requireMfaEditors, requireMfaReadonly, requireMfaCustomers oder quotaAutoUpgradeEnabled enthält und der Aufrufer ein API-Token oder Agent-Access-Token ist (das Einschalten automatischer Hochstufungen ist die Zustimmung zu künftigen kostenpflichtigen Hochstufungen). Beide MFA-Verwaltungsaktionen erfordern eine echte, eingeloggte Benutzer-Session, ein organisations-gescoptes API-Token mit Admin-Rechten reicht nicht aus.

Diese Codes stehen als data.code-Wert im JSON-Fehlerbody, zusätzlich zum jeweils genannten HTTP-Status.

Fehlercodes beim Tarifwechsel

CodeStatusBedeutung
quotaChangeImmediateNotSupported400Wird von PATCH /api/organization(s) geliefert, wenn eine Reduzierung mit quotaChangeEffective: "immediately" für eine jährlich abgerechnete Organisation gesendet wird. Jahrestarife sind vorausbezahlt; sende die Reduzierung ohne das Feld (oder mit "period_end"), um sie zum Ende der bezahlten Laufzeit zu planen.
quotaChangePeriodEndNotYetAvailable400Wird von PATCH /api/organization(s) geliefert, wenn eine Reduzierung mit quotaChangeEffective: "period_end" für eine monatlich abgerechnete Organisation vor dem 1. Januar 2027 gesendet wird. Bis dahin (AGB-Fassung 1.0) gilt eine Reduzierung sofort mit anteiliger Gutschrift; sende sie ohne das Feld (oder mit "immediately"). Die Planung zum Monatsende gibt es ab dem 1. Januar 2027.

Fehlercodes der Kontolöschung

Diese Codes stammen aus der Kontolöschung in der App (GET, POST und DELETE, auf /api/account/deletion-request). Wie der Step-up-Endpunkt oben sind diese Routen session-gebunden und nicht Teil der öffentlichen API, sie stehen hier, weil die Codes das sind, worüber die App und jede Supportanfrage sprechen.

Eine Löschung wird angefordert, nicht sofort vollzogen: die Anforderung setzt einen Termin 30 Tage in der Zukunft und ist bis dahin widerrufbar. Die Administratoren der Organisation werden über die Anforderung und über den Widerruf benachrichtigt, sie sind es, die eine Bereitschaftsrotation nachbesetzen können, die der Weggang offen ließe.

CodeStatusBedeutung
accountDeletionSoleOwner409Der Aufrufer ist der letzte aktive Administrator (role = 'admin') seiner Organisation. Seinen User zu löschen hinterließe eine Organisation ohne Zugang, mit laufenden Monitoren und laufender Abrechnung, dieser Fall führt stattdessen auf die Organisations-Kündigung. data.organizationId nennt die Organisation. Sobald ein zweiter Administrator ernannt ist, gelingt dieselbe Anforderung.
accountDeletionNotRequested404Das DELETE auf /api/account/deletion-request fand keine offene Anforderung zum Widerruf. Entweder wurde nie eine gestellt, oder sie ist bereits vollzogen.
accountDeletionUserNotFound404Das Konto existiert in der Organisation des Aufrufers nicht.
accountDeletionNotRecorded409Die Anforderung konnte nicht festgehalten werden, weil sie beim Schreiben gleichzeitig in einer anderen Sitzung widerrufen wurde. Ein erneuter Versuch ist unbedenklich.

USt-IdNr.-Validierung: Fehlercodes

POST /api/organizations/:organizationPublicId/vat-id/validate (siehe USt-IdNr. validieren) kann zusätzlich zu den Standard-Codes 401 unauthorized, 403 forbidden und 404 organizationNotFound diese data.code-Werte liefern:

CodeStatusBedeutung
vatIdMissing422Für die Organisation ist keine vatId gespeichert. Setze zuerst eine mit Organisation aktualisieren.
vatIdChangedDuringValidation409vatId oder countryCode wurde gleichzeitig geändert, während die VIES-Abfrage lief. Das noch laufende Ergebnis wird verworfen, statt auf Daten geschrieben zu werden, die so nie geprüft wurden. Gefahrlos wiederholbar.

Update Billing Details: benötigter Body

Endpoint:

  • PATCH /api/organizations/:organizationPublicId/billing

Aktuell unterstützter Request-Body:

{
  "billingEmail": "billing@deinkunde.com"
}

Der Endpoint akzeptiert derzeit nur billingEmail.

Weitere Fehlercodes

Diese data.code-Werte kommen von Endpunkten, die ein Kunde erreichen kann. Endpunkte stehen als Klartext (Methode und Pfad, :id steht für die Public ID oder die numerische ID). Verzweige auf data.code, nie auf den Meldungstext.

Abrechnung und Organisation

CodeBedeutung
billingAlreadyActive(400, POST /api/organizations/:id/mollie/subscription) Die Organisation hat bereits eine aktive Abrechnung. Erst die bestehende Abrechnung kündigen oder den nächsten Abrechnungszeitraum abwarten.
billingAlreadyEnabled(400, POST /api/organizations/:id/mollie/trial) Die Abrechnung ist für diese Organisation schon eingeschaltet; es startet keine Testphase.
concurrentWrite(409, POST /api/organizations/:id/mollie/subscription) Gleichzeitig lief eine andere Änderung an der Abrechnung. Anfrage wiederholen.
mandateRequired(400, POST /api/organizations/:id/mollie/subscription) Es gibt noch kein SEPA-Mandat. Erst das Zahlungsmandat einrichten, dann das Abo anlegen.
paymentMethodNotRequired(400, POST /api/organizations/:id/mollie/trial und POST /api/organizations/:id/mollie/mandate) Alle Pakete kosten über individuelle Preise 0,00, eine Zahlungsart ist nicht nötig.
noActiveSubscription(403 beim Anlegen oder Aktivieren eines Monitors jedes Typs: POST oder PATCH auf /api/websites, /api/dns-monitors, /api/icmp-monitors, /api/tcp-monitors, /api/smtp-monitors, /api/ssh-monitors, /api/ftp-monitors, /api/imap-pop-monitors, /api/customer-domains, /api/customer-ips sowie POST /api/customers/:id/domains und /ips. Organisationen mit Rechnungszahlung sind nicht betroffen; 400 bei DELETE /api/organizations/:id/mollie/subscription und POST /api/organizations/:id/mollie/cancel) Die Organisation hat kein aktives Abo. Erst die Abrechnung reaktivieren, dann Monitore anlegen oder aktivieren. Das gilt auch, nachdem das Monitoring endete (Testphase abgelaufen oder gekündigt) und die kostenlosen Statusseiten weiterlaufen, bis wieder eine Zahlungsmethode hinterlegt ist. Dasselbe 403 erhalten Organisationen, die nur Statusseiten nutzen (Statusseiten-Modul aktiv, kein Monitoring-Paket gebucht): erst Monitoring buchen. Organisationen mit Rechnungszahlung sind nicht betroffen.
subscriptionNotRequired(400, POST /api/organizations/:id/mollie/cancel) Diese Organisation braucht kein bezahltes Abo, es gibt nichts zu kündigen.
noActiveTrial(400, POST /api/organizations/:id/mollie/trial/skip und POST /api/organizations/:id/mollie/trial/cancel) Für diese Organisation läuft keine Testphase.
noMollieCustomer(400, POST /api/organizations/:id/mollie/trial/reconcile) Für diese Organisation ist kein Mollie-Kunde hinterlegt, es gibt nichts abzugleichen.
trialAlreadyActive(400, POST /api/organizations/:id/mollie/trial) Eine Testphase läuft bereits.
trialForfeited(403, POST /api/organizations/:id/mollie/trial) Die Organisation wurde gekündigt und hat ihre Testphase verwirkt, oder ihr Monitoring ist beendet (Testphase abgelaufen, Kündigung, offene Rechnung) und sie läuft als reine Statusseiten-Organisation weiter; es entsteht kein neuer Checkout. Zurück zum Monitoring geht es dann nur kostenpflichtig über eine Zahlungsmethode.
trialNotAvailableForQuota(400, POST /api/organizations/:id/mollie/trial) Die Testphase gibt es nur für das Kontingent mit 25 Websites.
trialSkipNotSupported(400, POST /api/organizations/:id/mollie/trial/skip) Die Testphase lässt sich nur bei monatlicher Abrechnung überspringen.
invalidPricingData(500, POST /api/websites, PATCH /api/websites/:id, GET /api/organizations/:id/trial-status, POST /api/organizations/:id/mollie/cancel) Die Monatssumme ließ sich nicht berechnen. Serverseitiges Problem; bitte an den Support melden.
discountAlreadyApplied(409, POST /api/organizations/:id/billing/discount) Auf diese Organisation ist schon ein Rabattcode angewendet.
invalidDiscountCode(422, POST /api/organizations/:id/billing/discount) Der Rabattcode ist ungültig oder abgelaufen.
tooManyDiscountAttempts(429, POST /api/organizations/:id/billing/discount) Zu viele Versuche mit Rabattcodes. Vor dem nächsten Versuch warten.
discountRateLimitUnavailable(503, POST /api/organizations/:id/billing/discount) Die Prüfung von Rabattcodes ist gerade nicht verfügbar. Gleich erneut versuchen.
discountNotFound(404, DELETE /api/organizations/:id/billing/discount) Es ist kein Rabattcode angewendet.
missingInvoiceId(400, GET /api/organizations/:id/invoices/:invoiceId/pdf) Die Rechnungs-ID fehlt.
invoiceNotFound(404, GET /api/organizations/:id/invoices/:invoiceId/pdf) Die Rechnung gibt es für diese Organisation nicht.
invoiceProviderFailed(502, GET /api/organizations/:id/invoices/:invoiceId/pdf) Der Buchhaltungsanbieter konnte das Rechnungs-PDF nicht liefern (Fehler oder nicht erreichbar). Das liegt nicht an deiner Sitzung oder deinen Rechten; versuche es später erneut.
invalidQuotaSelection(400, PATCH /api/organization/quota) Die Kontingentauswahl im Body ist ungültig; data.issues listet die Prüffehler.
mfaRequiredForActor(400, PATCH /api/organizations/:id) Wer die Regel zur Zwei-Schritt-Verifizierung der Organisation ändern will, muss sie zuerst am eigenen Konto einschalten.
smsCapRaiseForbidden(403, PATCH /api/organization, PATCH /api/organizations/:id) Ein Organisations-Admin setzt smsOverageSafetyCapCentsMonthly frei von 0 bis smsOverageSafetyCapMaxCentsMonthly, dem Höchstwert, den ein Plattform-Admin je Organisation festlegt (anheben und senken). Ohne Höchstwert darf er die Obergrenze nur senken (auf jeden Wert, solange keine gesetzt ist). Entfernen (null) bleibt immer Plattform-Admins vorbehalten. data.maxCents ist der wirksame Höchstwert: der Höchstwert, wenn gesetzt, sonst die gespeicherte Obergrenze (null, wenn beides fehlt).

Kunden, Pakete und Kunden-IPs

CodeBedeutung
customerCreationFailed(500, POST /api/customers) Der Kunde ließ sich nicht anlegen.
domainCreationFailed(500, POST /api/customers/:id/domains) Die Kundendomain ließ sich nicht anlegen.
ipCreationFailed(500, POST /api/customers/:id/ips) Die Kunden-IP ließ sich nicht anlegen.
invalidIpAddress(400, POST /api/customers/:id/ips) Die Adresse ist keine gültige IPv4- oder IPv6-Adresse, oder sie liegt (seit dem 11.11.2026) in einem privaten, Loopback-, Link-Local- oder Dokumentationsbereich (zum Beispiel 10.0.0.0/8, 192.168.0.0/16, 127.0.0.0/8, 203.0.113.0/24), den keine Blockliste je führt.
ipNotFound(404, GET und PATCH /api/customer-ips/:id, GET /api/customer-ips/:id/check-history) Die Kunden-IP gibt es nicht oder sie liegt außerhalb des Scopes.
customerIpActivationInProgress(429, PATCH /api/customer-ips/:id) Gerade läuft schon eine andere Aktivierung einer Kunden-IP. Erneut versuchen.
lockUnavailable(503, PATCH /api/customer-ips/:id) Die Aktivierungssperre ließ sich nicht setzen. Gleich erneut versuchen.
packageNotFound(404, DELETE /api/organizations/:id/package-configs, DELETE /api/organizations/:id/package-configs/:packageType, GET /api/organizations/:id/package-configs/:packageType/stats) Das Paket gibt es nicht.
packageInUse(409, DELETE /api/organizations/:id/package-configs und DELETE /api/organizations/:id/package-configs/:packageType) Das Paket ist noch Kunden zugeordnet. Diese Kunden zuerst umstellen.
packageConfigConflict(409, DELETE /api/organizations/:id/package-configs/:packageType) Die Paketkonfiguration wurde gleichzeitig geändert. Erneut versuchen.

Monitore

CodeBedeutung
checkCooldown(429, die Endpunkte zum Auslösen eines Checks aller Monitorfamilien: websites, dns-monitors, icmp-monitors, smtp-monitors, ssh-monitors, tcp-monitors, ftp-monitors, imap-pop-monitors) Für diesen Monitor wurde gerade erst ein Check ausgelöst. data.retryAfterMs sagt, wie lange zu warten ist, data.cooldownMs ist die volle Sperrzeit.
noLocationsAvailable(503, Check auslösen bei allen Monitorfamilien) Gerade ist kein Prüfstandort aktiv. Später erneut versuchen.
noEligibleLocations(400, Check auslösen bei allen Monitorfamilien) Kein Prüfstandort passt zu den erlaubten Ländern des Monitors. Die erlaubten Länder erweitern.
noEligibleLocationSelected(503, Check auslösen bei allen Monitorfamilien außer DNS) In diesem Moment ließ sich kein passender Standort wählen. Später erneut versuchen.
heartbeatChecksNotSupported(400, POST /api/websites/:id/trigger-check) Heartbeat-Monitore pingst du selbst an, sie lassen sich nicht manuell prüfen.
urlRequired(400, POST /api/websites) url fehlt, bei DNS-Monitoren der Hostname. Nur Heartbeat-Monitore dürfen sie weglassen.
heartbeatMonitorRequired(400, POST /api/websites/:id/heartbeat-token/rotate) Nur Heartbeat-Monitore haben ein Token, das sich erneuern lässt.
heartbeatTokenAlreadyExists(409, POST /api/websites) Der Heartbeat-Token wird schon von einem anderen Monitor benutzt. Einen anderen Token wählen oder weglassen.
expectedStateNotSupported(400, POST /api/websites und PATCH /api/websites/:id, Teil- und Voll-Update) expectedState: "down" kam für einen Monitor, der kein Heartbeat-Monitor ist. Nur Heartbeat-Monitore lassen sich umdrehen; alle anderen Website-Typen akzeptieren nur up. TCP-Monitore haben ihr eigenes expectedState und antworten nie mit diesem Code.
websiteCreationInProgress(429, POST /api/websites) Für diese Organisation wird gerade schon eine Website angelegt. Erneut versuchen. Der Header Retry-After und data.retryAfter nennen die Sekunden, die die Sperre noch gehalten wird (höchstens 15).
monitorActivationInProgress(429, Anlegen oder Aktivieren von Monitoren aller Familien, von Kundendomains und Kunden-IPs) Eine andere Aktivierung läuft und hält die Kontingentsperre. Erneut versuchen. Der Header Retry-After und data.retryAfter nennen die Sekunden, die die Sperre noch gehalten wird (höchstens 15).
playwrightScriptRequired(400, PATCH /api/websites/:id) playwrightScript ist Pflicht, wenn monitoringType playwright ist.
customerWrongOrganization(400, PATCH auf Websites und auf DNS-, ICMP-, SMTP-, SSH-, TCP-, FTP- und IMAP/POP-Monitore) Der Zielkunde gehört zu einer anderen Organisation als der Monitor.
invalidManagementType(400, PATCH bei allen Monitorfamilien) managementType ist weder managed noch self_service.
ftpConfigRequired(400, POST /api/ftp-monitors und PATCH /api/ftp-monitors/:id) ftpConfig.user und ftpConfig.password sind Pflicht.
imapPopConfigRequired(400, POST /api/imap-pop-monitors und PATCH /api/imap-pop-monitors/:id) imapPopConfig.user und imapPopConfig.password sind Pflicht.
smtpConfigRequired(400, POST /api/smtp-monitors und PATCH /api/smtp-monitors/:id) smtpConfig.auth.user und smtpConfig.auth.pass sind Pflicht.
sshConfigRequired(400, POST /api/ssh-monitors und PATCH /api/ssh-monitors/:id) sshConfig.username und entweder sshConfig.password oder sshConfig.privateKey sind Pflicht.
invalidIcmpConfig(400, PATCH /api/icmp-monitors/:id) icmpConfig ist ungültig; statusMessage nennt das erste Problem.
invalidStatusFilter(400, Listen-Endpunkte GET /api/websites, die Listen aller Protokoll-Monitorfamilien, GET /api/customer-ips, GET /api/customer-domains) Der Filter status hat einen unbekannten Wert.
invalidSortBy(400, GET /api/websites und die Listen aller Protokoll-Monitorfamilien) sortBy nennt eine unbekannte Spalte.
invalidMonitoringType(400, GET /api/websites) monitoringType oder excludeMonitoringType hat einen unbekannten Wert.
invalidHttpMethod(400, GET /api/websites) Der Filter httpMethod hat einen unbekannten Wert.
invalidOrganizationId(400, Listen der DNS-, ICMP-, SMTP-, SSH-, TCP-, FTP- und IMAP/POP-Monitore, GET /api/dashboard-data, GET /api/onboarding-status, GET /api/onboarding-details, GET /api/onboarding/wizard) Der Parameter organizationId ist keine gültige Organisations-ID.
invalidCheckType(400, GET /api/websites/:id/check-history) checkType hat einen unbekannten Wert.
locationIdRequired(400, GET /api/websites/:id/location-series) locationId fehlt oder ist keine positive Ganzzahl.
badRequest(400, GET /api/monitor-tags) monitorType ist unbekannt oder monitorId keine Ganzzahl.
websiteIdsRequired(400, POST /api/websites/summary und POST /api/maintenance-windows/check/batch) Der Body braucht ein Array websiteIds.
invalidWebsiteIds(400, POST /api/websites/summary und POST /api/maintenance-windows/check/batch) Mindestens ein Eintrag in websiteIds ist keine gültige Kennung.
tooManyWebsiteIds(400, POST /api/websites/summary) Zu viele websiteIds in einer Anfrage; die Anfrage aufteilen.
batchSizeExceeded(400, POST /api/maintenance-windows/check/batch) Der Stapel ist größer als erlaubt; die Anfrage aufteilen.
updateFailed(500, PATCH /api/websites/:id, PATCH /api/websites/:id/check-config, PATCH /api/status-pages/:id) Die Änderung ließ sich nicht speichern.
delete_failed(500, DELETE /api/websites/:id) Die Website ließ sich nicht löschen. Alter Code in snake_case.
invalidPeriod(400, GET /api/websites/:id/report.pdf) period muss last-week, last-month oder last-quarter sein.
missingScreenshotId(400, GET /api/screenshots/:id) Die Screenshot-ID fehlt.
checkNotFound(404, GET /api/screenshots/:id) Den Check zum Screenshot gibt es nicht oder er liegt außerhalb des Scopes.
screenshotNotFound(404, GET /api/screenshots/:id) Den Screenshot gibt es nicht oder er ist abgelaufen.

Wartungsfenster

CodeBedeutung
mixedCustomers(400, POST /api/maintenance-windows und PATCH /api/maintenance-windows/:id) Alle gewählten Ziele müssen zum selben Kunden gehören.
mixedTagOrganizations(400, POST /api/maintenance-windows und PATCH /api/maintenance-windows/:id) Alle gewählten Etiketten müssen zu einer Organisation gehören.

Incidents und Änderungswünsche

CodeBedeutung
idRequired(400, die Incident-Endpunkte unter /api/incidents/:id) Die Incident-ID fehlt im Pfad.
incidentNotFound(404, GET /api/incidents/:id und die übrigen Incident-Endpunkte, auch die IM-Aktionen an Incidents) Den Incident gibt es nicht oder er liegt außerhalb des Scopes, auch ein Incident einer anderen Organisation (GET /api/incidents/:id antwortete dafür bis zum 20.10.2026 mit 403).
incidentNoCustomer(400, schreibende Incident-Endpunkte und IM-Aktionen an Incidents) Der Incident hängt an keinem Kunden, die Zugriffsprüfung kann ihn nicht zuordnen.
incidentTargetRequired(400, POST /api/incidents, PATCH /api/incidents/:id) Ein manueller Vorfall braucht einen Kunden oder mindestens eine Statusseite: customerId und statusPageIds fehlen beide, oder die letzte Statusseite eines Vorfalls ohne Kunden würde entfernt.
invalidWebsite(400, POST /api/incidents) Die Website gehört nicht zu diesem Kunden.
invalidStartedAt(400, POST /api/incidents) startedAt ist kein gültiges Datum.
backfillInFuture(400, POST /api/incidents/backfill) startedAt, resolvedAt oder ein Update liegt in der Zukunft. Ein nachgetragener Vorfall ist vorbei.
backfillTooOld(400, POST /api/incidents/backfill) startedAt liegt mehr als 90 Tage vor dem Anlegen der ältesten genannten Statusseite; so weit reicht kein Verfügbarkeitsbalken zurück.
invalidDateRange(400, POST /api/incidents/backfill, neben den Historien-Endpunkten) startedAt liegt nicht vor resolvedAt, oder ein Update liegt außerhalb davon.
postmortemIncidentNotResolved(409, POST /api/incidents/:id/postmortem/publish, neben IM) Der Vorfall ist auf seinen Statusseiten noch nicht behoben; die Nachbetrachtung erst danach veröffentlichen.
postmortemNotFound(404, POST und DELETE /api/incidents/:id/postmortem/publish, neben IM) Veröffentlichen: kein Text gespeichert und keiner mitgeschickt. Zurücknehmen: die Nachbetrachtung ist nicht veröffentlicht.
createFailed(500, POST /api/incidents) Der Incident ließ sich nicht anlegen.
sreAttributionNotFound(404, POST /api/incidents/:id/sre-attribution-feedback) Der Incident hat keine Zuordnung, zu der sich Rückmeldung geben ließe.
alreadyResolved(409, PATCH /api/change-requests/:id) Der Änderungswunsch ist bereits erledigt.

Nutzer, Registrierung und Anmeldung

CodeBedeutung
emailNotVerified(403, jede authentifizierte API-Route außer den Auth-, Bootstrap- und öffentlichen Statusseiten-Routen, solange die E-Mail-Adresse des Kontos unbestätigt ist; außerdem POST /api/organization/mail-templates/test-send) Erst die E-Mail-Adresse bestätigen.
onboardingStatusUnavailable(503, API-Routen, die ein abgeschlossenes Onboarding voraussetzen) Der Onboarding-Status ließ sich nicht lesen. Erneut versuchen.
missingFields(400, POST /api/auth/register) Firmenname, E-Mail oder Passwort fehlt.
registrationFailed(422 oder 500, POST /api/auth/register) Die Registrierung ließ sich nicht abschließen. Der Grund wird bewusst nicht genannt.
legalVersionMissing(500, POST /api/auth/register) Die Registrierung ist vorübergehend nicht möglich, weil keine Version der Rechtstexte in Kraft ist.
organizationCreationFailed(500, POST /api/auth/register) Die Organisation ließ sich nicht anlegen.
emailRequired(400, POST /api/auth/forget-password) email fehlt.
invalidRedirectTo(400, POST /api/auth/forget-password) redirectTo ist nicht erlaubt: protokollrelativ, nicht lesbar, auf fremdem Origin oder nicht die Seite zum Zurücksetzen des Passworts.
newPasswordRequired(400, POST /api/auth/set-password) newPassword fehlt.
setupSessionMissing(401, POST /api/auth/set-password) Keine aktive Einrichtungssitzung: Der Einrichtungslink wurde schon benutzt, in einem anderen Browser oder von einem Mail-Scanner geöffnet. Stattdessen „Passwort vergessen“ nutzen.
passwordAlreadySet(400, POST /api/auth/set-password) Das Konto hat bereits ein Passwort.
mfa_invalid_code(401, POST /api/account/mfa/step-up) Der Bestätigungscode ist falsch. Alter Code in snake_case.
emailAndRoleRequired(400, POST /api/users) email und role sind Pflicht.
emailAlreadyExists(400, POST /api/users) Es gibt schon einen Nutzer mit dieser E-Mail-Adresse.
emailAlreadyExists(400, POST /api/users/:id/email-change und POST /api/account/email-change) Ein anderes Mitglied deiner Organisation meldet sich schon mit dieser Adresse an. Eine Adresse, die einem Konto außerhalb deiner Organisation gehört, wird nicht genannt: die Anfrage antwortet wie bei einer freien Adresse, es geht kein Link raus.
emailUnchanged(400, POST /api/users/:id/email-change und POST /api/account/email-change) Die neue Adresse ist die bisherige.
emailChangeLinkInvalid(400, POST /api/auth/email-change/confirm) Der Bestätigungslink ist unbekannt, abgelaufen (24 Stunden), schon benutzt, durch eine neuere Anfrage ersetzt, oder die Adresse des Kontos hat sich inzwischen geändert. Beantrage die Änderung neu.
invalidPassword(400, POST /api/account/email-change) Das aktuelle Passwort ist falsch.
emailSendFailed(502, POST /api/users/:id/email-change und POST /api/account/email-change) Der Bestätigungslink ließ sich nicht versenden. Die Adresse bleibt unverändert; versuche es noch einmal.
customerIdsMultipleOrgs(400, POST /api/users) Alle customerIds müssen zu einer einzigen Organisation gehören.
userCreationFailed(500, POST /api/users) Der Nutzer ließ sich nicht anlegen.
invalidRole(400, PATCH /api/users/:id) role ist keine der erlaubten Rollen; die Meldung zählt sie auf.
selfDeletionNotAllowed(400, DELETE /api/users/:id) Das eigene Konto lässt sich über diesen Endpunkt nicht löschen.
userDeletionFailed(500, DELETE /api/users/:id) Der Nutzer ließ sich nicht löschen.
missingUserId(400, POST /api/users/:id/mfa/reset und GET /api/assets/avatar/:userId) Die Nutzer-ID fehlt.
avatarNotFound(404, GET /api/assets/avatar/:userId) Den Nutzer gibt es nicht, er gehört zu einer anderen Organisation oder hat kein Profilbild.
contentTypeMismatch(400, POST /api/user/avatar und POST /api/users/:id/avatar) Die hochgeladenen Bytes passen nicht zum angegebenen Bildtyp.

Single Sign-on und OAuth

CodeBedeutung
ssoAdminOnly(403, alle Endpunkte unter /api/organization/sso) Nur Organisations-Admins dürfen SSO verwalten.
ssoNoOrganization(400, alle Endpunkte unter /api/organization/sso) Die Sitzung hängt an keiner Organisation.
ssoInvalidInput(400, PUT /api/organization/sso, POST /api/organization/sso/test) Ein SSO-Feld fehlt oder ist ungültig; data.field nennt es (z. B. clientSecret, idpMetadataXml).
ssoDiscoveryFailed(400, PUT /api/organization/sso) Das OIDC-Discovery-Dokument des Ausstellers ließ sich nicht laden, nennt einen anderen Aussteller als eingegeben oder es fehlt ein HTTPS-Endpunkt (authorization_endpoint, token_endpoint, jwks_uri; userinfo_endpoint falls angegeben).
ssoSamlMetadataInvalid(400, PUT /api/organization/sso) Die SAML-IdP-Metadaten sind ungültig, oder ihre Anmelde-URL ist kein HTTPS.
ssoDomainTaken(409, PUT /api/organization/sso) Die Domain nutzt schon das SSO einer anderen Organisation.
ssoEnforceNotAllowed(409, PUT /api/organization/sso) „Nur SSO“ lässt sich erst einschalten, wenn die Domain bestätigt ist und eine SSO-Anmeldung geklappt hat.
ssoNotConfigured(404, POST /api/organization/sso/verify-domain, POST /api/organization/sso/test ohne issuer; 400, POST /api/status-pages und PATCH /api/status-pages/:id mit visibility: sso_members_only) SSO ist noch nicht eingerichtet; bei einer Statusseite: Die Organisation hat kein bestätigtes SSO.
unknownOauthClient(404, GET /api/oauth/consent-context) Der OAuth-Client ist unbekannt.
consentForwardFailed(502, POST /api/oauth/consent) Die Zustimmung wurde angenommen, aber es kam keine Weiterleitungs-URI zurück, an die der Client geschickt werden könnte.

API-Tokens und Push-Tokens

CodeBedeutung
customerIdRequired(400, POST /api/customer/tokens) customerId ist Pflicht.
invalidTokenId(400, DELETE und PATCH /api/organization/tokens/:id, DELETE /api/customer/tokens/:id) Die Token-ID ist ungültig.
tokenNotFound(404, DELETE und PATCH /api/organization/tokens/:id, DELETE /api/customer/tokens/:id) Den Token gibt es nicht oder er liegt außerhalb des Scopes.
tokenCreationFailed(500, POST /api/organization/tokens) Der API-Token ließ sich nicht anlegen.
tokenDeletionFailed(500, DELETE /api/organization/tokens/:id) Der API-Token ließ sich nicht löschen.
imPushTokenNotFound(404, DELETE /api/im/push-tokens/:token) Der Push-Token ist für diesen Nutzer nicht registriert.

Statusseiten und eigene Domains

CodeBedeutung
invalidSlug(400, POST /api/status-pages und PATCH /api/status-pages/:id) Der Slug hat ein ungültiges Format.
domainVerificationFailed(400, POST /api/status-pages/domains/verify, POST /api/organization/whitelabel/domains/verify) Der TXT-Eintrag mit dem Bestätigungs-Token wurde nicht gefunden. data.recordName ist der abgefragte Name, data.expected der erwartete Wert, data.observed die tatsächlich gesehenen TXT-Werte (höchstens 10) und data.lookup das Ergebnis der Abfrage: records (Werte gefunden, keiner passt), noRecords (Name existiert ohne TXT), nxdomain (Name existiert nicht), timeout oder error. data.nameservers nennt die delegierte Zone und ihre autoritativen Nameserver, data.authoritative die direkte Antwort eines davon, data.propagation liest beides zusammen (propagating, not_published, unknown). Der Fehlschlag bleibt als lastVerificationError / lastVerificationErrorAt an der Domain, bis die nächste Verifizierung gelingt; GET /api/status-pages/domains/{id}/diagnostics und GET /api/organization/whitelabel/domains/{id}/diagnostics prüfen DNS und Zertifikat live.
brandingAssetNotFound(404, DELETE /api/organization/whitelabel/branding/:kind) Für diese Art Logo oder Favicon ist nichts hochgeladen, auch beim zweiten DELETE.
invalidBrandingAssetKind(400, DELETE /api/organization/whitelabel/branding/:kind) kind ist keiner von logo, logoLight, logoDark, favicon, faviconLight, faviconDark.
slugOrHostnameAlreadyExists(409, POST /api/status-pages) Slug oder Hostname ist schon vergeben.
statusPageHasNoCustomer(400, POST /api/status-pages/:id/change-requests) Die Statusseite hat keinen Kunden (customerId: null), es gibt also niemanden, der fragen könnte: Eine solche Seite nimmt keine Änderungsanfragen an. Ändere sie direkt mit einer organisationsweiten Rolle.
statusPageLimitReached(409, POST /api/status-pages, POST /api/status-pages/:id/components, POST /api/status-pages/:id/groups, POST /api/status-pages/public/:slug/subscribe, POST /api/status-pages/templates) Das Paket des Kunden erlaubt keine weiteren Statusseiten (maxStatusPages, auch beim Umhängen einer Seite zu diesem Kunden), die Organisation hat schon 200 Vorlagen, oder die Seite hat schon 500 Komponenten, 500 Gruppen oder 50 Webhook-, Slack- und Teams-Abos; data.max nennt die Grenze. Statusseiten je Organisation sind unbegrenzt.
statusPageMaintenanceNotFound(404, GET, PATCH und DELETE /api/status-pages/maintenances/:id und seine Aktionen) Die geplante Wartung existiert nicht, gehört zu einer anderen Organisation oder steht auf einer Statusseite außerhalb deines Kundenbereichs.
statusPageMaintenanceClosed(409, PATCH /api/status-pages/maintenances/:id, POST .../cancel, .../complete, .../updates) Die Wartung ist abgesagt, oder die Aktion passt nicht zu ihrem Zustand: absagen lässt sich nur eine bevorstehende, beenden nur eine laufende Wartung.
customCssInvalid(400, PATCH /api/status-pages/:id/design, PATCH /api/status-pages/:id mit designConfig) Das eigene CSS wurde abgelehnt; data.reason nennt den Grund: syntax, atRuleNotAllowed, functionNotAllowed, urlNotAllowed, propertyNotAllowed, escapeNotAllowed, htmlNotAllowed oder controlCharacter.
customCssTooLarge(400, dieselben Routen) Das eigene CSS ist größer als 20000 Bytes; data.max nennt die Grenze.
statusPageComponentNotFound(404, PATCH und DELETE /api/status-pages/:id/components/:componentId, PUT /api/status-pages/:id/components/order, POST /api/status-pages/public/:slug/subscribe; 400, PATCH /api/status-pages/:id mit audienceGroups) Die Komponente gibt es auf dieser Statusseite nicht.
subscriptionPhoneInvalid(400, POST /api/status-pages/public/:slug/subscribe) phone ist keine Mobilnummer im internationalen Format (+ oder 00, Ländervorwahl, 8 bis 15 Ziffern).
subscriptionPushInvalid(400, POST /api/status-pages/public/:slug/subscribe) pushSubscription.keys sind kein öffentlicher P-256-Schlüssel (p256dh, 65 Byte) mit 16-Byte-auth-Geheimnis, base64url.
subscriptionTargetUrlInvalid(400, POST /api/status-pages/public/:slug/subscribe) targetUrl ist keine gültige https-URL oder enthält Zugangsdaten.
subscriptionTargetUrlRejected(400, POST /api/status-pages/public/:slug/subscribe) targetUrl zeigt auf eine Loopback-, private, Link-Local- oder sonst nicht öffentliche Adresse; Statusseiten-Nachrichten gehen nur an öffentliche Hosts.
statusPageComponentNotOnPage(400, POST /api/incidents, PATCH /api/incidents/:id, POST und PATCH /api/im/statuspage-rules) Die Komponente gehört zu einer Statusseite, die in der Anfrage nicht genannt ist (statusPageIds bzw. statusPageId der Regel).
statusPageCustomerMismatch(400, POST /api/incidents, PATCH /api/incidents/:id) Die Statusseite gehört einem anderen Kunden als der Vorfall; der Vorfall eines Kunden darf nur auf Seiten ohne Kunden oder dieses Kunden.
statusPageIdsRequired(400, POST /api/incidents, PATCH /api/incidents/:id) componentIds kam ohne statusPageIds.
statusPageComponentDependencyConflict(409, POST /api/status-pages/:id/components) Der Anbieter ist schon Komponente dieser Statusseite; ein Anbieter steht höchstens einmal je Seite.
statusPageComponentGroupNotFound(404, PATCH und DELETE /api/status-pages/:id/groups/:groupId und jeder Komponenten-Endpunkt, der eine groupId nimmt) Die Gruppe gibt es auf dieser Statusseite nicht.
statusPageComponentMonitorConflict(409, POST /api/status-pages/:id/components, PATCH /api/status-pages/:id/components/:componentId) Der Monitor ist schon Komponente dieser Statusseite; ein Monitor steht höchstens einmal je Seite.
statusPageComponentMonitorCustomerMismatch(400, POST /api/status-pages/:id/components und PATCH /api/status-pages/:id) Der Monitor gehört einem anderen Kunden als die Statusseite, oder die Seite soll zu einem Kunden wechseln, dem nicht alle ihre Monitor-Komponenten gehören.
statusPageComponentNotManual(400, PATCH /api/status-pages/:id/components/:componentId) manualStatus wurde für eine Komponente gesendet, die nicht manuell ist (oder wird); einen manuellen Zustand haben nur manuelle Komponenten.
statusPageComponentSourceInvalid(400, PATCH /api/status-pages/:id/components/:componentId) Der Wechsel der Quelle geht nicht: sourceKind: "monitor" ohne monitorType/monitorId bei einer manuellen Komponente, ein Monitor zusammen mit sourceKind: "manual" oder eine dependency-Komponente (sie behält ihren Anbieter).
statusPageSmsUnavailable(403, POST /api/status-pages/public/:slug/subscribe) Eine sms-Anmeldung für eine Seite, die Abos annimmt, SMS aber gerade nicht anbietet (ausgeschaltet, kein SMS-Versand auf der Plattform oder kein SMS-Kontingent der Organisation). Derselbe Zustand wie smsSubscriptionsEnabled: false auf der öffentlichen Seite.
statusPageTemplateNotFound(404, GET, PATCH und DELETE /api/status-pages/templates/:id) Die Vorlage gibt es nicht, oder sie gehört einer anderen Organisation.
statusPagesModuleDisabled(403, jeder nicht öffentliche Endpunkt unter /api/status-pages außer GET /api/status-pages/module und POST /api/status-pages/module/activate; POST /api/incidents und PATCH /api/incidents/:id mit nicht leerem statusPageIds) Das Statusseiten-Modul wurde für diese Organisation nicht aktiviert. Vorfälle ohne Statusseiten funktionieren weiter.
domainVerificationTokenFailed(500, POST /api/status-pages) Der Token zur Domain-Bestätigung ließ sich nicht anlegen.
passwordRequired(400, POST /api/status-pages und PATCH /api/status-pages/:id: Passwortschutz ohne Passwort eingeschaltet; 400, POST /api/status-pages/public/:slug/verify-password: leeres Passwort; 401, GET /api/status-pages/public/:slug und GET /api/status-pages/public/by-id/:id: die Seite ist passwortgeschützt, erst das Passwort prüfen lassen)
invalidPassword(401, POST /api/status-pages/public/:slug/verify-password) Das Passwort der Statusseite ist falsch.
statusPageNotPublic(403, GET /api/status-pages/public/:slug und GET /api/status-pages/public/by-id/:id) Die Statusseite ist nicht öffentlich erreichbar.
statusPageIpNotAllowed(403, GET /api/status-pages/public/:slug, GET /api/status-pages/public/by-id/:id und POST /api/status-pages/public/:slug/verify-password) Die Seite hat eine IP-Freigabeliste, und die Anfrage kommt aus einem anderen Netz. Das Passwort wird dann nicht geprüft.
ssoRequired(401, GET /api/status-pages/public/:slug und GET /api/status-pages/public/by-id/:id) Die Seite hat visibility: sso_members_only, und der Besucher ist nicht oder ohne das Single Sign-on der Organisation angemeldet.
slugRequired(400, GET /api/status-pages/public/:slug und POST /api/status-pages/public/:slug/verify-password) Der Slug fehlt.
missingSlug(400, POST /api/status-pages/public/:slug/subscribe und POST /api/status-pages/public/:slug/confirm) Slug oder Public ID fehlt.
missingToken(400, POST /api/status-pages/public/unsubscribe und GET /api/download-center/verify) Der Token fehlt.
invalidId(400, GET /api/status-pages/public/by-id/:id, DELETE /api/organization/whitelabel/domains/:id, die Roadmap-Endpunkte) Die ID im Pfad ist ungültig.
subscriberUnsubscribedNotDeletable(409, DELETE /api/status-pages/:id/subscribers/:subscriberId) Ein abgemeldeter Abonnent lässt sich nicht löschen.
domainCreateFailed(500, POST /api/status-pages/domains) Der Domain-Eintrag ließ sich nicht anlegen.
domainNotBoundToStatusPage(400, POST /api/status-pages/domains/verify und POST /api/status-pages/domains/activate) Die Domain ist an keine Statusseite gebunden.
domainNoVerificationToken(400, POST /api/status-pages/domains/verify und POST /api/organization/whitelabel/domains/verify) Die Domain hat keinen Bestätigungs-Token.
wildcardDomainNotSupported(400, POST /api/organization/whitelabel/domains) Wildcard-Domains werden nicht unterstützt.

Branding, SMTP und Mail-Vorlagen

CodeBedeutung
insufficientRole(403, POST /api/organization/branding/presign und POST /api/organization/branding/confirm) Nur Organisations-Admins dürfen Branding-Dateien hochladen.
unsupportedFileType(400, POST /api/organization/branding/presign) Der Content-Type ist für diese Dateiart nicht erlaubt.
objectKeyEmpty(400, POST /api/organization/branding/confirm) Der objectKey liegt nicht im Upload-Bereich deiner Organisation.
smtpFieldsRequired(400, PATCH /api/organization/smtp) Pflichtfelder der SMTP-Konfiguration lassen sich nicht leeren. Stattdessen das eigene SMTP abschalten.
smsQuotaRequired(403, POST /api/status-pages, PATCH /api/status-pages/:id) smsSubscriptionsEnabled wird eingeschaltet, obwohl deine Organisation keine SMS senden kann: kein Inklusivvolumen mehr, Mehrnutzung aus oder SMS-Deckel erreicht. SMS buchen oder Mehrnutzung einschalten; eine Seite, die SMS-Abos schon an hat, behält sie.
smsCountryNotAllowed(400, POST /api/notification-channels, PATCH /api/notification-channels/:id, POST /api/customers, PATCH /api/customers/:id, PATCH /api/escalation-config/:id) Ein SMS-Alarmziel (config.to / config.phoneNumbers / config.phoneNumber eines sms-Kanals, notificationPhoneNumber, defaultPhoneNumber) steht nicht im internationalen Format, oder seine Ländervorwahl liegt außerhalb von EU/EWR, Schweiz und Vereinigtem Königreich. Alarm-SMS gehen nur in diese Länder.
smtpConfigIncomplete(400, PATCH /api/organization/smtp und POST /api/organization/smtp/test) Die SMTP-Konfiguration ist unvollständig: Host, Port, Benutzername, Passwort und Absenderadresse sind Pflicht.
smtpPasswordMissing(400, POST /api/organization/smtp/test) Ein Benutzername ist gesetzt, aber kein Passwort.
smtpPasswordRequiredForNewHost(400, POST /api/organization/smtp/test) Der Host hat sich geändert, deshalb muss das Passwort neu eingegeben werden.
missingRecipientEmail(400, POST /api/organization/smtp/test) toEmail fehlt.
smtpSendFailed(502, POST /api/organization/smtp/test) Dein SMTP-Server hat die Testmail nicht angenommen; die Meldung enthält seine Antwort.
mailTemplateNotEditable(400, die Endpunkte für Mail-Vorlagen und Bausteine unter /api/organization) Diese Mail ist nicht bearbeitbar.
mailTemplateInvalid(400, PUT /api/organization/mail-templates/template und POST /api/organization/mail-templates/test-send) Die Vorlage ist ungültig; data.issues listet die Probleme, etwa unbekannte Bausteine.
mailTemplateConflict(409, PUT /api/organization/mail-templates/template und PUT /api/organization/mail-snippets/snippet) Jemand anderes hat gleichzeitig gespeichert. Neu laden und die Änderung erneut anwenden.
mailTemplateVersionNotFound(404, POST /api/organization/mail-templates/restore) Die wiederherzustellende Version gibt es nicht.
mailTemplateTestSendMailOnly(400, POST /api/organization/mail-templates/test-send) Testversand gibt es nur für Mails.
mailTemplateTestSendLimit(429, POST /api/organization/mail-templates/test-send) Zu viele Testsendungen. Vor dem nächsten Versuch warten.
mailTemplatePaidPlanRequired(403, PUT /api/organization/mail-templates/template, POST /api/organization/mail-templates/restore und PUT /api/organization/mail-snippets/snippet) Eigene Mail-Vorlagen und Bausteine zu speichern setzt ein bezahltes Paket voraus. Bereits gespeicherte Vorlagen bleiben in Verwendung; Lesen, Vorschau und Zurücksetzen bleiben offen.
emailProviderRejected(502, POST /api/organization/mail-templates/test-send) Der Mail-Anbieter hat die Testmail abgelehnt.
mailSnippetInvalid(400, PUT /api/organization/mail-snippets/snippet) Der Baustein ist ungültig; data.issues listet die Probleme.
mailSnippetInUse(409, DELETE /api/organization/mail-snippets/snippet) Der Baustein wird noch verwendet; data.usedIn listet, wo.
mailAssetNotFound(404, DELETE /api/organization/mail-assets/:id; 400 mit data.assetIds, PUT /api/organization/mail-templates/template und PUT /api/organization/mail-snippets/snippet) Das Bild gibt es in deiner Mediathek nicht.
mailAssetInUse(409, DELETE /api/organization/mail-assets/:id) Das Bild wird noch verwendet; data.usedIn sagt, wie oft.
mailAssetLimit(409, POST /api/organization/mail-assets) Die Mediathek ist voll; data.limit ist die Obergrenze.
mailAssetTooLarge(413, POST /api/organization/mail-assets) Das Bild ist zu groß.
mailAssetType(415, POST /api/organization/mail-assets: nur PNG, JPEG, GIF oder WebP; 400: genau eine Datei erwartet)

Onboarding-Assistent

CodeBedeutung
customerCreateFailed(500, POST /api/onboarding/wizard/customer) Der Kunde ließ sich nicht anlegen.
invalidTarget(400, POST /api/onboarding/wizard/check) Das Ziel ist keine gültige URL und kein gültiger Host.
monitorAlreadyExists(409, POST /api/onboarding/wizard/target) Die Organisation hat schon einen Monitor. (409, POST /api/websites und POST der Protokoll-Monitore dns, ftp, icmp, imap-pop, smtp, ssh, tcp) Dieser Kunde hat schon einen Monitor dieses Typs auf dasselbe Ziel; data.existingId und data.existingPublicId nennen ihn. Mit allowDuplicate: true wird er trotzdem angelegt.
targetHostMonitorLimitReached(403, POST /api/websites und POST der Protokoll-Monitore dns, ftp, icmp, imap-pop, smtp, ssh, tcp) Die Organisation hat schon 100 Monitore auf diesen Ziel-Host, gezählt über alle Monitortypen (exakter Hostname; bei Websites mit connectHost zählt das Ersatzziel, Heartbeat zählt nicht); data.host nennt den normalisierten Host, data.limit die Grenze. Derselbe Code kommt beim PATCH, wenn die Änderung den Monitor auf einen anderen Host legt (hostname, url oder connectHost); ein PATCH ohne Hostwechsel geht immer. allowDuplicate: true hebt die Grenze nicht auf. Sie schützt davor, dass die Checkflotte als Lastgenerator missbraucht wird; für eine höhere Grenze wende dich an den Support.
targetHostPlatformLimitReached(403, dieselben Endpunkte und dieselbe PATCH-Regel wie targetHostMonitorLimitReached) Auf den Ziel-Host zeigen über alle Uptimeify-Kunden schon 300 Monitore, gleich gezählt. data.host nennt den normalisierten Host, data.limit die Grenze; die Meldung verrät nicht, wie viele Monitore andere Organisationen haben. Vorhandene Monitore bleiben bestehen. Musst du den Host überwachen, wende dich an den Support.
monitorCreateFailed(500, POST /api/onboarding/wizard/target) Der Monitor ließ sich nicht anlegen.
channelCreateFailed(500, POST /api/onboarding/wizard/channel) Der Benachrichtigungskanal ließ sich nicht anlegen.
verificationSendFailed(502, POST /api/onboarding/wizard/channel) Die Bestätigungsnachricht ließ sich nicht zustellen.
noAlertAddress(409, POST /api/onboarding/wizard/test-alert) Es ist noch keine Alarm-Adresse eingerichtet.
noMonitor(409, POST /api/onboarding/wizard/test-alert) Es gibt noch keinen Monitor, zu dem ein Testalarm gehen könnte.
testAlertSendFailed(502, POST /api/onboarding/wizard/test-alert) Der Testalarm ließ sich nicht zustellen.
testSendRateLimited(429, POST /api/notification-channels/test, /api/escalation-config/:id/test, /api/organization/smtp/test, /api/organization/sso/test, /api/onboarding/wizard/test-alert, /api/im/sources/:id/test-alert) Mehr als 10 Test-Sendungen pro Minute für deine Organisation, gemeinsam über diese Endpunkte; eine reine Syntaxprüfung (dryRun) zählt nicht. retryAfter nennt die Sekunden bis zum nächsten Fenster.

Roadmap und Fehlermeldungen

CodeBedeutung
featureNotFound(404, die Roadmap-Endpunkte unter /api/roadmap) Den Funktionswunsch gibt es nicht.
featureRequestCreationFailed(500, POST /api/roadmap) Der Funktionswunsch ließ sich nicht anlegen.
commentCreationFailed(500, POST /api/roadmap/:id/comments) Der Kommentar ließ sich nicht anlegen.
invalidCommentId(400, PATCH /api/roadmap/comments/:id) Die Kommentar-ID ist ungültig.
commentNotFound(404, PATCH /api/roadmap/comments/:id) Den Kommentar gibt es nicht.
invalidCursor(400, GET /api/roadmap/:id/comments) Der Seiten-Cursor ist ungültig.
roadmapChallengeMissing(400, POST /api/roadmap, POST /api/roadmap/vote, POST /api/roadmap/:id/comments) Der Nachweis gegen Bots fehlt. Erst eine Challenge über GET /api/roadmap/challenge holen.
roadmapChallengeInvalid(400, dieselben Endpunkte) Token, Signatur, Inhalt, Aktion, Besucher oder Proof of Work der Challenge passen nicht. Eine neue Challenge holen.
roadmapChallengeExpired(400, dieselben Endpunkte) Die Challenge ist abgelaufen. Eine neue holen.
roadmapChallengeUsed(400, dieselben Endpunkte) Die Challenge wurde schon benutzt. Eine neue holen.
roadmapChallengeUnavailable(503, dieselben Endpunkte) Die Prüfung der Challenge ist gerade nicht verfügbar. Gleich erneut versuchen.
roadmapChallengeNotConfigured(500, dieselben Endpunkte und GET /api/roadmap/challenge) Das Challenge-Geheimnis ist auf dem Server nicht eingerichtet.
adminNotesPlatformAdminOnly(403, PATCH /api/bugs/:id) adminNotes setzt nur das Plattform-Team. Das Feld weglassen.

Öffentliche Endpunkte und kostenlose Tools

CodeBedeutung
disposableEmail(422, POST /api/contact und POST /api/waitlist/incident-management) Bitte eine E-Mail-Adresse nutzen, die keine Wegwerfadresse ist.
emailSendFailed(500, POST /api/contact) Die Kontaktmail ließ sich nicht versenden.
downloadRequestInProgress(429, POST /api/resource-downloads/sla-template) Für diese E-Mail-Adresse läuft schon eine Download-Anfrage. Erneut versuchen.
downloadRateLimited(429, POST /api/resource-downloads/sla-template) Zu viele Download-Anfragen für diese E-Mail-Adresse. Später erneut versuchen.
invalidOrExpiredToken(404, GET /api/download-center/verify) Der Download-Link ist ungültig oder abgelaufen.
invalid_plz(400, GET /api/geo/de-city) Die deutsche Postleitzahl ist ungültig. Alter Code in snake_case.
objectionLinksUnavailable(503, GET /api/legal/objection/:token) Widerspruchslinks sind auf dem Server nicht eingerichtet.
objectionNotAvailable(409, POST /api/legal/objection/:token) Diese Mitteilung hat kein Widerspruchsrecht.
objectionDeadlinePassed(409, POST /api/legal/objection/:token) Die Widerspruchsfrist ist abgelaufen.
unsubscribeLinksUnavailable(503, POST /api/public/alert-unsubscribe) Abmeldelinks aus Alarm-Mails sind auf dem Server nicht eingerichtet. Der Link selbst ist nicht kaputt.
invalidBody(400, POST /api/public/dependencies/:slug/report) Der Body der Meldung ist ungültig; statusMessage nennt das erste Problem.
toolResultEmptyBody(400, POST /api/tools/result) Der Body ist leer.
toolResultInvalidJson(400, POST /api/tools/result) Der Body ist kein gültiges JSON.
toolResultTooLarge(413, POST /api/tools/result) Das Ergebnis ist zu groß; data.maxBytes ist die Grenze.
toolResultNotFound(404, GET /api/tools/result/:id) Das geteilte Ergebnis gibt es nicht oder es ist abgelaufen.
serverMisconfigured(500, manchmal 503, z. B. bei Website- und SMTP-Geheimnissen, der Passwortprüfung von Statusseiten, Download-Links für Berichte) Ein nötiges Server-Geheimnis fehlt. Kein Fehler des Clients; bitte an den Support melden.

Plattform- und Admin-Endpunkte

Diese Codes kommen nur aus internen Endpunkten des Uptimeify-Plattformteams (Plattform-Admin, Abrechnungsverwaltung, Sandbox-Kasse) und aus internen Hilfsbausteinen. Sie gehören nicht zur öffentlichen API, weder ein API-Token noch ein normaler Organisations-Login erreicht sie. Sie stehen hier, damit jeder data.code benannt ist.

CodeBedeutung
billingDisabledFreeOrg(400, Plattform-Admin: Abrechnung einer Zahlung erneut anstoßen) Die Organisation zahlt 0,00 für Grundpreis und SMS-Mehrverbrauch, die Abrechnung ist deshalb aus und es gibt nichts zu wiederholen.
billingModeConflict(409, Plattform-Admin: Kontingentpreis, Kontingent-Migration und manuelle Abrechnung einer Organisation) Ein Kontingentpreis über 0 und manuelle Abrechnung schließen sich aus. Nimm die Organisation zuerst aus der anderen Abrechnungsart.
cancellationEnqueueFailed(503, Plattform-Admin: Organisation sofort löschen) Der Löschjob konnte nicht eingestellt werden. data.reverted sagt, ob die Organisation zurückgesetzt wurde; steht dort false, ist sie ohne Job als gekündigt markiert und braucht manuelle Nacharbeit.
confirmNameMismatch(400, Plattform-Admin: Organisation sofort löschen) confirmName stimmt nicht mit dem Organisationsnamen überein. Schick den exakten Namen.
deadlineInThePast(400, Plattform-Admin: Rechtstext-Ankündigung senden oder erneut senden) Die Widerspruchsfrist ist schon abgelaufen. Setz vor dem Versand eine neue Frist.
discountCodeAlreadyExists(409, Plattform-Admin: Rabattcode anlegen) Einen Rabattcode mit diesem Code gibt es schon.
emailOverrideNotSupported(400, Plattform-Admin: Bericht erzeugen) Der Body enthält email, der Empfänger kommt aber immer vom Kunden. Lass das Feld weg.
emptyUpdate(400, Plattform-Admin: Abhängigkeit ändern) Der Body enthält kein Feld zum Ändern.
enqueueFailed(502, Plattform-Admin: Rechtstext-Ankündigung senden, erneut senden oder testweise senden) Der Versandjob konnte nicht eingestellt werden. Versuch es erneut; beim Testversand sagt data.queued, wie viele Sprachen schon eingestellt waren.
enqueueFailedSendStarted(502, Plattform-Admin: Rechtstext-Ankündigung senden) Das Einstellen ist gescheitert, nachdem der Versand schon begonnen hatte. Setz ihn über die Wiederholen-Aktion fort, statt neu zu senden.
fileNotFound(404, Plattform-Admin: Datei im Download-Center ändern) Die Datei gibt es nicht.
indexNowSyncFailed(502, Plattform-Admin: IndexNow-Abgleich) Die Übermittlung an IndexNow ist gescheitert. Versuch es später erneut.
indexNowSyncInProgress(409, Plattform-Admin: IndexNow-Abgleich) Es läuft schon ein IndexNow-Abgleich. Warte, bis er fertig ist.
invalidDateFormat(400, Plattform-Admin: monatlichen Abrechnungslauf auslösen) month (1 bis 12 oder YYYY-MM) oder year ist ungültig.
invalidLexwareId(400, interner Rechnungs-Client) Eine Rechnungs- oder Datei-ID für den Buchhaltungsanbieter (Lexware) ist keine UUID. Der Rechnungs-PDF-Download gibt das derzeit als generic weiter.
invalidNoticeState(400, Plattform-Admin: Rechtstext-Ankündigung ändern oder senden) Die Ankündigung kombiniert Felder, die nicht zusammenpassen, zum Beispiel eine Frist, die nicht zur Art der Änderung passt oder nach dem Inkrafttreten liegt, oder eine AGB- oder AVV-Ankündigung ohne Fassung.
invalidObjectKey(400, Plattform-Admin: Upload ins Download-Center) Der Objektschlüssel muss mit einem öffentlich auslieferbaren Präfix beginnen (branding/, download-center/ oder downloads/).
invalidPrice(400, Plattform-Admin: individuellen Preis einer Organisation setzen) Der Preis muss eine ganze Zahl in Cent sein, 0 oder mehr.
invalidProxyTarget(400, eigener Proxy für das Real-User-Monitoring-Skript) Der angefragte Pfad würde den Collector-Ursprung verlassen, die Anfrage wird abgewiesen.
mollieCustomerOverrideForbidden(400, Plattform-Admin: monatlichen Abrechnungslauf auslösen) mollieCustomerIdOverride gilt nur im Testmodus, oder im Live-Modus, wenn er der eigenen Mollie-Kunden-ID der Zielorganisation entspricht.
noRecipients(400, Plattform-Admin: Bericht erzeugen, Rechtstext-Ankündigung senden) Es gibt keinen Empfänger: Der Kunde hat weder eine Benachrichtigungs- noch eine Kontoadresse, oder die Ankündigung trifft niemanden.
noticeNotEditable(409, Plattform-Admin: Rechtstext-Ankündigung ändern oder löschen) Die Ankündigung ist schon versendet und lässt sich nicht mehr ändern.
noticeNotFound(404, Plattform-Admin: Rechtstext-Ankündigungen) Die Ankündigung gibt es nicht.
organizationAlreadyDeleted(409, Plattform-Admin: Organisation sofort löschen, Löschung zurücknehmen) Die Löschung ist schon abgeschlossen. Die Daten sind weg, die Organisation lässt sich nicht wiederherstellen.
paymentNotFound(404, Sandbox-Kasse, in Produktion nicht verfügbar) Die Testzahlung ist unbekannt.
platformAdminDisabledInCustomerContext(403, jeder Plattform-Admin-Endpunkt) Ein Plattform-Admin arbeitet im Kundenkontext. Die Plattform-Admin-Endpunkte bleiben gesperrt, bis der Kundenkontext verlassen ist.
platformMaintenanceNotFound(404, Plattform-Admin: Plattformwartung ändern oder löschen) Die Plattformwartung gibt es nicht.
publishedAtNotSettable(400, Plattform-Admin: Abhängigkeit anlegen oder ändern) publishedAt lässt sich hier nicht setzen, die Veröffentlichung ist ein eigener Schritt. Lass das Feld weg.
reportNotFound(404, Plattform-Admin: Statusmeldung einer Abhängigkeit ändern) Die Meldung gibt es nicht.
sandboxCheckoutFailed(400, Sandbox-Kasse, in Produktion nicht verfügbar) Der Test-Checkout ließ sich nicht abschließen; statusMessage nennt den Grund.
searchQueryRequired(400, Plattform-Admin: Organisationssuche) Der Query-Parameter q fehlt.
sitemapUnavailable(502, Plattform-Admin: IndexNow-Status) Die Sitemap ließ sich nicht lesen.
versionExists(409, Plattform-Admin: Rechtstext-Fassung anlegen oder Ankündigung mit neuer Fassung anlegen) Diese Fassung des Dokuments gibt es schon.
websiteIdRequired(400, Plattform-Admin: Bericht erzeugen) websiteId fehlt.

Incident Management: SMS und Anruf vor der Bestätigung der Nummer (28.10.2026)

EndpunktÄnderung
POST /api/im/notification-settings/rules, PUT /api/im/notification-settings/channelssms- und voice-Schritte werden auch ohne bestätigte Telefonnummer angenommen (200 statt 422 imPhoneNotVerified; der Code entfällt). Sie werden gespeichert und warten: Jede Alarmierung bis zur Bestätigung steht im Protokoll als übersprungen mit dem Grund unverified.
GET /api/im/notification-settingsNeue Felder lastAdminChangeAt und lastAdminChangeBy: wann und von wem ein Organisations-Admin diese Einstellungen zuletzt gesetzt hat.
GET, PUT /api/im/users/:userId/notification-settings, GET, PUT /api/im/notification-templateNeu: Organisations-Admins setzen die Benachrichtigungskette einer Person und die Standard-Kette für neue Nutzer.

Jeder Fehler trägt einen Code (20.10.2026)

Jede Fehlerantwort trägt jetzt data.code; Texte und Statuscodes bleiben gleich. Fehler ohne eigenen Grund nutzen die festen Codes unauthorized (401), forbidden (403), <resource>NotFound bzw. notFound (404), invalidRequestBody (400), rateLimited (429) und internalError (500). Neue eigene Codes:

CodeBedeutung
gone(410) Die URL wurde dauerhaft entfernt.
methodNotAllowed(405) Falsche HTTP-Methode für diesen Pfad, z. B. GET /mcp.
wrongTenant(403) Die Sitzung gehört zu einem anderen Mandanten als die aufgerufene Domain.
registrationDisabledOnDomain(403) Registrierung ist auf Statusseiten- und Kundendomains gesperrt.
monitorQuotaBelowActiveCount(400) Die neue Monitor-Quota liegt unter der Zahl aktiver Monitore.
ambiguousPackage(400) Der Paketname passt auf mehr als ein Paket der Organisation.
invalidDomainName(400) Kein gültiger Domainname.
domainTldNotSupported(400) Für diese Top-Level-Domain gibt es keine Ablaufabfrage (RDAP).
invalidHeartbeatToken(400) Das Heartbeat-Token in der Ping-URL ist fehlerhaft.
heartbeatTokenNotFound(404) Kein Heartbeat-Monitor hat dieses Token.
agentAuthUnavailable(503) Agent-Authentifizierung ist nicht aktiviert.
serviceAuthNotEnabled(400) Service-Identitäten sind nicht aktiviert.
claimedOrInFlight(409) Der Agent ist schon beansprucht oder die Beanspruchung läuft.
claimExpired(400) Das Claim-Token ist abgelaufen.
authMetadataUnavailable(502) Die OAuth-Metadaten der Gegenstelle waren nicht abrufbar.
invalidToolInput(400) Gratis-Werkzeuge (/api/tools): Eingabe ungültig; statusMessage nennt den Grund.
toolTargetRejected(422) Gratis-Werkzeuge: Ziel privat oder reserviert, oder Redirect ungültig.
toolTimeout(504) Gratis-Werkzeuge: Ziel antwortete nicht rechtzeitig.
toolTooManyRedirects(508) Gratis-Werkzeuge: zu viele Redirects.
toolHostNotResolved(404/502) Gratis-Werkzeuge: Host löst nicht auf eine öffentliche Adresse auf.
toolTargetUnreachable(502) Gratis-Werkzeuge: Ziel nicht erreichbar oder TLS-Handshake fehlgeschlagen.
toolDataUnavailable(503) Gratis-Werkzeuge: Nachschlagedaten (ASN) noch nicht geladen; später erneut versuchen.

Korrekturen an Protokoll-Monitoren (19.10.2026)

EndpunktÄnderung
POST /api/tcp-monitors/:id/trigger-checkAntwortete für jeden TCP-Monitor mit 500 (seine Prüf-Queue war nicht erlaubt). Jetzt 200. Die Sofort-Prüfung nach Anlegen oder Reaktivieren eines TCP-Monitors fiel aus demselben Grund aus und läuft wieder.
GET /api/smtp-monitors/:idLieferte ein leeres config/smtpConfig. Jetzt die gespeicherten Einstellungen, auth.pass als null.
PATCH aller Protokoll-Monitore400 statt "[object Object]" als name zu speichern, ein Nicht-Array in allowedCheckCountryCodes zu verwerfen, eine Nicht-Objekt-Config zu ignorieren oder (FTP, IMAP/POP) bei nicht-numerischem timeoutSeconds mit 500 zu antworten.
GET-Monitorlisten400 invalidRequestBody bei nicht-ganzzahligem page/perPage, unbekanntem sortOrder oder fehlerhaftem tags, statt still Standardwerte zu nehmen.
POST /api/dns-monitors/status/batch400 invalidRequestBody, wenn monitorIds kein Array positiver Ganzzahlen oder organizationId keine positive Ganzzahl ist; bisher ignoriert.
POST /api/websites/summaryAntwortete auf jede Anfrage mit 500 (die Abfrage las die nicht vorhandenen Spalten error und updated_at). Liefert jetzt je Website latestCheck (mit errorMessage, ISO-checkedAt), uptime, openIncidents, inMaintenance, alertsLast24h.
GET /api/websites/:id/report.pdfAntwortete seit 15.08.2026 für jede Website mit 500 (las die Standort-Schwelle an der Website statt am Kunden). Liefert jetzt das PDF (application/pdf).
POST /api/websites, GET /api/websites/:id/detailsLiefern playwrightEnvEncrypted, die verschlüsselten Skript-Variablen, nicht mehr aus. GET /api/websites/:id nennt die Variablennamen mit geschwärzten Werten.
PATCH /api/websites/:id (Teil-Update)400 invalidRequestBody bei falschem Typ oder unbekanntem status, statt "[object Object]" als name zu speichern, checkExpectedResponseEnabled: "false" als true zu lesen oder NaN zu schreiben. Jeder Eintrag in data.issues trägt path (mit Punkt verbunden) und message wie an jedem anderen Endpunkt; bisher die rohe Validator-Meldung.
PATCH /api/websites/:id/check-configEin abgewiesener Body antwortet 400 mit data.code invalidCheckConfig und data.issues; bisher kam nur die rohe Fehlerliste. minPageSize und maxPageSize müssen ganze Zahlen ab 0 sein.
GET /api/websites400 invalidRequestBody bei nicht ganzzahligem page/perPage, unbekanntem sortOrder (jetzt mit Groß-/Kleinschreibung), fehlerhaftem tags oder einem skipMetrics außer 1, true, 0, false.
GET /api/websites/:id/details, GET /api/websites/:id/monitoring-data400 invalidRequestBody bei unbekanntem range, ungültigem date/tz/maxPoints, einzelnem startDate oder endDate oder einer granularity außer minute. monitoring-data liefert responseTimeData[].timestamp als ISO-Zeitpunkt; bisher kam der rohe Datenbanktext.
GET /api/customer-domains mit statusesAntwortete bei jedem Statusfilter mit 500 (der Zählabfrage fehlte der Join auf den Ablaufstatus). Filtert jetzt; ein unbekannter Status neben einem gültigen ist 400 invalidStatusFilter, statt still wegzufallen.
POST /api/customers, PATCH /api/customers/:id, POST /api/customers/:id/domains, POST /api/customers/:id/ips, PATCH /api/customer-domains/:id, PATCH /api/customer-ips/:id, POST /api/customer/tokensEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher data.name ZodError ohne Code. Ein falscher Typ wird abgewiesen statt umgedeutet: monthlyReportsEnabled: "false" wurde als true gespeichert, jeder status-Text gespeichert, expiryWarningDays: "30" angenommen.
GET /api/customers400 invalidRequestBody bei nicht ganzzahligem page/perPage/organizationId, unbekanntem status, fields, sortBy oder sortOrder; bisher still durch Vorgaben ersetzt. In der Seitenform sind createdAt, cancelledAt und cancellationDate ISO-Zeitpunkte; bisher roher Datenbanktext.
GET /api/customer-ipsJeder Eintrag hat customerName und customerPublicId wie die Domain-Liste. Die eingebettete customer-Zeile ist deprecated.
POST /api/status-pages, PATCH /api/status-pages/:id, PATCH /api/status-pages/:id/design, POST /api/status-pages/domains, POST /api/status-pages/domains/verify, POST /api/status-pages/domains/activateEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher data.name ZodError ohne Code. Die Design-Zahlen (historyDays, incidentLimit, incidentDays, maintenanceLimit, maintenanceDays) müssen ganze Zahlen sein; ein Text wie "14" wurde angenommen.
GET /api/status-pages/:id/designLiefert jedes Design-Feld wie PATCH: historyDays, showIncidents, incidentLimit, incidentDays, showMaintenance, maintenanceLimit, maintenanceDays und seoTitle fehlten. Eine Seite ohne gespeichertes Design meldet layout statusboard, das Layout ihrer öffentlichen Seite; bisher classic.
DELETE /api/status-pages/:idLöscht auch die eigene Domain der Seite. Die Domain-Zeile blieb stehen, derselbe Hostname ließ sich danach nur mit 409 hostnameAlreadyInUse wieder hinzufügen.
GET /api/status-pages/domains/:id, DELETE /api/status-pages/domains/:id, POST /api/status-pages/domains, POST /api/status-pages/domains/verify, POST /api/status-pages/domains/activatePrüfen den Kundenbereich des Aufrufers wie die Statusseiten-Endpunkte: eine auf einzelne Kunden beschränkte Rolle bekommt für die Domain der Seite eines anderen Kunden 403 oder 404.
PATCH /api/organization, PATCH /api/organizations, PATCH /api/organizations/:id, PATCH /api/organization/billing, PATCH /api/organizations/billing, PATCH /api/organizations/:id/billingEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher war data die nackte Fehlerliste ohne Code. 401 und 403 tragen jetzt data.code (unauthorized, forbidden).
PATCH /api/package-configs, PATCH /api/package-configs/:packageType, PATCH /api/organizations/package-configs/:packageType, PATCH /api/organizations/:id/package-configs/:packageTypeEin falscher Typ wird mit 400 invalidRequestBody abgewiesen statt umgedeutet: enableSmsAlerts: "false" wurde als true gespeichert, maxUrls: "5" angenommen. Zahlen müssen JSON-Zahlen sein, Schalter JSON-Booleans. allowedCheckCountryCodes muss ein Array sein (Kleinbuchstaben werden weiter angenommen und groß geschrieben); notes ist in jeder Variante auf 4096 Zeichen begrenzt, alertLocationThreshold auf 32.
PATCH /api/organization, PATCH /api/organizations, PATCH /api/organizations/:id mit geschützten FeldernrequireMfaAdmins, requireMfaEditors, requireMfaReadonly, requireMfaCustomers, smsOverageSafetyCapCentsMonthly, quotaIpsLimit und quotaAutoUpgradeEnabled zählen nur, wenn der Wert vom gespeicherten abweicht. Wer den aktuellen Wert mitschickte (wie Terraform mit dem vollen Zustand), bekam 403 (API-Token oder kein globaler Admin) oder 400 mfaRequiredForActor (Konto ohne eigenen zweiten Faktor); das gelingt jetzt und lässt das Feld unberührt. Eine echte Änderung braucht weiter dieselben Rechte wie bisher.
GET /api/package-configs, GET /api/organizations/:id/package-configssummary nimmt 0 oder 1; jeder andere Wert antwortet 400 invalidRequestBody, statt als 0 gelesen zu werden.
Jeder Endpunkt mit Ressourcen-Id oder öffentlicher IdEine Kennung falscher Form antwortet 400 mit data.code invalidIdentifier, eine unbekannte öffentliche Id 404 mit data.code <resource>NotFound (z. B. organizationNotFound, tcpMonitorNotFound). Beides kam bisher ohne data.code.
POST /api/organization/tokens, PATCH /api/organization/smtp, POST /api/organization/smtp/test, PATCH /api/organization/whitelabel/branding, POST /api/organization/whitelabel/branding/upload, POST /api/organization/whitelabel/domains, POST /api/organization/whitelabel/domains/verify, POST /api/organization/whitelabel/domains/activate, POST /api/organization/data-export, POST /api/organization/reports, PATCH /api/organization/reports/:idEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher data.name ZodError ohne Code. port muss eine JSON-Zahl sein ("587" wurde angenommen); ein leerer Text löscht ihn weiterhin.
POST /api/organization/smtp/testEin privater SMTP-Host antwortet 400 smtpHostNotPublic wie PATCH /api/organization/smtp, ein gescheiterter Versand 502 smtpSendFailed; beides war generic.
POST /api/organization/whitelabel/branding/uploadJeder Fehler trägt data.code: invalidDataUrl, unsupportedContentType, invalidBase64, emptyUpload, fileTooLarge (413), storageNotConfigured, storageUnavailable (503), uploadFailed (502).
GET /api/organization/report-runslimit (1-200) und offset müssen nichtnegative ganze Zahlen sein; jeder andere Wert antwortet 400 invalidRequestBody, statt auf 50 und 0 zu fallen. Ein limit über 200 wird nicht mehr still gekappt.
POST /api/organization/whitelabel/domains/verifyFür eine schon aktive Domain trägt domain jetzt createdAt und updatedAt wie jede andere Antwort.
POST /api/users, PATCH /api/users/:idEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues; bisher data.name ZodError. PATCH liefert jetzt zusätzlich den geänderten Login als user (Form wie GET /api/users/:id) neben success. Unbekannte customerIds antworten invalidCustomerIds wie bei POST; bisher generic.
GET /api/users/:id, DELETE /api/users/:id, POST /api/usersFehlerantworten tragen ihren Text in statusMessage; dort stand Server Error (z. B. bei 404 userNotFound).
POST /api/incidents/:id/false-alarmEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues; bisher data.name ZodError.
POST /api/websites, POST /api/dns-monitors, POST /api/ftp-monitors, POST /api/icmp-monitors, POST /api/imap-pop-monitors, POST /api/smtp-monitors, POST /api/ssh-monitors, POST /api/tcp-monitorsEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher data.name ZodError ohne Code. Damit antwortet jeder Endpunkt, der seinen JSON-Body prüft, in dieser einen Form.
GET /api/customer-domains, GET /api/customer-ips, GET /api/organization/audit, GET /api/organization/smtp/logsEin ungültiger Query-Parameter antwortet 400 mit data.code invalidRequestBody und data.issues (path, message); bisher data.name ZodError ohne Code.
PATCH an jedem Protokoll-Monitor (DNS, FTP, ICMP, IMAP/POP, SMTP, SSH, TCP)Ein abgewiesenes checkInterval antwortet 400 mit data.code invalidCheckInterval (keine Zahl), checkIntervalTooLow (unter dem Paketminimum) oder checkIntervalTooHigh; bisher ohne Code. Der Text bleibt gleich.
PATCH /api/escalation-config/:id mit defaultEmail oder defaultPhoneNumberPflegt nur den eigenen E-Mail- bzw. SMS-Kanal der Organisation. Bisher konnte er stattdessen einen kundengebundenen Kanal desselben Typs überschreiben.
GET /api/websites/:id/details, GET /api/websites/:id/monitoring-data und jedes Protokoll-Monitor-details ohne date„Heute“ ist der lokale Kalendertag aus tz. Bisher war es der UTC-Tag; in den ersten Stunden nach lokaler Mitternacht (östlich von UTC) zeigte die Antwort deshalb den Vortag ohne die neuesten Checks.
GET /api/escalation-config/:idVerlangt dieselben Rechte wie PATCH: Organisations-Admin mit unbeschränktem Umfang. Bisher reichte Leserecht, und ein readonly- oder kundengebundener Login las Webhook-URL, -Header und -Vorlage. Jetzt 403 forbidden bzw. 403 customerScopedTokenForbidden.
PATCH /api/customers/:idDas Paket (packageId oder packageType) und die Rechtefelder (canEditManaged, allowSelfService, maxSelfServiceUrls, SMS-/Benachrichtigungsrechte) ändert nur ein Organisations-Admin mit unbeschränktem Umfang. Ein kundengebundenes Token kam bisher durch. Ein Paketwechsel antwortet 403 packageOrgOnly; das unveränderte Paket mitzuschicken (voller Zustand wie bei Terraform) geht weiter; Rechtefelder werden wie bei anderen Nicht-Admins ignoriert.
POST /api/customers/bulk mit action: packageWie PATCH /api/customers/:id: das Paket ändert nur ein Organisations-Admin mit unbeschränktem Umfang. Andere Aufrufer bekommen je Kunde failed mit reason: packageOrgOnly.
PATCH /api/organization/tokens/:idTeil-Update: ein fehlendes customerId oder expiresInDays lässt Kundenbindung und Ablauf unverändert. Nur ein ausdrückliches null hebt sie auf. Bisher machte ein Body mit nur name das Token org-weit und unbefristet.
POST /api/maintenance-windows, PATCH /api/maintenance-windows/:id, DELETE /api/maintenance-windows/:idEin kundenbeschränkter Aufrufer (Read-only- oder Editor-Login mit zugewiesenen Kunden, kundengebundenes Token) legt Fenster nur auf self_service-Monitore an, ändert oder löscht nur solche Fenster. Fenster für den ganzen Kunden, mit Etiketten oder auf managed-Monitoren verlangen die canEditManaged-Ausnahme des Kunden, sonst 403 managed_by_organization.
Kundengebundene API-TokensEin Schrägstrich am Ende des Pfads (/api/customers/bulk/) umgeht die Sperren für kundengebundene Tokens nicht mehr: dieselbe Antwort wie ohne Schrägstrich.
GET /api/organization/data-export/:id/download, PATCH und DELETE /api/organization/tokens/:id, GET und DELETE /api/organization/whitelabel/domains/:idOrganisationsweit, deshalb bekommt ein auf Kunden beschränkter Aufrufer 403 customerScopedTokenForbidden, wie schon beim Export-Status. Kundengebundene Token wurden schon vorher gestoppt; ein Global Admin im Plattform-Admin-Kundenkontext kam durch (bis 20.10.2026).
PATCH /api/change-requests/:idEine Änderungsanfrage entscheidet nur ein organisationsweiter Aufrufer; ein kundengebundenes Token oder Login bekommt 403 customerScopedTokenForbidden. Mit einem Organisations-API-Token kam bisher 500; jetzt gelingt es und vermerkt den Aussteller des Tokens als Entscheider.
POST /api/users/:id/mfa/resetDen zweiten Faktor eines Plattform-Kontos (Global Admin oder Supporter) setzt nur ein Global Admin zurück, wie bei PATCH und DELETE: 403 globalUserProtected. Ein Nutzer einer anderen Organisation antwortet wie ein fehlender mit 404 userNotFound (seit dem 20.10.2026; vorher 403 insufficientPermissions, was die ID bestätigte).
GET /api/organization/reports, GET /api/organization/reports/:id, PATCH /api/organization/reports/:id, DELETE /api/organization/reports/:id, POST /api/organization/reports/:id/send-nowEin kundenbeschränkter Aufrufer (Read-only- oder Editor-Login mit zugewiesenen Kunden) sieht nur Berichte, die ausschließlich Kunden seines Umfangs umfassen (scopeMode customers). Andere Berichte fehlen in der Liste und antworten 404 notFound. Berichte über alle Kunden oder über Tags waren für ihn sichtbar.
POST /api/organization/reports und PATCH /api/organization/reports/:idEin kundenbeschränkter Aufrufer legt einen Bericht nur für Kunden seines Umfangs an oder stellt ihn nur darauf um: 403 forbidden. Der unveränderte Umfang im Body geht weiter.
GET /api/organization/report-runs und GET /api/organization/report-runs/:id/pdfLäufe folgen der Sichtbarkeit ihres Berichts: ein kundenbeschränkter Aufrufer listet und lädt keine Läufe von Berichten über fremde Kunden mehr (404 reportRunNotFound).
GET /api/organizations/:id/notification-stats, GET /api/organizations/:id/dashboard-stats, GET /api/organizations/:id/package-stats und GET /api/organizations/:id/package-configs/:packageType/statsOrganisationsweite Kennzahlen: ein kundenbeschränkter Aufrufer bekommt 403 customerScopedTokenForbidden.
DELETE /api/organization/tokens/:id und PATCH /api/organization/tokens/:idDie Admin-Prüfung liest die Rolle aus der aktuellen Nutzerzeile. Ein herabgestufter Admin behielt das Recht, solange seine Sitzung lebte.
GET /api/invoices/:invoiceId/pdfEin kundengebundenes Token bekommt 403 customerScopedTokenForbidden; über diesen Kurzpfad konnte es die Rechnungen der Organisation laden.
POST /api/incidents/:id/sre-attribution-feedbackVerlangt Schreibrecht am Vorfall (Admin oder Editor im Kundenumfang des Vorfalls), wie jede andere Änderung am Vorfall. Ein Read-only-Login bekommt 403 forbidden.
GET /api/organization/data-export, GET /api/organization/data-export/:idWie der Download: nur ein Organisations-Admin mit unbeschränktem Umfang. Andere bekommen 403 forbidden oder 403 customerScopedTokenForbidden.
GET /api/status-pages/:id/designPrüft den Kundenumfang der Seite wie PATCH: die Seite eines fremden Kunden antwortet 403 forbidden.
PATCH /api/status-pages/:id/design, PATCH /api/status-pages/:id mit designConfig, showRecentIncidents oder showRecentMaintenance, POST /api/status-pages mit showRecentIncidents oder showRecentMaintenanceDas Design einer Statusseite ändern verlangt die Rolle admin oder editor. readonly-Nutzer, auch kundengebundene auf ihren self_service-Seiten, und von ihnen ausgestellte Tokens bekommen 403 forbidden; Lesen per GET bleibt ihnen offen.
GET /api/status-pages/domains/:id und DELETE /api/status-pages/domains/:idEine Domain ohne gebundene Statusseite existiert nur für Aufrufer mit unbeschränktem Umfang; ein kundenbeschränkter Aufrufer bekommt 404 domainNotFound.
POST /api/users/:id/avatar und DELETE /api/users/:id/avatarDen Avatar eines Plattform-Kontos (Global Admin oder Supporter) ändert nur ein Global Admin, wie bei PATCH und DELETE des Nutzers: 403 globalUserProtected.
GET /api/incidentsUngültige limit, offset, includeTotal oder source liefern 400 invalidRequestBody. Bisher fielen sie still auf Standardwerte: ?source=manuel listete alle Quellen, ?limit=abc lieferte 100 Zeilen. limit über 500 bleibt gedeckelt.
GET /api/change-requestsEin unbekannter status liefert 400 invalidRequestBody; bisher kamen die offenen Anfragen. 401 und 403 tragen jetzt data.code (unauthorized, forbidden).
PATCH /api/change-requests/:id, POST /api/monitors/:type/:id/change-requestsEin abgewiesener Body antwortet 400 mit data.code invalidRequestBody und data.issues; bisher data.name ZodError. Jeder Fehler trägt data.code: unauthorized, forbidden, changeRequestNotFound, invalidChangeRequestId, invalidMonitorId.
GET /api/agent-claim/context, POST /api/agent-claim/confirmFehler tragen data.code (unauthorized, claimAttemptRequired, invalidClaimToken) und eine statusMessage; data.error bleibt für bestehende Leser. POST prüft seinen Body: ein user_code, der kein Text ist, oder write_scopes, das keine Liste von Texten ist, liefert 400 invalidRequestBody. Beides fiel bisher still weg.
GET /api/oauth/connectionsDie 401 trägt ihren Text in statusMessage; Unauthorized stand bisher nur in message.
GET /api/domainsUngültige page, perPage, organizationId oder customerId liefern 400 invalidRequestBody. Bisher fielen sie still auf Standardwerte (?page=abc war Seite 1, ?customerId=12abc war Kunde 12). perPage über 200 bleibt gedeckelt.
Details-Endpunkte der FTP-, ICMP-, IMAP/POP-, SMTP-, SSH- und TCP-MonitoremonitoringData.responseTimeData[].timestamp ist ein ISO-Zeitpunkt; bisher der rohe Datenbanktext (2026-10-19 13:36:00+00). Ungültige range, date, tz, startDate/endDate, granularity (und bei ICMP includeIncidentHistory/includeAlertHistory) liefern jetzt 400 statt still auf Standardwerte zu fallen. Auch der Website-Details-Endpunkt liefert ISO-Zeitpunkte.
POST /api/custom-fields, PATCH /api/custom-fields/:id, POST /api/tags, PATCH /api/tags/:id, POST /api/monitor-tags, DELETE /api/monitor-tags, POST /api/maintenance-windows, PATCH /api/maintenance-windows/:id, POST /api/maintenance-windows/preview-count, POST /api/maintenance-windows/preview-occurrences, POST /api/notification-channels, PATCH /api/notification-channels/:idEin abgewiesener Body antwortet mit 400, data.code invalidRequestBody und data.issues; bisher fehlte data.code.
POST /api/maintenance-windows, PATCH /api/maintenance-windows/:id, POST /api/maintenance-windows/preview-occurrencesstartTime und endTime nehmen einen ISO-String oder Epochen-Millisekunden. null oder true antwortet mit 400 invalidRequestBody, statt als 01.01.1970 gespeichert zu werden.
GET /api/maintenance-windows400 invalidRequestBody für eine Filter-ID, die keine positive Ganzzahl ist (etwa eine öffentliche ID in websiteId), ein activeOnly außer true/false, ein format außer json/csv oder ein download außer 0/1. Eine falsche Filter-ID fiel bisher still weg, und die ungefilterte Liste der ganzen Organisation kam zurück.
GET /api/maintenance-windows, GET /api/maintenance-windows/:idDie eingebettete website eines Fensters auf einer einzelnen Website trägt die verschlüsselten Spalten nicht mehr (authorizationHeaderEncrypted, basicAuthPasswordEncrypted, customHeadersEncrypted, requestBodyEncrypted, mtlsClientCertEncrypted, mtlsClientKeyEncrypted, playwrightEnvEncrypted); sie kamen als Ciphertext mit.
POST /api/notification-channels/testDer Body wird geprüft: ein fehlender Body, ein unbekannter type oder ein falscher Typ antwortet mit 400 invalidRequestBody; ein fehlender Body war bisher 500.
GET /api/notification-channels, POST /api/notification-channels, POST /api/notification-channels/testScope-Fehler tragen data.code: customerNotFound (404), forbidden (403), notificationChannelScopeMismatch (400, organizationId oder customerId passt nicht zu websiteId/customerId), invalidRequestBody (400, ungültige organizationId). organizationId: null zählt als nicht gesetzt; bisher war das 400.
PATCH /api/escalation-config/:idZahlen müssen Ganzzahlen sein und isActive ein Boolean; "10" und "true" antworten mit 400 invalidRequestBody (sie wurden umgewandelt). Jeder Prüffehler hatte data.code generic, jetzt invalidRequestBody. defaultEmail muss eine E-Mail-Adresse sein, defaultPhoneNumber ein String; beide landeten bisher ungeprüft im Organisationskanal.
PATCH /api/escalation-config/:id ohne isActiveSchaltet den Webhook-Kanal der Organisation nicht mehr ab. Vor dem 19.10.2026 deaktivierte ihn jede Änderung ohne isActive und ohne webhookUrl (etwa nur webhookTimeout).
PATCH /api/escalation-config/:id nur mit webhookUrlDer Webhook-Kanal der Organisation behält die gespeicherte Methode, Header, Vorlage und Zeitgrenzen; bisher fielen sie aus seiner Konfiguration heraus.
POST /api/escalation-config/:id/testFehler tragen einen eigenen data.code: invalidRequestBody (falscher Body, fehlende PagerDuty- oder Pushover-Schlüssel, Vorlage kein gültiges JSON), webhookUrlNotConfigured, webhookTestFailed (400, der Empfänger scheiterte oder antwortete mit einem unerwarteten Status); 401 und 403 behalten unauthorized/forbidden. Bisher war jeder Fehler generic.
GET /api/escalation-config/:id, PATCH /api/escalation-config/:id, POST /api/escalation-config/:id/testEine Organisations-ID mit angehängten Zeichen (2abc) antwortet mit 400 organizationIdRequired, statt als 2 gelesen zu werden; eine ungültige ID war bisher generic.
PATCH /api/custom-fields/:id, DELETE /api/custom-fields/:idEine ID, die keine Ganzzahl ist (etwa 1.5), antwortet mit 400 fieldIdRequired, wie bei GET.
POST /api/organization/reports/:id/send-nowSendet den Bericht und legt einen Lauf an, auch wenn der Bericht ausgeschaltet ist. Der Schalter enabled gilt nur für den Zeitplan; vor dem 19.10.2026 wurde ein manueller Versand eines ausgeschalteten Berichts still übersprungen.
POST /api/custom-fieldsEin Feld mit dem Schlüssel eines gelöschten (deaktivierten) Feldes reaktiviert dieses mit den Angaben aus dem Body und antwortet wie beim Anlegen. Bisher kam 409 customFieldAlreadyExists. Ein aktives Feld mit diesem Schlüssel antwortet weiter 409. Werte an Kunden unter dem Schlüssel bleiben unverändert.
GET /api/maintenance-windows, GET /api/maintenance-windows/:idNeues Feld websiteSummary (id, publicId, name, url oder null) für die Legacy-Ziel-Website. website (die ganze Website-Zeile) bleibt unverändert, ist aber zugunsten von websiteSummary veraltet.
GET /api/escalation-config/:idLegt keine Konfiguration mehr an. Ohne gespeicherte Konfiguration kommen die inaktiven Vorgaben, id, createdAt und updatedAt sind dann null; auch Leser ohne Schreibrecht bekommen sie statt 403. Der erste PATCH /api/escalation-config/:id speichert die Konfiguration mit denselben Vorgaben.
PATCH /api/escalation-config/:id mit isActive: falseDeaktiviert nur den Webhook-Kanal der Organisation (ohne websiteId, ohne Kunde). Kundengebundene Webhook-Kanäle bleiben aktiv; vor dem 19.10.2026 wurden sie mit abgeschaltet.
POST /api/escalation-config/:id/testHeader in webhookHeaders laufen durch dieselbe Sperrliste wie bei PATCH /api/escalation-config/:id: Host antwortet 400 webhookHostHeaderForbidden, Authorization, Cookie, X-Forwarded-* und Proxy-* antworten 400 invalidRequestBody. Bisher gingen sie unverändert hinaus.
DELETE /api/incidents/:idAntwortet { "success": true, "ok": true }. ok bleibt für bestehende Leser, ist aber veraltet; bitte success lesen.

Bestätigung ohne Zwei-Schritt-Bestätigung, Admin-Rolle per API-Token (17.11.2026)

EndpunktÄnderung
Sitzungs-Anfragen, die 403 mfa_step_up_required liefern (API-Tokens anlegen, ändern und löschen, Benutzer anlegen, Rolle oder Aktiv-Status ändern, zweiten Faktor zurücksetzen, MFA-Pflicht der Organisation, SSO einrichten, OAuth-Zustimmung, Kontolöschung, Admin ändert die E-Mail eines Mitglieds)Auch ein Konto ohne Zwei-Schritt-Bestätigung bekommt jetzt diese Antwort und bestätigt im Dialog des Dashboards mit seinem aktuellen Passwort. data.method nennt den verlangten Nachweis: totp oder password. Die Bestätigung gilt 5 Minuten je Sitzung. Konten, die sich nur per SSO anmelden und kein Passwort haben, werden nicht gefragt. API-Tokens sind nicht betroffen.
POST /api/users mit role: "admin", PATCH /api/users/:id mit Wechsel von role auf adminMit API-Token oder Agent-Access-Token: 403 nonUserSessionForbidden. Admins lädst du im Dashboard ein oder stufst sie dort hoch. Andere Rollen gehen wie bisher, und ein unverändert mitgeschicktes role: "admin" (voller Zustand, wie Terraform ihn sendet) geht weiter durch.
POST /api/organization/tokens, POST /api/customer/tokensDer Benutzer, der das Token angelegt hat, und jeder aktive Admin der Organisation bekommen eine E-Mail mit dem Namen des Tokens und dem Ersteller.

Auf dieser Seite

SchemaBetroffene FälleWebsite not found bei Website-Monitoring-EndpunktenForbidden bei Organisations-Details mit Public IDZodError bei optionalen Listen-ParameternMonitor-Ownership-FehlercodesMonitorkontingent-FehlercodesKundenpaket-FehlercodesFehlercodes beim Kundenlöschen und bei der KundenzuordnungFehlercodes fürs Website-PrüfintervallFehlercodes fürs Ersatzziel (connect target)Check-Mode-Fehlercodes (SSH-/SMTP-/FTP-/IMAP-POP-Monitore)Incident-FehlercodesFehlercodes für WartungsfensterOrganisationsberichte-FehlercodesFehlercodes Dependency-StatusFehlercodes MeldeformularDatenexport-FehlercodesFehlercodes des Audit-Log-ExportsAgent-Auth-FehlercodesAPI-Token-FehlercodesClaim-Flow-FehlercodesID-JAG-FehlercodesVerbundene-Apps-Fehlercodes (OAuth-Verbindungen)Fehlercodes der OAuth-ZustimmungFehlercodes für Statusseiten-AbonnentenPublic IDs in DNS- und DNSBL-MonitorenIncident-Management-(IM)-API-FehlercodesFehlercodes der NIS-2-MeldefälleFehlercodes von Postmortem und NachbereitungNutzerverwaltungs-FehlercodesEtiketten-FehlercodesFehlercodes für ÄnderungswünscheBenachrichtigungskanal-FehlercodesFehlercodes für eigene DomainsAbgelöste Felder (Umbenennungen, 20.10.2026)404 für Ressourcen außerhalb des ScopesFehlercodes für Rate-Limits und GrößenFehlercodes für Webhook- und SMTP-ZieleFehlercodes der AbsenderdomainOrganisation gesperrt oder gelöschtKontozustand an den Auth-EndpunktenMFA-FehlercodesFehlercodes beim TarifwechselFehlercodes der KontolöschungUSt-IdNr.-Validierung: FehlercodesUpdate Billing Details: benötigter BodyWeitere FehlercodesAbrechnung und OrganisationKunden, Pakete und Kunden-IPsMonitoreWartungsfensterIncidents und ÄnderungswünscheNutzer, Registrierung und AnmeldungSingle Sign-on und OAuthAPI-Tokens und Push-TokensStatusseiten und eigene DomainsBranding, SMTP und Mail-VorlagenOnboarding-AssistentRoadmap und FehlermeldungenÖffentliche Endpunkte und kostenlose ToolsPlattform- und Admin-EndpunkteIncident Management: SMS und Anruf vor der Bestätigung der Nummer (28.10.2026)Jeder Fehler trägt einen Code (20.10.2026)Korrekturen an Protokoll-Monitoren (19.10.2026)Bestätigung ohne Zwei-Schritt-Bestätigung, Admin-Rolle per API-Token (17.11.2026)