Domain aktivieren
Aktiviert eine verifizierte eigene Domain. Optional wird sie als primäre Domain gesetzt. Nur für Admins.
POST /api/organization/whitelabel/domains/activate
Anfrage (Request Body)
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
domainId | number | Ja | - | Die ID der verifizierten Domain, die aktiviert werden soll |
makePrimary | boolean | Nein | auto | Setzt diese Domain als primär. Wird automatisch auf true gesetzt, wenn keine primäre Domain existiert. |
Beispiel (cURL)
curl -X POST "$BASE_URL/api/organization/whitelabel/domains/activate" \
-H "Cookie: $SESSION_COOKIE" \
-H "Content-Type: application/json" \
-d '{ "domainId": 2, "makePrimary": true }'Antwort (Response)
{
"activated": true,
"domain": {
"id": 2,
"hostname": "app.deinkunde.com",
"status": "active",
"role": "app",
"isPrimary": true,
"verificationToken": "xyz789-abc456",
"verifiedAt": "2026-04-15T12:30:00.000Z",
"createdAt": "2026-04-15T12:00:00.000Z",
"updatedAt": "2026-04-15T13:00:00.000Z"
}
}Häufige Fehler
400 Domain must be verified before activation404 Domain not found409 Conflict(domainAlreadyClaimed) wenn eine andere Organisation diesen Hostnamen inzwischen verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.
White-Label & Branding
Passe Produktname, Theme-Farben, Logos, Favicons und eigene Domains deiner Organisation an. Alle White-Label-Endpunkte erfordern die Admin- oder Global-Admin-Rolle.
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.