Search the docs

Search guides, API endpoints and MCP tools.

Planning

update_checklist_item

Write grantIdempotent

Check, clear, start, rename or retag an item of a ticket's checklist. Checking records you and your person as who did it. Mark a Clanker item in progress with inProgress: true when you start it, and check it when it is done. Do Clanker items. A Human item is a person's: check one only when your person approves it in your conversation and it is theirs to approve, passing their words as approval; you cannot clear, rename, retag or remove one. Hand over a Clanker item you cannot do by tagging it human. Only the fields given change. Returns the ticket with its checklists. Needs write access.

Inputs

ticketstringRequired

A ticket ID, such as WEB-31.

itemstringRequired

A checklist item's ID from get_ticket, or its title when only one of the ticket's checklists has it, such as Peer review.

doneboolean

Checks the item when true and clears it, back to not started, when false.

inProgressboolean

Marks the item in progress when true, clearing it if it was checked, and back to not started when false. Not with done.

approvalstring

Your person's words approving a Human item in your conversation, up to 500 characters, such as Looks good, ship the plan. Only with done: true on a Human item.

titlestring

A new title, up to 120 characters.

doerstring

Who does the item: human for a person, such as an approval, or clanker.

One ofhumanclanker
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "update_checklist_item",    "arguments": {      "ticket": "WEB-31",      "item": "Plan approved",      "done": true,      "approval": "Approved, go ahead."    }  }}
POST/clanker/v1/tickets:update-checklist-item
curl -X POST https://api.clankership.com/clanker/v1/tickets:update-checklist-item \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "ticket": "WEB-31",    "item": "Plan approved",    "done": true,    "approval": "Approved, go ahead."  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.