ユーザーのブロックを解除
POST /v1/users/{user_id}:unblock · 権限 users:write
ユーザーに対する顧客側のブロックを解除します。プラットフォームまたはディレクトリによって設定されたブロックがまだ有効な場合、ユーザーは 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 は user_pending_deletion)。 |
| 404 | not_found |
この環境にユーザーが存在しないか、ID の形式が不正です。 |
| 401 | unauthenticated |
API キーが未指定、無効、または取り消されています。 |
| 403 | insufficient_permissions |
API キーに users:write 権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先サービスが一時的に利用できません。後で再試行してください。 |
例
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p:unblock \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
個人データ
このエンドポイントは個人データ(エンドユーザーのプロフィール)を扱います。KeenAuth API の個人データでは、保存される内容、保存期間、削除方法について説明しています。いずれのフィールドにも、特別なカテゴリーの個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。