Doğrulanmış bir e-posta adresini kullanıcının birincil adresi yap

POST /v1/users/{user_id}/emails/{email_id}:set-primary · izin users:write

Doğrulanmış bir adresi kullanıcının birincil adresi yapar; önceki birincil adres ikincil adres olarak kalır. Doğrulanmamış bir adres birincil olamaz. Adres zaten birincilse hiçbir şey yazılmaz ve 200 döndürülür. Değişiklik, yönetim denetim günlüğüne user.primary_email_changed olarak, işlemi yapan aktör olarak API anahtarıyla yazılır ve user.updated olayını yayar.

İstek

Parametre Konum Zorunlu Açıklama
user_id path evet Kullanıcı kimliği, usr_ önekli.
email_id path evet E-posta satırının kimliği (dahili UUID, küçük harf, tire ile ayrılmış); GET /v1/users/{user_id}/emails tarafından döndürülen değer.

İstek gövde almaz (boş gövde veya {} kabul edilir).

Yanıt

200 OK, güncellenmiş e-posta satırıyla birlikte. users:read_pii izni yoksa adres maskelenir (a***@e***.com).

{
  "id": "0191f0a0-3333-7444-8555-666666666666",
  "email": "ada@example.com",
  "verified": true,
  "primary": true,
  "created_at": "2026-01-15T09:30:00Z"
}

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP code Ne zaman
400 malformed_request, unknown_field Gövde geçerli bir JSON değildir veya boş ya da {} değildir.
409 primary_requires_verified Adres doğrulanmamıştır.
404 not_found Kullanıcı veya e-posta satırı bu ortamda yoktur, e-posta bu kullanıcıya ait değildir ya da bir kimlik hatalı biçimlendirilmiştir.
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiştir.
403 insufficient_permissions Anahtarda users:write izni yoktur.
429 rate_limited Hız sınırı aşıldı; Retry-After başlığına uyun.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666:set-primary \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. KeenAuth API'lerinde kişisel veriler 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.