Swimlane

Create swimlane (cross-functional) diagrams with horizontal rows representing actors, departments, or roles, and flowchart nodes positioned within them.

Updated 16 Sep 20262 min read

Send "type": "swimlane".

Create swimlane (cross-functional) diagrams with horizontal rows representing actors, departments, or roles, and flowchart nodes positioned within them.

Also available as the MCP tool render_swimlane. The same payload works through either surface.

Fields

data

classstringrequired

Always 'GraphLinksModel'

swimlaneRowsobject[]required

Array of horizontal swim lane definitions

Child attributes

idstringrequired

Unique row ID (e.g., "row_1")

titlestringrequired

Lane label (actor, department, role)

colorstringrequired

Background color (soft pastel hex)

nodeDataArrayobject[]required

Array of flowchart nodes assigned to swim lanes

Child attributes

keystringrequired

Unique node identifier

textstringrequired

Node label

rowstringrequired

swimlaneRows id this node belongs to

locstringrequired

Position as "x y" string

widthnumber

120 for processes, 100 for diamonds

heightnumber

60 for processes, 80 for diamonds

shapeenum<string>required

Node shape. One of RoundedRectangle, Diamond, Ellipse or Rectangle.

colorstringrequired

Node hex color

linkDataArrayobject[]required

Array of connections between nodes

Child attributes

fromstringrequired

Source node key

tostringrequired

Target node key

fromSpotenum<string>required

One of Top, Bottom, Left or Right.

toSpotenum<string>required

One of Top, Bottom, Left or Right.

textstring

Link label (e.g., "Yes", "No")

segmentFractionnumber

0.1-0.9, label position along the path — give adjacent labelled links different values (0.35 / 0.65) so labels do not stack

Example

{
  "type": "swimlane",
  "data": {
    "class": "string",
    "swimlaneRows": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "color": "string"
      }
    ],
    "nodeDataArray": [
      {
        "key": "string",
        "text": "Interview 5 users",
        "row": "string",
        "loc": "string",
        "width": 0,
        "height": 0,
        "shape": "RoundedRectangle",
        "color": "string"
      }
    ],
    "linkDataArray": [
      {
        "from": "string",
        "to": "string",
        "fromSpot": "Top",
        "toSpot": "Top",
        "text": "Interview 5 users",
        "segmentFraction": 0
      }
    ]
  }
}

Was this page helpful?