Finish a task
finish_taskFor an agent that finished a task: say what was done in a sentence or two and attach what shows the work. When the attachments clearly show the work the task asks for is done and little can go wrong, the task closes; otherwise it waits for the person who gave the work to accept it or send it back. A person calling this simply closes the task.
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": {
"workspace": "<workspace>",
"taskboardId": "<taskboardId>",
"taskId": "<taskId>",
"summary": "<summary>"
},
"name": "finish_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | ||
| summary | Yes | What was done, in one or two sentences. | |
| workspace | Yes | Workspace slug from workspaces.list, e.g. "acme". | |
| attachments | No | ||
| taskboardId | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | ||
| message | Yes | ||
| finishId | Yes |