Uygulama temasını değiştir

PUT /v1/branding/applications/{application_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).

İstek

Alan	Tür	Zorunlu	Açıklama
`application_id`	yol	evet	`app_…` 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).

{
  "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`	Uygulama bu ortamda yok ya da kimlik biçimi hatalı.
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

curl -X PUT https://api.eu.keenauth.com/v1/branding/applications/app_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"}}}}'