1.3 KiB
1.3 KiB
task +complete
Prerequisites: Please read
../lark-shared/SKILL.mdto understand authentication, global parameters, and security rules.
Mark a task as completed.
Recommended Commands
# Complete a task
lark-cli task +complete --task-id "<task_guid>"
# A task applink is accepted directly; the CLI extracts its guid query value
lark-cli task +complete --task-id "https://applink.larksuite.com/client/todo/task?guid=<task_guid>"
Parameters
| Parameter | Required | Description |
|---|---|---|
--task-id <guid-or-applink> |
Yes | Task OpenAPI GUID or a task applink containing guid=. Display task IDs such as t104121 / suite_entity_num are rejected. |
Workflow
- Confirm the task to complete.
- Execute the command.
- Read
data.status,data.completed_at, anddata.already_completedfrom the result.already_completed: truemeans the shortcut observed an already-completed task and skipped the PATCH. - Do not routinely call
task tasks getwhen the result already reportsstatus: doneand a non-zerocompleted_at. Query details only if confirmation fields are absent or the user explicitly asks for a full verification.
Caution
This is a Write Operation -- You must confirm the user's intent before executing.