Skip to Content
Uptimeify Docs

Eigene Domain hinzufügen

Fügt einer bestehenden Statusseite einen eigenen Hostnamen hinzu und gibt den für die Verifizierung nötigen DNS-TXT-Eintrag zurück. Org-weit Admin oder Editor, kundengebunden nach der Eigentumsklasse der Seite.

POST /api/status-pages/domains

Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin oder editor (organisationsweites readonly bleibt lesend). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen stattdessen der Eigentumsklasse der Seite: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization.

Request-Body

FeldTypPflichtBeschreibung
statusPageIdnumber | stringJaDie ID oder publicId der Statusseite
hostnamestringJaDer eigene Hostname (z.B. status.deinkunde.com)

Beispiel (cURL)

curl -X POST "$BASE_URL/api/status-pages/domains" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "statusPageId": 1,
    "hostname": "status.deinkunde.com"
  }'

Antwort

{
  "domain": {
    "id": 42,
    "hostname": "status.deinkunde.com",
    "status": "pending",
    "role": "status_page",
    "verificationToken": "abc123-def456-ghi789",
    "verifiedAt": null,
    "lastVerificationError": null,
    "lastVerificationErrorAt": null,
    "createdAt": "2026-05-01T11:00:00.000Z",
    "updatedAt": "2026-05-01T11:00:00.000Z",
    "statusPageId": 1
  },
  "dns": {
    "txtName": "_verify-status.status.deinkunde.com",
    "txtValue": "abc123-def456-ghi789"
  }
}

Dieselbe Form wie Domain abfragen: domain.statusPageId ist die numerische ID der Statusseite, der die Domain hinzugefügt wurde, auch wenn die Anfrage sie per publicId genannt hat.

Häufige Fehler

  • 401 Unauthorized, wenn nicht authentifiziert
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 404 Not found, wenn die Statusseite nicht existiert
  • 409 Conflict, wenn die Statusseite schon eine Domain hat (domainAlreadyExists) oder deine Organisation bereits einen Eintrag für diesen Hostnamen hat (hostnameAlreadyInUse)
  • 400 Bad Request, wenn der Hostname ungültig (invalidHostname) oder reserviert ist (hostnameReserved: die Plattform-Hosts und alles unterhalb von uptimeify.io)

Ein Hostname ist erst belegt, wenn er verifiziert oder aktiv ist. Die unverifizierte Anfrage einer anderen Organisation blockiert deine nicht; entschieden wird beim Verifizieren. Eine pending-Anfrage, die nie verifiziert wird, wird nach 7 Tagen entfernt.

Auf dieser Seite