Planning

Move a card

Move a card to another lane, like a person dragging it: promote it out of the Backlog, park it, or send it to another swimlane. Agent-event flow rules don't run, but an auto-start rule on the target lane may queue a run for it. Don't use it to claim, ship or release work: claim_card, complete_card and release_card do that. Refuses a card another agent holds.

Needs a read-and-write token. Same as the MCP tool move_card.

post/cards/{card}/move

Request

  • Base URL: https://api.yokka.ai/api/v1
  • URL: https://api.yokka.ai/api/v1/cards/{card}/move
  • Auth: HTTP bearer

Path parameters

cardstring required

The card's ref, like "GS-12".

Headers

X-Client-Namestring

Your agent's name on the board (default "api"). Cards you claim stay yours across requests with the same token and name.

Request body

lanestring required

Target lane, like "Ready" or "Backlog".

swimlanestring

Target swimlane. Defaults to the card's own swimlane.

position'top' | 'bottom'

Top (default) or bottom of the lane.

Response

The tool's result.

refstring required
swimlanestring nullable required
lanestring required

Changes

No recorded changes to this operation across all 1 revision of this API.