
# Organisationsthema abrufen

`GET /v1/branding/organizations/{org_id}` · Berechtigung `branding:read`

Gibt den Themenentwurf einer Organisation zurück. Ein Organisationsthema kann nur `logo`, `light.color.primary` und `dark.color.primary` setzen. Eine Organisation ohne eigenen Entwurf liefert ein leeres Thema und `ETag: "0"`.

## Anfrage

| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| `org_id` | Pfad | ja | `org_…`-ID. |

## Antwort

`200 OK` mit dem Themenentwurf des Bereichs und seinem `ETag` (jeder Bereich hat eine eigene Version).

```json
{
  "theme": {"logo": "logo_acme", "light": {"color": {"primary": "#0a3d91"}}},
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Die ID ist keine gültige `org_…`-ID. |
| 401 | `unauthenticated` | Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; nach der `Retry-After`-Zeit erneut versuchen. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der `Retry-After`-Zeit erneut versuchen. |

## Beispiel

```bash
curl https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
