变更企业成员角色

最近更新时间:2024-07-08 11:48:53

我的收藏

接口描述

描述:批量变更企业成员角色,仅有角色编辑权限的用户可调用接口,不允许将用户身份变更为超级管理员,也不允许变更超级管理员用户的角色。不支持 OAuth2.0 鉴权访问。
请求方式:PUT
自建应用权限点:管理企业用户。
接口请求域名:
https://api.meeting.qq.com/v1/corp/user-roles


输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明
参数名称
必选
参数类型
参数描述
operator_userid
String
操作者 userid,必须为企业下具有角色编辑权限的用户。
role_code
String
用户角色。
users
String 数组
成员 userid 列表。

输出参数

成功返回空消息体,失败返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
500
60003
超管用户不支持更改角色信息。
500
60001
用户已禁用。
500
60002
用户未激活。
500
190442
企业用户无操作权限。

示例

输入示例

PUT https://api.meeting.qq.com/v1/corp/user-roles
{
"operator_userid": "meeting4531785",
"role_code": "NORMAL_ROLE",
"users": ["test_16275481671157"]
}

输出示例

{}