Update work list
update_work_listChange the work list a workflow keeps between runs. op: add (items; on a watch list, new watched items), remove (items; on a watch list, stop watching them), mark_handled or unmark (items), skip_approval (drafts waiting for approval), clear (empty the list; keepHandled keeps handled items on a collect list; a watch list keeps its watched items and drops their readings). Confirm with the user before remove or clear. Refused while a run of this workflow is in progress. To change what the list records, use update_workflow.
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": {
"op": "<op>"
},
"name": "update_work_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | ||
| items | No | The items to change (not for clear): keys, or { key, label, url } objects. On a watch list, label names a watched item. | |
| title | No | Exact workflow title (case-insensitive) — alternative to workflowId | |
| workflowId | No | 24-hex workflow id | |
| keepHandled | No | clear on a collect list: keep the items already handled |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | ||
| items | No | The changed items as the list now holds them | |
| notes | No | ||
| changed | Yes | Items changed | |
| success | Yes | ||
| workflowId | Yes |