create_whiteboard_elements
Create up to 100 whiteboard elements in one transactional call (all-or-nothing, one realtime event). Native sizes, colors, and text placement are applied server-side — usually give just type + text (+ color). Omit x/y and elements are auto-arranged (grid by default; arrange: row|column|grid, origin_x/origin_y/gap to tune); give x/y for full control. Frames contain elements via parent_id (an existing frame uid) or parent_ref (the ref of a frame earlier in THIS call). Connectors bind elements by uid (source_id/target_id) or batch ref (source_ref/target_ref) — never coordinates; anchors are computed by the UI. Requires a Pro or trial workspace.
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": {
"whiteboard_id": "<whiteboard_id>",
"elements": "<elements>"
},
"name": "create_whiteboard_elements"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gap | No | Auto-arrange spacing in px (default 20) | |
| arrange | No | Layout for elements without explicit x/y (default grid) | |
| elements | Yes | Created in array order — refs only resolve backwards | |
| origin_x | No | Auto-arrange start x (default 100) | |
| origin_y | No | Auto-arrange start y (default 100) | |
| whiteboard_id | Yes | The unique identifier of the whiteboard |