Domain hinzufügen
Fügt eine eigene Domain für White-Label hinzu. Erstellt einen ausstehenden DNS-Verifizierungseintrag. Die erste Domain wird automatisch als primär gesetzt. Erfordert die Admin-Rolle.
POST /api/organization/whitelabel/domains
Anfrage (Request Body)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
hostname | string | Ja | Hostname der eigenen Domain (3–253 Zeichen). Keine Wildcards. |
Beispiel (cURL)
curl -X POST "$BASE_URL/api/organization/whitelabel/domains" \
-H "Cookie: $SESSION_COOKIE" \
-H "Content-Type: application/json" \
-d '{
"hostname": "app.example.com"
}'Antwort (Response)
{
"domain": {
"id": 2,
"hostname": "app.example.com",
"status": "pending",
"role": "app",
"isPrimary": false,
"verificationToken": "xyz789-abc456",
"verifiedAt": null,
"createdAt": "2026-04-15T12:00:00.000Z",
"updatedAt": "2026-04-15T12:00:00.000Z"
},
"dns": {
"txtName": "_uptimeify-verify.app.example.com",
"txtValue": "xyz789-abc456"
}
}Lege einen DNS-TXT-Eintrag mit txtName und txtValue an und rufe anschließend Domain verifizieren auf.
Häufige Fehler
400 Invalid hostnamewenn das Hostname-Format falsch ist400 This hostname is reservedwenn der Hostname mit der Hauptplattform übereinstimmt400 Wildcard domains are not supported409 Hostname already exists