finish_task
Close a task card by recording its result kind and evidence, moving it to done or review, canceling your active wait, and releasing your checkout.
Instructions
Close the card with its result: sets result_kind, moves the card to done (or review, when someone must accept a live result), writes the evidence as the closing comment, cancels your active wait and releases your checkout. Both result_kind and evidence are required; the existing move gates (closing comment length, linked MRs merged, open subtasks) still apply and their refusals are returned as is.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"result_kind": "<result_kind>",
"evidence": "<evidence>"
},
"name": "finish_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Target status: done or review. review means the result is live and awaits someone's acceptance. | |
| task_id | Yes | The card to close (UUID or 6-12 hex short id). | |
| turn_id | No | Optional turn id within the session (max 200 chars), copied onto the outcome. | |
| evidence | Yes | Proof of each acceptance criterion — commands and their quoted output, max 4096 chars. | |
| session_id | No | Optional runner session id (max 200 chars), copied onto the recorded outcome and wait. | |
| result_kind | Yes | What the card delivered: change, defect, research, content or ops. | |
| evidence_links | No | Optional URLs backing the evidence (MR, pipeline, artifact). |