# Parola sıfırlamayı zorunlu kıl

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

Kullanıcıyı yeni parola seçmeye zorlar: sonraki başarılı parola girişinden sonra yeni parola belirlemeden devam edemez. Mevcut parola özeti silinmez: kullanıcı onunla bir kez daha giriş yapar, ardından yenisini belirler. Yeniden çağırmak güvenlidir: kullanıcı zaten işaretliyse ilk işaretin zamanı korunur. Eylem yönetim audit'ine (`user.password_reset_forced`) yazılır ve `password_reset.scheduled` olayını üretir. Çok sayıda kullanıcıyı birden işaretlemek için [Toplu parola sıfırlama işi oluştur](/docs/api/management/jobs/create-password-reset) kullanın.

İstek gövde almaz (gövde göndermeyin ya da `{}` gönderin). Yeniden denemeleri güvenli kılmak için `Idempotency-Key` başlığı gönderin.

## İstek

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

## Yanıt

`204 No Content`.

## Hatalar

Her hata, kararlı bir `code` taşıyan `application/problem+json` gövdesidir.

| HTTP | `code` | Ne zaman |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Gövde geçerli JSON değil ya da bilinmeyen alan içeriyor. |
| 401 | `unauthenticated` | API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Anahtarda `user-credentials:write` izni yok. |
| 404 | `not_found` | Kullanıcı bu ortamda yok (ya da kimlik biçimsiz). |
| 409 | `conflict` | Kullanıcının parolası yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` değerine uyun. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; sonra yeniden deneyin. |

## Örnek

```bash
curl -X POST https://api.eu.keenauth.com/v1/users/usr_01h455vb4pex5vsknk084sn02q:force-password-reset \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

CLI: `keenauth users force-password-reset usr_01h455vb4pex5vsknk084sn02q`