ユーザーの削除を取り消す
POST /v1/users/{user_id}:cancel-deletion · 権限 users:write
まだ猶予期間中(セルフサービス削除)のユーザー削除を取り消します。ユーザーは再び active になります。ブロックがまだ有効な場合は blocked になります。ユーザーが削除保留中でない場合、この呼び出しでは何も変更されず、ユーザーが返されます。リクエストにボディは不要です。
リクエスト
| パラメーター | 場所 | 必須 | 説明 |
|---|---|---|---|
user_id |
path | はい | ユーザー ID。接頭辞は usr_ です。 |
レスポンス
200 OK。ボディはユーザーオブジェクトです。ETag ヘッダーにはユーザーのバージョンが含まれます。
API キーに users:read_pii 権限がない場合、個人データはマスクされます。email は a***@e***.com になり、phone_number は末尾 2 桁のみ残ります(+**********67)。name、given_name、family_name、middle_name、nickname はイニシャルになります(A. L.)。username は先頭 1 文字のみ残ります(a***)。birthdate は ****-**-** になり、address は {"redacted": true} になります。user_metadata と app_metadata はマスクされません。
{
"id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"kind": "regular",
"status": "active",
"external_id": null,
"username": null,
"name": "Ada Lovelace",
"email": "ada@example.com",
"email_verified": true,
"phone_number": null,
"phone_verified": false,
"user_metadata": {},
"app_metadata": {},
"created_via": "admin_api",
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"last_sign_in_at": null,
"deletion_requested_at": null,
"deletion_due_at": null
}
エラー
すべてのエラーは、安定した code を含む application/problem+json ボディで返されます。
| HTTP | code |
発生条件 |
|---|---|---|
| 409 | conflict |
猶予期間が終了し、削除が実行中です。もう取り消すことはできません(errors[].code は deletion_due)。 |
| 404 | not_found |
この環境にユーザーが存在しないか、ID の形式が不正です。 |
| 401 | unauthenticated |
API キーがないか、無効または取り消されています。 |
| 403 | insufficient_permissions |
キーに users:write 権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。後で再試行してください。 |
例
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p:cancel-deletion \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
個人データ
このエンドポイントは個人データ(エンドユーザーのプロフィール)を扱います。KeenAuth API の個人データでは、保存される内容、保持期間、削除方法について説明しています。どのフィールドにも特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。