一、指令概述
该 RPA 指令用于删除飞书云盘指定类型的文件,需配置飞书访问凭证、文件唯一标识(文件Token)及文件类型(如docx、file等),执行后返回删除任务 ID,适用于飞书文件的精准清理场景。
飞书官方开发文档参考:https://open.feishu.cn/document/server-docs/docs/drive-v1/file/delete
二、调用参数配置示意

| 参数名称 | 示例 / 默认值 | 说明 |
| 指令 | 删除文件 | 固定选择 “删除文件”,执行飞书文件删除操作。 |
| 飞书访问凭证 | 飞书访问凭证 | 配置飞书开放平台的访问凭证(需具备文件删除权限,可通过 “获取飞书访问凭证” 指令生成),支持变量(界面显示 “{x}” 标识)。 |
| 文件 Token | OsYid**************** | 输入要删除文件的唯一标识 Token(需为飞书云盘合法文件的有效 Token),关键字符已打码,支持变量。 |
| 文件类型 | docx / file / bitable | 选择待删除文件的类型(需与文件实际类型匹配,否则接口返回失败),下拉可选:- file:普通文件类型;- docx:新版文档类型;- bitable:多维表格类型;- doc:文档类型;- sheet:电子表格类型等,支持变量。 |
| 生成的变量 - 运行结果 | 变量(自定义变量名) | 存储文件删除操作的执行结果(包含任务 ID),需配置为自定义变量,后续流程可调用,支持变量。 |
三、使用示例(删除新版文档场景)
场景:删除飞书云盘类型为docx的文件(Token 为OsYid****************)。
参数配置:
• 指令:删除文件
• 飞书访问凭证:feishuAuthToken(通过 “获取飞书访问凭证” 指令生成的变量)
• 文件 Token:OsYid****************(文件唯一标识,关键字符已打码)
• 文件类型:docx
• 运行结果:deleteResult(自定义变量,存储删除结果)
执行流程:
调用该 RPA 指令后,RPA 会通过 feishuAuthToken 完成飞书 API 认证,根据打码后的文件 Token 和匹配的文件类型docx,执行文件删除操作;操作完成后,将包含任务 ID 的结果存入 deleteResult 变量,便于后续确认删除状态或记录操作日志。
四、返回结果说明
飞书 API 标准返回示例(成功场景):
指令执行后,“运行结果” 变量(如deleteResult)会存储包含删除任务 ID 的 JSON 结果,格式如下:
| { "code": 0, "msg": "success", "data": { "task_id": "7360595374803812356" }} |
响应字段含义:
• code:状态码,0 表示删除操作成功,非 0 为失败(具体错误码含义参考飞书官方文档)。
• msg:提示信息,success 表示删除成功。
• data.task_id:删除任务的唯一标识 ID,可用于追踪删除任务的执行状态(若需确认删除结果,可结合飞书任务查询接口使用)。
五、注意事项
1. 访问凭证权限:“飞书访问凭证” 需具备文件删除权限(如 “Delete file” 权限)且未过期,否则会返回 code=403(权限不足)错误。
2. 文件类型匹配性:文件类型需与待删除文件的实际类型完全一致(如文件是新版文档则选docx,普通文件选file),否则接口会返回失败(如code=400 参数不匹配错误)。
3. 文件 Token 准确性:文件Token 需为飞书云盘合法文件的有效 Token(打码不影响实际值校验),否则会返回 code=404(文件不存在)错误。
4. 操作不可逆性:文件删除操作一旦执行,飞书云盘中的对应文件将被移除(若需恢复需依赖飞书回收站机制),请确保操作前确认文件无需保留。
六、延伸应用
可结合 RPA 的 “获取文件夹中的文件清单” 指令,实现飞书云盘文件批量精准清理:例如先调用 “获取文件夹中的文件清单” 指令,筛选出类型为docx且满足清理条件的文件 Token 列表,再循环调用本 “删除文件” 指令,自动删除列表中的文件,替代人工手动逐个判断类型并删除的重复工作,提升文件清理效率。