approval tasks approve

同意一个审批任务（用户级写操作）。通常先通过 tasks query 拿到 task_id 和 instance_code，必要时再用 instances get 查看详情，然后再执行同意。

Caution

这是 high-risk-write 写操作。建议先用 --dry-run 预览；真正执行时，如果用户已明确同意审批且目标任务无误，再带 --yes 运行。不要在未获用户明确同意时静默追加 --yes。

需要的 scopes: ["approval:task:write"]

命令

# 先预览请求，不实际执行
lark-cli approval tasks approve \
  --data '{"instance_code":"<INSTANCE_CODE>","task_id":"<TASK_ID>","comment":"同意"}' \
  --as user \
  --dry-run

# 同意审批任务，并附带审批意见
lark-cli approval tasks approve \
  --data '{"instance_code":"<INSTANCE_CODE>","task_id":"<TASK_ID>","comment":"同意"}' \
  --as user \
  --yes

# 需要回填表单时，传入 form（按当前命令定义，form 为字符串化 JSON）
lark-cli approval tasks approve \
  --data '{"instance_code":"<INSTANCE_CODE>","task_id":"<TASK_ID>","comment":"同意并补充信息","form":"[{\"id\":\"user_name\",\"type\":\"input\",\"value\":\"Alice\"}]"}' \
  --as user \
  --yes

# 通过文件传入请求体，适合较长 comment / form
lark-cli approval tasks approve \
  --data @./approve-body.json \
  --as user \
  --yes

参数

参数	必填	说明
`--data '{...}'`	是	请求体 JSON，使用 JSON 传入
`instance_code`	是	审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取
`task_id`	是	审批任务 ID；通常先通过 `tasks query` 获取
`comment`	否	审批意见，例如 `同意`、`已确认`
`form`	否	表单数据；按当前命令定义，字段类型为 `string`，通常传字符串化 JSON；仅在审批动作需要同时回填表单时使用
`--as user`	否	建议显式指定用户身份；审批同意通常必须以用户身份执行
`--yes`	否	确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10
`--format`	否	输出格式：`json`（默认）、`ndjson`、`table`、`csv`
`--dry-run`	否	预览 API 调用，不执行

典型前置步骤

先查到待办任务：

lark-cli approval tasks query --params '{"topic":"1"}' --as user

常用到的两个字段：

字段	说明
`tasks[].instance_code`	审批实例 Code；执行 approve / reject / rollback 等操作时通常都需要
`tasks[].task_id`	审批任务 ID；与 `instance_code` 配对使用

如需先确认表单、节点、审批流进度，可继续查看实例详情：

lark-cli approval instances get --params '{"instance_code":"<INSTANCE_CODE>"}' --as user

使用建议

instance_code 和 task_id 要成对使用：仅有实例 ID 或仅有任务 ID 都不足以准确执行同意操作。
优先从 tasks query 的待办列表拿参数：尤其是 topic=1 的待办审批，最适合作为 approve 的输入来源。
先检查是否支持 API 操作：如果上一步 tasks query 返回的 tasks[].support_api_operate 为 false，说明该任务可能不支持通过 API 同意/拒绝。
comment 建议简洁明确：例如 同意、同意，信息已核对。没有审批意见要求时可省略。
form 只在确有需要时传：大多数简单同意场景只传 instance_code、task_id、可选 comment 即可。
先 --dry-run 再执行：尤其在批量处理、表单回填或任务来源不明确时，先预览更安全。

3.6 KiB Raw Blame History Unescape Escape

approval tasks approve

命令

参数

典型前置步骤

使用建议

3.6 KiB

Raw Blame History