# Kullanıcının tüm ikinci faktörlerini sıfırla

`POST /v1/users/{user_id}/authenticators:reset` · izin `user-credentials:write`

Kullanıcının tüm ikinci faktörlerini iptal eder ve kurtarma kodlarını siler; kullanıcı bir sonraki girişte yeniden bir faktör kaydeder. `include_passkeys` varsayılan olarak `true`'dur; `false` ile passkey'ler (`both` rolündekiler dahil) korunur. Adımlar en iyi çaba esasıyla çalışır ve tekrarlanabilir; bir bildirim hatası çağrıyı başarısız kılmaz (`notified`). Yanıt yalnızca sayıları içerir, kodları veya gizli bilgileri asla içermez. Yeniden denemelerin güvenli olması için bir `Idempotency-Key` başlığı gönderin.

## İstek

| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | `usr_` önekli kullanıcı kimliği. |

İsteğe bağlı gövde:

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `include_passkeys` | boolean | hayır | Varsayılan olarak `true`: passkey'ler de iptal edilir. `false` ile passkey'ler (`both` rolü dahil) korunur. |
| `locale` | string | hayır | Bildirimin BCP 47 dil etiketi, örneğin `tr`. Varsayılan olarak kullanıcının veya ortamın dili kullanılır. |

## Yanıt

`200 OK`. Gövde, yapılanların sayısını içerir.

```json
{
  "revoked_authenticators": 3,
  "recovery_codes_deleted": true,
  "notified": true
}
```

## Hatalar

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

| HTTP | `code` | Ne zaman |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Gövde geçerli JSON değilse veya bilinmeyen bir alan içeriyorsa. |
| 415 | `unsupported_media_type` | `Content-Type: application/json` olmadan bir gövde gönderildiyse. |
| 422 | `validation_failed` | `locale` geçerli bir BCP 47 dil etiketi değilse veya bir alanın türü yanlışsa. |
| 404 | `not_found` | Kullanıcı bu ortamda yoksa (veya kimlik bozuksa). |
| 401 | `unauthenticated` | API anahtarı eksik, geçersiz veya iptal edilmişse. |
| 403 | `insufficient_permissions` | Anahtarda `user-credentials:write` izni yoksa. |
| 429 | `rate_limited` | Hız sınırı aşılmışsa; `Retry-After` değerine uyun. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyorsa; daha sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/authenticators:reset \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"include_passkeys": false, "locale": "en"}'
```

## Kişisel veriler

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