Skip to main content
GET
/
api
/
workflows
/
{id}
/
nodes
List workflow nodes + edges
curl --request GET \
  --url https://app.puffle.ai/api/workflows/{id}/nodes \
  --header 'Authorization: Bearer <token>'
{
  "nodes": [
    {
      "id": "<string>",
      "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "<string>",
      "label": "<string>",
      "config": {},
      "position_x": 123,
      "position_y": 123
    }
  ],
  "edges": [
    {
      "id": "<string>",
      "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_node_id": "<string>",
      "target_node_id": "<string>",
      "source_handle": "<string>",
      "target_handle": "<string>",
      "condition": {}
    }
  ]
}

Overview

Returns the node + edge arrays for a workflow. Same data Get a workflow returns, without the parent workflow row — use when you only need to re-hydrate the canvas.

AI agent notes

Ownership checked. The workflow must exist and be owned by the caller. Otherwise 404.Related: Bulk save workflow nodes + edges to persist changes, Get a workflow for the full view.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Workflow UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Nodes and edges.

nodes
object[]
required
edges
object[]
required