Domains auflisten
Gibt alle eigenen App-Domains der Organisation zurück. Es werden nur Domains mit der Rolle app zurückgegeben. Erfordert die Admin-Rolle.
GET /api/organization/whitelabel/domains
Query-Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
envelope | string | keiner | items: Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard. |
Beispiel (cURL)
curl -X GET "$BASE_URL/api/organization/whitelabel/domains?envelope=items" \
-H "Cookie: $SESSION_COOKIE" \
-H "Accept: application/json"Antwort (Response)
{
"items": [
{
"id": 1,
"hostname": "app.deinkunde.com",
"status": "active",
"role": "app",
"isPrimary": true,
"verificationToken": "abc123-def456",
"verifiedAt": "2026-01-15T10:00:00.000Z",
"lastVerificationError": null,
"lastVerificationErrorAt": null,
"createdAt": "2026-01-14T08:00:00.000Z",
"updatedAt": "2026-01-15T10:00:00.000Z"
}
],
"total": 1,
"page": 1,
"perPage": 1
}Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form ({ "domains": [...] }); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.
Häufige Fehler
401 Unauthorizedwenn nicht authentifiziert403 Forbiddenwenn kein Admin
Domain abfragen
Gibt eine eigene App-Domain deiner Organisation zurück, in derselben Form { domain, dns } wie beim Hinzufügen. Erfordert die Admin-Rolle.
Branding aktualisieren
Aktualisiert die Branding-Konfiguration der Organisation. Alle Felder sind optional: nur gesendete Felder werden aktualisiert. Wird productName oder eine Theme-Farbe auf null gesetzt, wird sie geleert. Erfordert die Admin-Rolle.