批量删除员工角色

调用本接口批量删除员工的角色。

权限

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

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

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/role/removerolesforemps

Query参数

名称	类型	是否必填	示例值	描述
access_token	String	是	6ed1bxxx	调用该接口的应用凭证，通过获取企业内部应用的access_token接口获取。

Body参数

名称

类型

是否必填

示例值

描述

roleIds

String

是

1507113578

角色roleId列表，可调用获取角色列表接口获取。

最大列表长度为20，多个roleId用英文逗号（,）分隔。

userIds

String

是

user100,user101

员工的userid，可通过调用根据手机号查询用户获取userId。

最大列表长度为100，多个userId用英文逗号（,）分隔。

返回参数

名称	类型	示例值	描述
errcode	Number	0	返回码。
errmsg	String	ok	返回码描述。
request_id	String	10c1rigbngrp5	请求ID。

示例

请求示例（HTTP）

POST https://oapi.dingtalk.com/topapi/role/removerolesforemps?access_token=ACCESS_TOKEN

请求正文

{
        "roleIds":"1507113578",
        "userIds":"user100,user101"
}

请求示例（JAVA SDK）

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/role/removerolesforemps");
OapiRoleRemoverolesforempsRequest req = new OapiRoleRemoverolesforempsRequest();
req.setRoleIds("1507113578");
req.setUserIds("user100,user101");
OapiRoleRemoverolesforempsResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

返回示例

{
        "errcode":0,
        "request_id":"10c1rigbngrp5"
}

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
33011	无效的roleIds	请检查roleIds是否正确
33012	无效的userId	请检查userId是否正确
-1	系统繁忙	请稍后再试