更新用户信息旧版SDK

更新于 2025-02-26调用本接口更新指定的用户信息。

说明

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

更新普通用户信息，接口说明文档请查看本文介绍。
更新企业账号用户信息，接口说明文档请参见更新企业账号用户信息。

权限

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

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

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/v2/user/update

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

是

be3Fxxxx

调用该接口的应用凭证。

企业内部应用，通过获取企业内部应用的access_token接口获取。

Body参数

名称	类型	是否必填	示例值	描述
userid	String	是	user123	员工的userId。
name	String	否	张三	员工名称，长度最大80个字符。
hide_mobile	Boolean	否	false	是否号码隐藏： true：隐藏隐藏手机号后，手机号在个人资料页隐藏，但仍可对其发DING、发起钉钉免费商务电话。 false：不隐藏
telephone	String	否	010-86123456-2345	分机号，长度最大50个字符。说明分机号是唯一的，企业内不能重复。
job_number	String	否	4	员工工号，长度最大50个字符。
manager_userid	String	否	0001	直属主管的userId。
title	String	否	技术总监	职位，长度最大200个字符。
email	String	否	test@xxx.com	员工邮箱，长度最大50个字符。说明员工邮箱是唯一的，企业内不能重复。
org_email	String	否	test@xxx.com	员工的企业邮箱。说明需满足以下条件，此字段才生效：员工的企业邮箱已开通。
work_place	String	否	未来park	办公地点，长度最大100个字符。
remark	String	否	备注信息	备注，长度最大2000个字符。
dept_id_list	String	否	"2,3,4"	所属部门ID列表。
dept_order_list	DeptOrder[]	否		员工在对应的部门中的排序。
dept_id	Number	否	2	部门ID。
order	Number	否	1	员工在部门中的排序。数值越大，排序越靠前。
extension	String	否	{"爱好":"旅游","年龄":"24"}	扩展属性，长度最大2000个字符。说明手机上最多只能显示10个扩展属性。如果给员工设置有10个扩展属性字段，更新时即使扩展属性字段值没变，也必须要将10个扩展属性字段都传进去。如果只传其中1个，那么剩下9个字段都会被清空。在使用该参数前，需要先在钉钉管理后台 > 通讯录 > 内部通讯录设置 > 成员字段管理增加该属性。该字段的值支持链接类型填写，同时链接支持变量通配符自动替换，目前支持通配符有：userid和corpid。示例： `[工位地址](http://www.dingtalk.com?userid=#userid#&corpid=#corpid#)`。
senior_mode	Boolean	否	false	是否开启高管模式，默认值false。 true：开启。说明开启后，手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉商务电话。高管之间可以发DING、发起钉钉商务电话。 false：不开启。
hired_date	Number	否	1597573616828	入职时间，UNIX时间戳，单位毫秒。
language	String	否	zh_CN	通讯录语言，取值。 zh_CN：中文（默认值）。 en_US：英文。
force_update_fields	String	否	manager_userid	强制更新的字段，支持清空指定的字段，多个字段之间使用逗号分隔。目前支持字段: `manager_userid`。
dept_position_list	DeptPosition[]	否		部门内任职信息。
extension_i18n	Json	否	{"爱好": {"zh_ CN": "旅游", "en_ US": "travel", "aJP":"旅行"}	扩展属性的国际化值。