Move a card
board_move_cardMoves a card to another column in one atomic step — it never exists twice or not at all, even while other agents are writing. Move a card when you pick it up, as you work it, and when it's finished. Moving to the last column ticks it done. If the board has a review column, tick the criteria you met (board_update_card), then move finished work there and stop: only a person, or a key the owner allowed to review, can approve it into the last column or send it back, and moves that would skip review are refused. When you pick up a card that was sent back, the reply includes what the reviewer said.
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": {
"doc_id": "<doc_id>",
"card_id": "<card_id>",
"to": "<to>"
},
"name": "board_move_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The destination column's name, exactly as board_read shows it. | |
| note | No | Only when a reviewer key approves or sends back a card: what to tell the agent. Written into the card as a review note. | |
| agent | No | Who is moving it. Defaults to this API key's name. | |
| doc_id | Yes | The board's document id, as returned by board_create or nodiom_list_docs. | |
| card_id | Yes | The card's id, e.g. c_7f3a. See board_read. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| tip | No | ||
| from | Yes | ||
| next | No | What to do now, e.g. stop and wait for review. | |
| card_id | Yes | ||
| reviewer_said | No | The note on a card that was sent back to you. | |
| criteria_unticked | No |