更新角色名称旧版SDK
更新于 2024-02-27调用本接口,更新角色名称。
重要
不允许修改“默认”分组内的角色,包括负责人、主管、主管理员和子管理员。

权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 维护通讯录的接口访问权限 | |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式:POST
请求地址:https://oapi.dingtalk.com/role/update_role
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
roleId | Number | 是 | 1560985325 | 要更新的角色ID,可以调用获取角色列表接口获取。 “默认”分组内的角色不支持修改,包括:负责人、主管、主管理员、子管理员。 |
roleName | String | 是 | 服装制造 | 修改的角色名称。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
示例
请求示例(HTTP)
Loading...
请求正文
Loading...
请求示例(JAVA SDK)
Loading...
返回示例
Loading...
错误码
错误码(errcode) | 错误码描述(errmsg) | 解决方案 |
660000 | 参数为空 | 请补全参数 |
33011 | 无效的roleId | 请检查roleId是否正确 |
-1 | 系统繁忙 | 请稍后再试 |