重置用户的企业邮箱密码

POST

/admin/v1/password/reset

重置用户的企业邮箱密码，仅当用户的邮箱和企业邮箱(别名)一致时生效，可用于处理飞书企业邮箱登录死锁的问题。

邮箱死锁：当用户的登录凭证与飞书企业邮箱一致时，目前飞书登录流程要求用户输入验证码，由于飞书邮箱无单独的帐号体系，则未登录时无法收取邮箱验证码，即陷入死锁。

错误码

HTTP状态码	错误码	描述	排查建议
400	1050023	reach reset password num limit	请次日再进行尝试
400	1050022	password format is not valid	请修改密码格式后再尝试
400	1050024	user cant reset password.may be user enterprise email not equal email	只能修改用户邮箱和企业邮箱(别名)一致的用户密码

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/admin/v1/password/reset?user_id_type=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "password": {
        "ent_email_password": "abcd*efg"
    },
    "user_id": "abc123"
}'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

修改于 2025-10-21 08:19:26

翻译文本

功能介绍

重置用户的企业邮箱密码

错误码#

请求参数

返回响应

错误码