跳到主要内容

更新成员

更新成员信息


权限说明

仅支持专有轻流;

「超管accessToken」和「权限组accessToken」都可以调用,「权限组accessToken」须具有通讯录权限。

请求

**请求方式:**POST

请求地址:https://自有域名/openApi/user/:userId

请求地址中:userId为需要替换的变量,根据实际获取值更新,示例如下:

POST https://abcd.qingflow.com/openApi/user/88888

2.1 参数说明(路径参数):

参数必须说明
userId用户ID,获取方式参考:基本概念介绍

2.2 参数说明(查询参数):

2.3 请求头(Header)

参数必须说明
accessToken调用接口凭证。获取方法请查看“文档”

2.4 请求体(Body)

参数必须类型说明
userIdstring用户的userId
namestring用户名
areaCodestring区号,传手机号时必填
mobileNumstring手机号
emailstring邮箱
headImgstring头像
department[array]同步部门id列表
role[array]同步角色id列表
customRole[array]成员所属自建角色列表(仅企业微信/钉钉/飞书等特殊工作区适用)
customDepartment[array]成员所在自建部门列表(仅企业微信/钉钉/飞书等特殊工作区的专有轻流工作区适用)
beingDisabledboolean是否禁用成员
superiorIdstring不传不会更新直属主管、传空值会清空直属主管

2.5 请求体示例

{
"userId": "", //必填
"name": "",
"areaCode": "86",
"mobileNum": "",
"email": "", //邮箱,必填
"headImg": "",
"department":[],
"role": [],
"customRole": [],
"customDepartment": [],
"beingDisabled": "true"
}

返回

3.1 返回体

参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelations关联的设置,这里没用
resultobject返回结果
userIdstring用户的userId

3.2 返回体示例

{
"errCode": 0,
"errMsg": null,
"result": {
"userId": "用户的userId"
}
}