移动文件或文件夹

将文件或者文件夹移动到用户云空间的其他位置。

Tip: 如果你移动的是文件夹，该接口将异步执行，同时返回该异步任务的 ID。你可使用查询异步任务状态接口查询任务执行的状态。

使用限制

该接口不支持并发调用，且调用频率上限为 5 QPS 且 10000次/天。否则会返回 1061045 错误码，可通过稍后重试解决。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/drive/v1/files/:file_token/move
HTTP Method	POST
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	drive:drive 查看、评论、编辑和管理云空间中所有文件 space:document:move 移动云空间文件夹和云文档

请求头

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

路径参数

名称	类型	描述
file_token	string	需要移动的文件或文件夹 token。 了解如何获取文件 token，参考文件概述。 了解如何获取文件夹 token，参考文件夹概述。 示例值："boxcnrHpsg1QDqXAAAyachabcef"

请求体

名称	类型	必填	描述
type	string	否	文件类型。该参数为必填，请忽略左侧必填列的“否”。如果该值为空或者与文件实际类型不匹配，接口会返回失败。 示例值："file" 可选值有： - file: 普通文件类型 - docx: 新版文档类型 - bitable: 多维表格类型 - doc: 文档类型 - sheet: 电子表格类型 - mindnote: 思维笔记类型 - folder: 文件夹类型 - slides: 幻灯片类型
folder_token	string	否	目标文件夹的 token。了解如何获取文件夹 token，参考文件夹概述。 示例值："fldbcO1UuPz8VwnpPx5a92abcef"

请求体示例

{
    "type": "file",
    "folder_token": "fldbcO1UuPz8VwnpPx5a92abcef"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ task_id	string	异步任务 ID，移动文件夹时返回。你可继续使用查询异步任务状态接口查询任务执行状态

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
500	1061001	internal error.	服务内部错误，包括超时，错误码没处理。
400	1061002	params error.	请检查请求参数是否正确。
404	1061003	not found.	请确认对应资源是否存在。
403	1061004	forbidden.	当前调用身份没有文件或文件夹的阅读或编辑等权限。请参考以下方式解决： - 若上传素材，请确保当前调用身份具有目标云文档的编辑权限 - 若上传文件，请确保当前调用身份具有文件夹的编辑权限 - 若对文件或文件夹进行增删改等操作，请确保调用身份具有足够文档权限： - 对于新建文件接口，调用身份需要有目标文件夹的编辑权限 - 对于复制文件接口，调用身份需要有文件的阅读或编辑权限、并且具有目标文件夹的编辑权限 - 对于移动文件接口，调用身份需要有被移动文件的可管理权限、被移动文件所在位置的编辑权限、目标位置的编辑权限 - 对于删除文件接口，调用身份需要具有以下两种权限之一： - 该应用或用户是文件所有者并且具有该文件所在父文件夹的编辑权限 - 该应用或用户并非文件所有者，但是该文件所在父文件夹的所有者或者拥有该父文件夹的所有权限（full access） 了解开通权限步骤，参考如何为应用开通云文档相关资源的权限。
404	1061007	file has been delete.	请确认对应节点未被删除。
403	1062524	source parent no permission.	请检查是否拥有移动文件所在文件夹的编辑权限。
403	1062535	destination parent no permission.	请检查目标文件夹是否有编辑权限。
400	1062507	parent node out of sibling num.	云空间中根目录或文件夹的单层节点超限。上限为 1500 个，你可通过将文件新建到不同文件夹中解决。