Structure

Edit a lane

Rename, describe, recolor or reorder a lane, set its WIP limit (0 clears it), or mark it as a done lane.

Needs a token with the board.manage permission. Without it: This token can't change lanes, swimlanes or flow rules. Ask the human to do it, or to create a token with that permission turned on. Same as the MCP tool update_lane.

patch/projects/{project}/swimlanes/{swimlane}/lanes/{lane}

Request

  • Base URL: https://api.yokka.ai/api/v1
  • URL: https://api.yokka.ai/api/v1/projects/{project}/swimlanes/{swimlane}/lanes/{lane}
  • Auth: HTTP bearer

Path parameters

projectstring required

Project slug, name or card prefix, like "getting-started" or "GS".

swimlanestring required

Swimlane name, like "Bugs".

lanestring required

Lane name, like "Ready" or "Backlog".

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

namestring

New name.

descriptionstring nullable

What the lane means. Pass "" to clear.

wipLimitinteger nullable

Work-in-progress limit, 1–99; 0 clears it.

doneboolean

Whether the lane holds finished work (Shipped, Fixed, Done): its cards stop counting as open.

positioninteger

Optional 1-based position among the swimlane's lanes (1 is first). Omit to leave it where it is.

color'slate' | 'blue' | 'indigo' | 'violet' | 'fuchsia' | 'pink' | 'orange' | 'amber' | 'lime' | 'green' | 'teal' | 'sky'

Optional color.

Response

The tool's result.

swimlanestring required
lanestring required

Changes

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