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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
statusPageId | number | string | Ja | Die ID oder publicId der Statusseite |
hostname | string | Ja | Der 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 authentifiziert403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden404 Not found, wenn die Statusseite nicht existiert409 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 vonuptimeify.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.