添加知识空间成员

添加知识空间成员或管理员。

知识空间具有类型和可见性的概念。不同的类型或可见性可以对本操作做出限制：

可见性限制：公开知识空间（visibility为public）对租户所有用户可见，因此不支持再添加成员，但可以添加管理员。

类型限制：个人知识空间（type为person）为个人管理的知识空间，不支持添加其他管理员（包括应用/机器人）。但可以添加成员。

知识空间权限要求，当前使用的 access token 所代表的应用或用户拥有：

为知识空间管理员

错误码

HTTP状态码	错误码	描述	排查建议
400	131001	rpc fail	服务报错，请稍后重试，或者拿响应体的header头里的x-tt-logid咨询oncall定位。
400	131002	param err	通常为传参有误，例如数据类型不匹配。请查看具体接口报错信息，报错不明确时请咨询oncall。
400	131003	out of limit	超出操作限制，例如节点数量限制。请参阅下表。原/目标知识空间总节点数不超过40万。原/目标知识空间目录树不超过50层。目的父节点下单层节点数不超过2000。单次移动节点数（带子节点）不超过2000。
400	131004	invalid user	非法用户。请咨询oncall。
400	131005	not found	未找到相关数据，例如id不存在。相关报错信息参考：member not found：用户不是知识空间成员（管理员），无法删除。identity not found: userid不存在，无法添加/删除成员。space not found：知识空间不存在node not found：节点不存在document not found：文档不存在报错不明确时请咨询oncall。
400	131006	permission denied	权限拒绝，相关报错信息参考：wiki space permission denied：需要为知识空间成员（管理员）node permission denied：读操作时需要有节点阅读权限。写操作（创建、移动等）需要节点容器编辑权限。no source parent node permission：需要原父节点容器编辑权限。no destination parent node permission：需要目的父节点容器编辑权限。only task creator can query status：为任务创建者（用户或应用/机器人）如果使用tenant_access_token调用，请确保应用/机器人为知识空间成员。参阅如何将应用添加为知识库管理员（成员）。当接口报错信息不明确时，请咨询oncall。
400	131007	internal err	服务内部错误，请勿重试，拿返回值的header头里的x-tt-logid咨询oncall定位。
400	131008	already exist	数据已存在，请勿重复操作。
400	131101	invalid operation	无效知识空间操作。例如公开空间禁止添加成员。请参考具体接口报错信息和文档描述。

curl --location --request POST 'https://open.feishu.cn/open-apis/wiki/v2/spaces/1565676577122621/members' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "member_type": "userid", "member_id": "1565676577122621", "member_role": "admin" }'

请求参数

Path 参数

space_id

string

必需

知识空间id 示例值："1565676577122621"

示例值:

1565676577122621

Query 参数

need_notification

string

可选

添加权限后是否通知对方示例值：true/fasle

示例值:

true/fasle

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

member_type

string

必需

“openchat” - 群id “userid” - 用户id “departmentid” - 部门id “openid” - 应用openid “unionid” - unionid 示例值："userid"

member_id

string

必需

用户id 示例值："1565676577122621"

member_role

string

必需

角色: “admin” - 管理员 “member” - 成员示例值："admin"

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

member

object

知识空间成员

必需

添加知识空间成员

错误码#

请求参数

返回响应

错误码