# E-posta adresini birincil yapın

`POST /fapi/v1/me/emails/{email_id}:set-primary` · çağrı ortamın Giriş yap ana sunucusundan yapılır

Kimliği doğrulanmış kullanıcının doğrulanmış e-posta adreslerinden birini birincil adres yapar. Doğrulanmamış bir adres birincil olamaz; önce doğrulayın. Değişiklikten sonra önceki birincil adrese ve kullanıcının diğer doğrulanmış adreslerine, hesap kurtarmayı açan "bu ben değildim" bağlantısı içeren bir güvenlik bildirimi gönderilir. Adres zaten birincilse yanıt yine `204` olur ve hiçbir şey değişmez veya gönderilmez. Kimliği doğrulanmış kullanıcının `__Host-idp_session` çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse `401 unauthenticated` döner. Farklı bir kökenteki birinci taraf uygulama bunun yerine ön uç API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte `Authorization: DPoP <token>`; bkz. [Ön uç API erişim belirteci](/docs/api/fapi/front-api-token)).

Oturumun son 5 dakika içinde doğrulanmış olması gerekir. Kullanıcının ikinci bir faktörü varsa, oturumun ayrıca ikinci bir faktörle (`urn:idp:acr:mfa`) açılmış olması gerekir.

## İstek

Başlıklar:

| Başlık | Gerekli | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |
| `Origin` | evet | Tam olarak `https://<giriş ana sunucusu>` olmalıdır. |

`email_id`: e-posta adresi tanımlayıcısı; yönetim API'sinin `/v1/users/{user_id}/emails` uç noktalarının kullandığı değerle aynıdır (küçük harfli UUID).

Gövde yok.

## Yanıt

`204 No Content`.

## Hatalar

| Durum | Kod | Ne zaman |
| --- | --- | --- |
| 401 | `unauthenticated` | Geçerli oturum çerezi yok. |
| 401 | `step_up_required` | Oturum son 5 dakika içinde doğrulanmamış veya ikinci faktör gerekiyor; `WWW-Authenticate` başlığındaki `max_age=300` (ve uygunsa `acr_values`) ile yeniden doğrulayın. |
| 403 | `origin_not_allowed` | `Origin` eksik veya hatalı. |
| 404 | `not_found` | Bu kullanıcı için böyle bir e-posta adresi yok. |
| 409 | `primary_requires_verified` | E-posta adresi doğrulanmamış. |

## Örnek

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc:set-primary \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt
```

## 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.