lark-base-record-delete.md 1.3 KB

base +record-delete

前置条件: 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

删除一条记录。

推荐命令

lark-cli base +record-delete \
  --base-token app_xxx \
  --table-id tbl_xxx \
  --record-id rec_xxx \
  --yes

参数

参数 必填 说明
--base-token <token> Base Token
--table-id <id_or_name> 表 ID 或表名
--record-id <id> 记录 ID

API 入参详情

HTTP 方法和路径:

DELETE /open-apis/base/v3/bases/:base_token/tables/:table_id/records/:record_id

返回重点

  • 返回 deleted: truerecord_id

工作流

这是高风险写入操作。CLI 层要求显式传 --yes;如果用户已经明确要求删除且目标明确,直接执行并带上 --yes,不要再补一次确认。

  1. 建议先用 +record-get 确认目标记录。
  2. 只有当目标记录仍不明确时,才继续追问;如果删除意图和目标都明确,直接执行。

坑点

  • ⚠️ 高风险写操作,删除后不可恢复。
  • ⚠️ 忘记带 --yes 会被 CLI 拦截。

参考