Domain hinzufügen

POST /api/organization/whitelabel/domains

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/organization/whitelabel/domains" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "app.deinkunde.com"
  }'

Antwort (Response)Ankerlink kopieren

{
  "domain": {
    "id": 2,
    "hostname": "app.deinkunde.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": "_verify-status.app.deinkunde.com",
    "txtValue": "xyz789-abc456"
  }
}

Lege einen DNS-TXT-Eintrag mit txtName und txtValue an und rufe anschließend Domain verifizieren auf.

Häufige FehlerAnkerlink kopieren

• 400 Invalid hostname wenn das Hostname-Format falsch ist
• 400 This hostname is reserved (hostnameReserved) wenn der Hostname einer der Plattform-Hosts ist oder unterhalb von uptimeify.io liegt
• 400 Wildcard domains are not supported
• 409 Hostname already exists (hostnameAlreadyExists) wenn deine Organisation bereits einen Eintrag für diesen Hostnamen hat

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