Structure

Add a swimlane

Add a swimlane (a row of the board for one kind of work) with its own lanes and flow rules, from a preset or as a copy of another swimlane's lanes and rules (without its cards).

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 add_swimlane.

post/projects/{project}/swimlanes

Request

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

Path parameters

projectstring required

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

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.

Idempotency-Keystring

Makes a retry safe: the same key and request within 24 hours answers the first result again instead of creating a second one.

Request body

namestring required

Name, like "Bugs".

preset'agentFlow' | 'bugTriage' | 'research' | 'simpleFlow'

Starting lanes and rules: agentFlow (Ideas → Ready → Working → Needs you → Review → Shipped), bugTriage, research or simpleFlow (default).

copyOfstring

Copy this swimlane's lanes and rules instead.

positioninteger

Optional 1-based position among the swimlanes (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

Created. The tool's result.

swimlanestring required
lanesstring[] required

Changes

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