重置密码

POST/v2/users/{user_id}/password:reset

管理员触发密码重置，返回一次性令牌或发送重置邮件。

一次性令牌有效期 15 分钟、仅可使用一次。若账号开启了 MFA，重置后需重新绑定。

Bearer Token users:write api.demo.acme-cloud.dev

请求参数

共 1 项

user_id 必填路径

string

user_id 唯一标识

请求体

application/json

delivery 必填

string · 默认 email

投递方式

可选值emailreturn_token

invalidate_sessions 可选

boolean · 默认 true

是否同时吊销该用户全部登录态

响应

3 种状态

200 OK

响应示例

{
  "user_id": "user_7f3a21",
  "one_time_token": "ott_4a9f2c7b1e",
  "expires_at": "2026-10-16T07:35:00Z",
  "sessions_revoked": 3
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/users/user_id_7f3a21/password:reset' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "delivery": "return_token",
  "invalidate_sessions": true
}'