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

DELETE

/api/v1/auth/external-identities/{slug}

必须通过 Session Cookie、CSRF Cookie、X-CSRF-Token 及当前密码复验。仅 TOTP 不是独立登录凭据：密码登录已禁用且没有 Passkey 时，不能解除最后一个外部身份，返回 409 oauth_last_login_credential。操作在同一事务内检查凭据并删除身份，成功解绑不会改变当前 session_epoch，竞态导致 epoch 变更时返回 401。成功后记录 external_identity_unlink 审计事件。

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "password": "pa$$word"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE '/api/v1/auth/external-identities/' \
--header 'X-CSRF-Token;' \
--header 'Content-Type: application/json' \
--data '{
    "password": "pa$$word"
}'

返回响应

🟢204删除成功

已解除绑定

该响应没有 Body

🟠400请求有误

🟠401没有权限

🟠409

🟠413

🟠415

🟠422参数错误

🟠429

🔴503服务器故障

修改于 2026-08-18 09:01:51

完成外部身份绑定回调

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