选择应用类型
第三方企业应用开发

更新知识库成员权限新版SDK

更新于 2024-01-11调用本接口,更新用户对知识库的权限。

重要
  1. 为了提升接口的使用体验, 知识库接口已升级。本文档已于2023年7月6日迁移至历史文档(不推荐)目录,接口不再支持新应用接入, 已接入的应用可继续调用。

    • 如果未使用本接口,推荐使用修改权限接口。

    • 如果已使用本接口,建议您根据自身实际情况评估是否切换至推荐接口。

  2. 新老接口中的ID不兼容, 不支持混用。

权限

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

应用类型

是否支持

权限

API Explorer调试

企业内部应用

支持

知识库写权限

API Explorer

第三方企业应用

支持

知识库写权限

API Explorer

第三方个人应用

暂不支持

知识库写权限

暂不支持

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

调用该接口的访问凭证。

Path参数

名称

类型

是否必填

描述

workspaceId

String

知识库ID。

Body参数

名称

类型

是否必填

描述

operatorId

String

发起添加权限操作用户的unionId。

members

Array

被操作用户组。

说明

可一次操作多个用户,最大数量限制50,超过数量限制会直接报错。

memberId

String

被更新的文档成员。

  • memberType如果是USER,该参数值传员工的unionId。

  • memberType如果是DEPT,该参数值是传部门ID。

memberType

String

用户类型,取值:

  • USER:用户

  • DEPT:部门

roleType

String

用户权限,取值:

  • ONLY_VIEWER:只读

  • VIEWER:可查看和下载

  • EDITOR:可编辑

示例

请求示例

Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

返回示例

Loading...

错误码

HttpCode

错误码

错误信息

说明

400

invalidRequest.inputArgs.overLimit

批量操作数量超过限制

批量接口操作数量超限

400

invalidRequest.permission.operationIllegal

权限操作非法

权限操作非法,不能移除自己的权限,也不能移除所有者

400

invalidRequest.permission.overLimit

权限信息数量超过限制

增加的权限信息数量超过限制

400

invalidRequest.inputArgs.invalid

方法入参校验失败

方法入参校验失败,检查是否有必填参数未填,或者unionId是否合法等

403

forbidden.user.notInOrg

操作用户不在组织内

操作用户不在组织内

403

forbidden.accessDenied

用户无操作权限

当前用户无此操作权限

404

invalidRequest.resource.notFound

资源找不到

资源找不到

404

invalidRequest.workspace.deleted

知识库被删除

知识库被删除

500

internalError

系统内部错误

系统内部错误

点击纠错