取消当前 Session 的认证因素注册

POST

/api/v1/auth/security/factor/enrollment/cancel

仅允许取消与当前用户、Session ID、session_epoch 和 enrollment_id 绑定的待确认注册。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "enrollment_id": "cd8e6b59-f5cf-4894-8850-4dc2dc1aaf8e",
    "method": "totp"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/security/factor/enrollment/cancel' \
--header 'X-CSRF-Token;' \
--header 'Content-Type: application/json' \
--data '{
    "enrollment_id": "cd8e6b59-f5cf-4894-8850-4dc2dc1aaf8e",
    "method": "totp"
}'

返回响应

🟢200成功

application/json

注册已取消

Bodyapplication/json

示例

{
    "cancelled": true
}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠413

🟠415

🟠422参数错误

🔴503服务器故障

修改于 2026-08-24 18:53:50

解除当前用户的外部身份绑定

查询可绑定的资源服务