Skip to main content
GET
/
api
/
workflows
/
{id}
Get a workflow
curl --request GET \
  --url https://app.puffle.ai/api/workflows/{id} \
  --header 'Authorization: Bearer <token>'
{
  "workflow": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "status": "draft",
    "trigger_config": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "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

Return the workflow row plus its full graph — every node and every edge. This is what the builder uses to hydrate the canvas.

AI agent notes

Cheap, safe to poll. Pure read. Use when you need the full graph; use List workflow nodes if you only need the node/edge arrays without the parent workflow row.Related: Update a workflow, Delete a workflow, Toggle workflow active/paused.

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

Workflow with nodes and edges.

workflow
object
required
nodes
object[]
required
edges
object[]
required