热门推荐

5分钟开发酷应用如何开发酷应用什么是「含钉量」

常见索引

机器人免登OA审批

工作台开放

连接器开发

智能硬件接入

能力全景图

钉钉设计开放

选择应用类型

企业内部应用开发

学习地图

动态与公告

应用开发平台简介（新版）

应用开发平台简介

开发应用（新版）

开发应用

服务端API

开发指南

API总览

身份验证（免登）

获取访问凭证

通讯录管理

上下游组织（原合作空间）

上下级组织（原关联组织）

考勤

日志

日程

公告

音视频

钉工牌

工作台

服务窗

OA审批

即时通信IM

智能人事

智能填表

智能交互

组织大脑

待办任务

文档/文件

钉钉客联

互动卡片

应用管理

企业文化

专属开放

专属钉钉

概述

权限申请

审计

可信设备

互动服务窗

产业互联

概述

获取可打标部门列表

获取子标签列表

设置部门伙伴类型和伙伴编码

修改伙伴类型可见性

查询伙伴角色列表

修改角色可见性

发送邀请函

根据userId查询人员的标签信息

DING服务

同步存储数据

发送电话DING

专属小红点推送

获取文件操作记录

发送文件更改的评论

获取群活跃明细列表

查询企业内部群信息

获取防截屏操作记录

查询实人认证状态

查询人脸录入状态

获取实人认证接口调用记录

获取人脸对比接口调用记录

企业内部群禁言或解除禁言

根据会议逻辑ID查询会议基本信息

获取企业专属钉钉权益列表

获取专属存储文件路径

更新发送文件的检测状态

企业员工专属安全管控功能命中查询

生态开放

智能硬件

行业开放

HCM 主数据

宜搭应用开发

客户管理（官方CRM）

Teambition 项目管理

钉钉快办

Agoal

炼丹炉（模型服务）

AI 助理

365会员

附录

客户端API

事件订阅

参考

常见问题

历史文档

修改角色可见性新版SDK

更新于 2023-01-18

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口修改角色标签可见性。

角色的标签如下图所示：

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	伙伴钉部门信息写权限	API Explorer
第三方企业应用	支持	伙伴钉部门信息写权限	API Explorer
第三方个人应用	暂不支持	伙伴钉部门信息写权限	暂不支持

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。
第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Body参数

名称	类型	是否必填	描述
labelId	Long	是	标签iID。
deptIds	Array of Long	否	可见的部门ID列表。
userIds	Array of String	否	可见的员工userid列表。

返回参数

名称	类型	描述
	Boolean	调用是否成功。

示例

请求示例

HTTP

Loading...

Java

Loading...

Python

Loading...

PHP

Loading...

Go

Loading...

Node.js

Loading...

C#

Loading...

C++

Loading...

返回示例

Loading...

错误码

HttpCode	错误码	错误信息	说明
400	parameter.invalid	参数错误	参数漏填或者格式错误
500	system.busy	系统繁忙	内部服务发生的异常情况

这篇文档是否有帮助？

本页内容

点击纠错