Update a card
update_cardChanges any of a card's fields in one call, and archives or restores it (archived). Fields you leave out stay as they are. Pass updates to change several cards at once. Pass checklist as {add, remove} to change items in place. To move a card use move_card. A field that changed since you read the card refuses the call: call show, then write again.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | The description (markdown). | |
| park | No | With snoozeUntil: park in Snoozed. Default true. | |
| dueAt | No | A due date. Needs the board's due dates setting. | |
| owner | No | A person (name or id) to own a card with no owner. | |
| prUrl | No | The pull request (https). | |
| recur | No | Repeat the card: every (daily, weekly, monthly), at, to. Null stops it. | |
| title | No | ||
| branch | No | ||
| cardId | No | Card id, number (12) or key (WEB-12). | |
| effort | No | low, medium or high. | |
| labels | No | The whole set. addLabels and removeLabels change some. | |
| tenant | No | A group, such as a client. | |
| boardId | No | Board id or slug. | |
| persona | No | The persona to act as. | |
| updates | No | Several cards: each has cardId and the fields above. | |
| verbose | No | Return the whole card. | |
| version | No | The card version show gave you. Left out, this connection's last read counts. | |
| archived | No | True archives, false restores. | |
| assignee | No | A persona name. Null clears it. | |
| estimate | No | XS, S, M, L or XL. Needs the board's estimates setting. | |
| expedite | No | Let the card pass the WIP cap and be claimed first. | |
| goalMode | No | Keep going until the acceptance criteria hold. | |
| maxTurns | No | Turns in goal mode. Null clears it. | |
| priority | No | 3 urgent, 2 high, 1 normal, 0 low. | |
| addLabels | No | ||
| checklist | No | An array replaces the list with {text, done} items. An object changes it: {add: [texts], remove: [positions from 1, or texts]}. | |
| modelHint | No | A model the work suits. | |
| ownerNote | No | Why, for that person. | |
| skillPins | No | Skills to load first. | |
| acceptance | No | What done means. Null clears it. | |
| touchPaths | No | Files it will touch. | |
| snoozeUntil | No | Hide the card until this date. Null clears it. | |
| circuitLimit | No | Failures that stop claims of the card. | |
| maxRuntimeMs | No | Longest run in milliseconds. Null clears it. | |
| removeLabels | No | ||
| verifyCommand | No | The command that proves it. | |
| workspaceHint | No | Where the work happens. |