更新用户

调用该接口更新企业用户信息。

请求

基本
请求方式PATCH
请求地址/openapi/v3/contacts/users/:union_id

请求头

名称类型必填描述
Authorizationstring值格式Bearer {{access_token}}

调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证

支持鉴权类型:
应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token
用户级token:以登录用户身份调用 API,校验用户的可见数据范围。参考 获取登录用户access_token
Content-Typestring固定值:application/json; charset=utf-8

路径参数

名称类型必填描述
union_idstring用户ID

请求参数

名称类型必填描述
namestring姓名,1-64字符
department_idsarray[string]如果为空,则保持原状
mobilestring手机号(合法手机号校验),mobile、email、username 不能同时为空
emailstring邮箱(合法邮箱校验),mobile、email、username 不能同时为空
employee_numberstring工号,不超过64字符
positionstring职位,不超过100字符
join_timestring入职时间,格式:2006-01-02
usernamestringSSO登录名,mobile、email、username 不能同时为空,不超过64字符

请求体示例

1{
2 "name": "zyxtest",
3 "mobile": "+86 15012453582",
4 "email": "xx@qq.com",
5 "department_ids": [
6 "923168858645200896"
7 ],
8 "employee_number": "458152",
9 "position": "架构师",
10 "join_time": "2023-09-01",
11 "username": "zyxtest"
12}

响应

响应体

1{
2 "code": 0,
3 "msg": "success"
4}