Batch upsert nodes

Create or update up to 100 nodes in a single request.

POST /v1/projects/{projectId}/nodes

Batch upsert nodes

cURL

curl --request POST \
  --url https://api.example.com/v1/projects/{projectId}/nodes \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodes": [
    {
      "id": "<string>",
      "nodeType": "<string>",
      "title": "<string>",
      "structuredData": {},
      "positionX": 123,
      "positionY": 123,
      "width": 123,
      "height": 123,
      "collapsed": true
    }
  ]
}
'

projectId · string · required

Project UUID.

nodes · array · required

Array of 1-100 node objects.

Show Node input

id · string

UUID. If provided and the node exists, it’s updated. If omitted, a new node is created.

nodeType · string · required

Node type (e.g., feature, data-model, user-flow).

title · string · required

Node title (min 1 character).

structuredData · object · required

Flexible JSON object for the node’s content.

positionX · number · required

X position on the canvas.

positionY · number · required

Y position on the canvas.

width · number · required

Node width (must be positive).

height · number · required

Node height (must be positive).

collapsed · boolean · default: "false"

Whether the node is collapsed on the canvas.

Request

curl -X POST https://api.getkommit.ai/v1/projects/a1b2c3d4-e5f6-7890-abcd-ef1234567890/nodes \
  -H "Authorization: Bearer km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": [
      {
        "nodeType": "feature",
        "title": "Billing dashboard",
        "structuredData": {
          "description": "Show subscription status and invoices",
          "priority": "medium"
        },
        "positionX": 400,
        "positionY": 100,
        "width": 280,
        "height": 180
      }
    ]
  }'