更新用户信息

POST

/topapi/v2/user/update

调用本接口更新指定的用户信息。

说明

调用本接口可以实现更新普通账号用户信息或更新企业账号用户信息。由于在调用时参数使用有较多区别，为便于开发者查看，按照新用户的账号类型进行拆分优化：

更新普通用户信息，接口说明文档请查看本文介绍。

更新企业账号用户信息，接口说明文档请参见更新企业账号用户信息。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	维护通讯录的接口访问权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

{
    "extension": {
        "爱好": "旅游",
        "年龄": "24"
    },
    "telephone": "010-86123456-2345",
    "remark": "备注备注",
    "language": "zh_CN",
    "hide_mobile": "false",
    "title": "技术总监",
    "hired_date": "1597573616828",
    "userid": "zhangsan",
    "work_place": "未来park",
    "dept_title_list": {
        "dept_id": "2",
        "title": "资深产品经理"
    },
    "dept_order_list": {
        "dept_id": "2",
        "order": "1"
    },
    "senior_mode": "false",
    "org_email": "test@xxx.com",
    "name": "张三",
    "dept_id_list": "2,3,4",
    "job_number": "4",
    "manager_userid":"0001",
    "email": "test@xxx.com",
    "force_update_fields":"manager_userid"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/topapi/v2/user/update?access_token=be3Fxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "extension": {
        "爱好": "旅游",
        "年龄": "24"
    },
    "telephone": "010-86123456-2345",
    "remark": "备注备注",
    "language": "zh_CN",
    "hide_mobile": "false",
    "title": "技术总监",
    "hired_date": "1597573616828",
    "userid": "zhangsan",
    "work_place": "未来park",
    "dept_title_list": {
        "dept_id": "2",
        "title": "资深产品经理"
    },
    "dept_order_list": {
        "dept_id": "2",
        "order": "1"
    },
    "senior_mode": "false",
    "org_email": "test@xxx.com",
    "name": "张三",
    "dept_id_list": "2,3,4",
    "job_number": "4",
    "manager_userid":"0001",
    "email": "test@xxx.com",
    "force_update_fields":"manager_userid"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "request_id": "55o5i31j4cg8"
}

修改于 2025-09-08 06:28:05

创建用户

删除用户

更新用户信息

权限#

请求参数

请求示例代码

返回响应

权限