转移云文档所有者

转移指定云文档的所有者。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/drive/v1/permissions/:token/members/transfer_owner
HTTP Method	POST
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	bitable:app 查看、评论、编辑和管理多维表格 wiki:wiki 查看、编辑和管理知识库 docs:doc 查看、评论、编辑和管理文档 docs:permission.member:transfer 转移云文档的所有权 drive:drive 查看、评论、编辑和管理云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 bitable:bitable 查看、评论、编辑和管理多维表格（套件内）

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
token	string	云文档的 token，需要与 type 参数指定的云文档类型相匹配。可参考如何获取云文档资源相关 token。 示例值："doccnBKgoMyY5OMbUG6FioTXuBe"

查询参数

名称	类型	必填	描述
type	string	是	云文档类型，需要与云文档的 token 相匹配。 示例值：docx 可选值有： - doc: 旧版文档。了解更多，参考新旧版本文档说明。 - sheet: 电子表格 - file: 云空间文件 - wiki: 知识库节点 - bitable: 多维表格 - docx: 新版文档 - mindnote: 思维笔记 - minutes: 妙记 - slides: 幻灯片 - folder: 文件夹
need_notification	boolean	否	是否需要通知新的文件所有者。仅当使用 user_access_token 调用时有效。可选值： - true：通知对方 - false：不通知 示例值：true 默认值：true
remove_old_owner	boolean	否	转移后是否需要移除原云文档所有者的权限。可选值： - true：移除原所有者权限 - false：不移除原所有者权限 示例值：false 默认值：false
stay_put	boolean	否	在个人文件夹下的云文档是否仍留在原所有者个人文件夹下。可选值： - true：云文档留在原位置不变 - false：系统会将该内容移至新所有者的空间下 注意：仅当云文档在个人文件夹下时参数生效。 示例值：false 默认值：false
old_owner_perm	string	否	为原云文档所有者保留的具体权限。可选值： - view：可阅读角色 - edit：可编辑角色 - full_access：可管理角色 注意：仅当 remove_old_owner 为 false 时，此参数才会生效。 示例值：view 默认值：full_access

请求体

名称	类型	必填	描述
member_type	string	是	文件所有者的 ID 类型 示例值："openid" 可选值有： - email: 飞书邮箱 - openid: 开放平台 Open ID。参考如何获取不同的用户 ID - userid: 用户 ID。获取方式参考如何获取不同的用户 ID
member_id	string	是	文件所有者的 ID，与文件所有者的 ID 类型需要对应。 示例值："ou_67e5ecb64ce1c0bd94612c17999abcef"

请求体示例

{
    "member_type": "openid",
    "member_id": "ou_67e5ecb64ce1c0bd94612c17999abcef"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1063001	Invalid parameter	参数异常，可能是如下原因： - 参数类型不匹配，如： - 云文档的 token 和 type 不匹配 - 云文档不存在 - 添加协作者的 member_id 和 member_type 不匹配 - 添加的协作者不存在 - 不支持的参数调用，如： - 使用 tenant_access_token 添加部门协作者 - 给妙记添加可管理角色
403	1063002	Permission denied	调用身份对应的用户或应用不是云文档的协作者或对云文档的权限（如编辑、管理权限）不足。请参考以下方式解决： - 对于转移所有者接口，你需确保调用身份为云文档的所有者 - 对于协作者、权限设置相关接口，你需先参考[谁可以查看、添加、移除协作者](https://www.feishu.cn/hc/zh-CN/articles/360049067527-设置云文档分享-复制-下载-评论等权限#tabs0
400	1063003	Invalid operation	非法操作。该错误码表示基本参数校验没有问题，但操作不被允许，可能是如下原因： - 云文档的协作者数量到达上限，请减少协作者数量 - 因企业设置的管控策略而无法修改权限 - 受可见性限制无法修改权限。例如： - 添加用户协作者：需要调用身份与被授权对象为联系人或同组织内可搜索，且互相未屏蔽。 - 添加群协作者：需要调用身份在群内。要使用 tenant_access_token 身份添加群协作者，则需要将该应用作为机器人添加至群组中，使应用对群可见。详细步骤参考如何为应用开通云文档相关资源的权限。 - 添加部门协作者：需要调用身份对部门可见。由于应用对企业内的组织架构都不可见，所以暂不支持通过 tenant_access_token 添加部门协作者。 - 给文档所有者添加权限（不允许对文档所有者操作权限） - 协作者本身已有的权限大于请求参数内设置的权限
403	1063004	User has no share permission	用户无分享权限，请确认调用身份对该文档是否有分享权限。
404	1063005	Resource is deleted	资源已删除，请确认云文档是否还存在。
429	1063006	Too many request	请求发生限频，请降低请求频率并稍后重试。
500	1066001	Internal Error	服务内部错误，包括服务端内部超时、错误码没处理等，请联系技术支持排查。
500	1066002	Concurrency error, please retry	服务内部错误，请重试或联系技术支持排查。