# Metadatanızı güncelleyin

`PATCH /fapi/v1/me/metadata` · environment'ın giriş ana bilgisayarından çağrılır

Kimliği doğrulanmış kullanıcının `user_metadata` alanına RFC 7396 birleştirme yaması uygular. `app_metadata` buradan yazılamaz. Sonuç en fazla 16 KiB, derinlik 5 ve en üst düzeyde 100 anahtar olabilir. Kimliği doğrulanmış kullanıcının `__Host-idp_session` çerezi gereklidir; yakın zamanda yeniden doğrulama gerekmez. Farklı bir kökenden gelen birinci taraf uygulama, bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte `Authorization: DPoP <token>`; bkz. [Ön yüz API erişim belirteci](/docs/api/fapi/front-api-token)).

## İstek

Üstbilgiler:

| Üstbilgi | Zorunlu | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |
| `Origin` | evet | Tam olarak `https://<giriş ana bilgisayarı>` olmalıdır. |
| `If-Match` | hayır | İsteğe bağlı. Önceki bir yanıtın `ETag` değeri (veya `*`); değişiklik yalnızca profil hâlâ bu sürümdeyse yapılır. |

Gövde (`application/merge-patch+json` veya `application/json`): birleştirme yamasının kendisi, bir JSON nesnesi. `null` olarak ayarlanan bir anahtar kaldırılır; iç içe nesneler birleştirilir.

```json
{
  "theme": null,
  "preferences": {
    "newsletter": false
  }
}
```

## Yanıt

`200 OK` ile güncellenmiş profil (`GET /fapi/v1/me` ile aynı alanlar) ve yeni bir `ETag`.

## Hatalar

| Durum | Kod | Ne zaman |
| --- | --- | --- |
| 400 | `malformed_request` | Gövde bir JSON nesnesi değilse veya `If-Match` üstbilgisi hatalıysa. |
| 401 | `unauthenticated` | Geçerli bir oturum çerezi yoksa. |
| 403 | `origin_not_allowed` | `Origin` eksikse veya yanlışsa. |
| 404 | `not_found` | Hesap okunamıyorsa (örneğin engellenmişse veya silinmekteyse). |
| 412 | `precondition_failed` | `If-Match` mevcut sürümle eşleşmiyorsa; hiçbir şey değişmez. |
| 413 | `payload_too_large` | Gövde 16 KiB'ı aşıyorsa. |
| 415 | `unsupported_media_type` | `Content-Type` desteklenmiyorsa. |
| 422 | `validation_failed` | Yama boşsa veya sonuç bir sınırı aşıyorsa (`too_large`, `too_many_keys`; işaretçi gövdenin kökü olur). |
| 503 | `service_unavailable` | Kullanıcı dizini geçici olarak kullanılamıyorsa; `Retry-After` saniye sonra yeniden deneyin. |

## Örnek

```bash
curl -X PATCH https://example.keenauth.app/fapi/v1/me/metadata \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/merge-patch+json" \
  -b cookies.txt \
  -d '{"theme":null}'
```

## Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. [KeenAuth API'lerinde kişisel veriler](/docs/policies/personal-data) neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.