ユーザーを削除

DELETE /v1/users/{user_id} · 権限 users:delete

ユーザーの削除を開始します。ユーザーはただちに pending_deletion になり、削除は今すぐ実行対象となります。その後、完全な削除が非同期で実行されます。レスポンスは deletion_id を含む 202 Accepted です。同じユーザーに対してリクエストを繰り返すと、同じ deletion_id が返されます。このエンドポイントには取り消しができる猶予期間はありません。

リクエスト

パラメーター	場所	必須	説明
`user_id`	path	はい	ユーザーID。プレフィックスは `usr_` です。

レスポンス

202 Accepted。

{
  "deletion_id": "0191f0a0-0000-8000-8000-000000000001",
  "requested_at": "2026-01-15T09:30:00Z"
}

エラー

すべてのエラーは、安定した code を含む application/problem+json の本文で返されます。

HTTP	`code`	発生条件
404	`not_found`	この環境にユーザーが存在しない場合（またはIDの形式が不正な場合）。
401	`unauthenticated`	APIキーが未指定、無効、または取り消し済みの場合。
403	`insufficient_permissions`	キーに `users:delete` 権限がない場合。
429	`rate_limited`	レート制限を超えた場合。`Retry-After` に従ってください。
503	`service_unavailable`	依存先が一時的に利用できない場合。後で再試行してください。

例

curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

個人データ

このエンドポイントは個人データ（エンドユーザーのプロフィール）を扱います。KeenAuth APIにおける個人データでは、保存される内容、保存期間、削除方法について説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。