# Metin geçersiz kılmalarını ayarla

`PUT /v1/branding/texts/{screen}/{locale}` · izin `branding:write`

Bir ekran ve dil için metin geçersiz kılmalarını yazar; gövdedeki anahtarlar eklenir veya değiştirilir, diğer anahtarlar korunur. Yalnızca yerleşik kataloğun anahtarları geçersiz kılınabilir ve bir değer, katalog metninin `{{ placeholders }}` ifadelerini korumalıdır. Denetim ve çift yönlü denetim karakterleri reddedilir. Güvenlik metinleri geçersiz kılınamaz: onay ekranı, cihaz ve çıkış yap onayı, kurtarma kodu uyarısı ve önizleme başlığı. Yayımlandığında etkili olur.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `screen` | path | evet | Barındırılan sayfa ekranı (ör. `login`, `authorize`). |
| `locale` | path | evet | Desteklenen dil (ör. `en`, `tr`). |
| `application_id` | query | hayır | Uygulama kapsamı (`app_…`). Bu ve `org_id` verilmezse ortam kapsamı kullanılır. |
| `org_id` | query | hayır | Kuruluş kapsamı (`org_…`). `application_id` ile birlikte kullanılamaz. |
| `texts` | object | evet | Anahtar → değer, 1-500 anahtar, her değer 1-1000 karakter. |

## Yanıt

`200 OK`, kapsamın, ekranın ve dilin tüm geçersiz kılmalarıyla birlikte.

```json
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
```

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 400 | `unknown_field` | Gövdede bilinmeyen bir alan var veya JSON nesnesi değil. |
| 404 | `not_found` | `application_id` veya `org_id` hatalı biçimde, ya da uygulama bu ortamda yok. |
| 422 | `validation_failed` | `texts` eksik veya boş, bir anahtar bilinmiyor (`unknown_text_key`), bir placeholder eksik (`placeholder_mismatch`), dil desteklenmiyor veya bir değer geçersiz; `pointer` değeri `/texts/<key>` şeklindedir. Hem `application_id` hem `org_id` verildi (`mutually_exclusive`) ya da biri tekrarlandı (`repeated`). |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinin gerekli izni 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/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texts":{"title":"Hoş geldiniz"}}'
```