更新知识库成员权限新版SDK
更新于 2024-01-11调用本接口,更新用户对知识库的权限。
为了提升接口的使用体验, 知识库接口已升级。本文档已于2023年7月6日迁移至历史文档(不推荐)目录,接口不再支持新应用接入, 已接入的应用可继续调用。
如果未使用本接口,推荐使用修改权限接口。
如果已使用本接口,建议您根据自身实际情况评估是否切换至推荐接口。
新老接口中的ID不兼容, 不支持混用。

权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
企业内部应用 | 支持 | 知识库写权限 | |
第三方企业应用 | 支持 | 知识库写权限 | |
第三方个人应用 | 暂不支持 | 知识库写权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
名称 | 类型 | 是否必填 | 描述 |
workspaceId | String | 是 | 知识库ID。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
operatorId | String | 是 | 发起添加权限操作用户的unionId。 |
members | Array | 是 | 被操作用户组。 说明 可一次操作多个用户,最大数量限制50,超过数量限制会直接报错。 |
memberId | String | 是 | 被更新的文档成员。 |
memberType | String | 是 | 用户类型,取值:
|
roleType | String | 是 | 用户权限,取值:
|
示例
请求示例
返回示例
错误码
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 | 系统内部错误 | 系统内部错误 |