# Organizasyon temasını değiştir

`PUT /v1/branding/organizations/{org_id}` · izin `branding:write`

Kapsamın bütün tema taslağını değiştirir; gövdede olmayan jetonlar temizlenir. `{"theme":{}}` kapsamı temizler. `If-Match` ortamın değil bu kapsamın `ETag` değerini taşır (ilgili GET'ten). `logo`, `light.color.primary` ve `dark.color.primary` dışındaki jeton `422` (`token_not_allowed_in_scope`) döner.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `org_id` | yol | evet | `org_…` kimliği. |
| `If-Match` | başlık | evet | Taslağın son okunan `ETag` değeri (hiç yazılmadıysa `"0"`). Yoksa `428`, eskiyse `412`. |
| `theme` | nesne | evet | Kapsamın tam `BrandingTheme` değeri. |

## Yanıt

`200 OK`; kapsamın tema taslağı ve `ETag` başlığı (her kapsamın kendi sürümü vardır).

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

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 400 | `unknown_field` | Gövdede bilinmeyen alan var ya da gövde JSON nesnesi değil. |
| 404 | `not_found` | Kimlik geçerli bir `org_…` kimliği değil. |
| 412 | `precondition_failed` | `If-Match` taslağın güncel sürümüyle eşleşmiyor. |
| 422 | `validation_failed` | Bir jeton değeri geçersiz (`invalid_value`, `out_of_range`, `unknown_token`); `pointer` jetonu gösterir, ör. `/theme/light/color/primary`. |
| 428 | `precondition_required` | `If-Match` başlığı yok. |
| 401 | `unauthenticated` | Kimlik bilgisi yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde gerekli izin yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

```bash
curl -X PUT https://api.eu.keenauth.com/v1/branding/organizations/org_01jbexample0000000000000000 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "1"' \
  -d '{"theme":{"logo":"logo_acme","light":{"color":{"primary":"#0a3d91"}}}}'
```