API Reference

Workflows

A workflow is a saved graph of nodes you've authored in the Photopipe website. Use these endpoints to discover the workflows in a workspace before triggering runs.

GET/workflows

List workflows

Returns every workflow in the workspace, including templates and snapshots.
Request
curl "https://api.photopipe.com/workflows" \
  -H "Authorization: Bearer pp_a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"
Response 200
[
  {
    "id": 123,
    "name": "Background removal",
    "description": "Strip backgrounds from product photos.",
    "isTemplate": false,
    "isSnapshot": false,
    "category": null,
    "coverImage": null,
    "sortOrder": 0,
    "workspaceId": 42,
    "createdByUserId": 7,
    "graph": { "nodes": [ /* ... */ ], "edges": [ /* ... */ ] },
    "createdAt": "2026-04-12T08:30:11.000Z",
    "updatedAt": "2026-04-29T14:02:55.000Z"
  }
]
GET/workflows/:id

Get a workflow

Returns a single workflow with its full graph. Use this when you need to introspect node ids and types before constructing a run payload.
Path parameters
idrequired
integer
The workflow id from the list endpoint.
Request
curl "https://api.photopipe.com/workflows/123" \
  -H "Authorization: Bearer pp_a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"
Response 200
{
  "id": 123,
  "name": "Background removal",
  "description": "Strip backgrounds from product photos.",
  "isTemplate": false,
  "isSnapshot": false,
  "workspaceId": 42,
  "graph": {
    "nodes": [
      {
        "id": "imageInput-1",
        "type": "imageInput",
        "position": { "x": 0, "y": 0 },
        "data": { "label": "Source images" }
      },
      {
        "id": "removeBackground-1",
        "type": "removeBackground",
        "position": { "x": 320, "y": 0 },
        "data": {}
      },
      {
        "id": "output-1",
        "type": "output",
        "position": { "x": 640, "y": 0 },
        "data": { "label": "Cutouts" }
      }
    ],
    "edges": [
      { "id": "e1", "source": "imageInput-1", "target": "removeBackground-1" },
      { "id": "e2", "source": "removeBackground-1", "target": "output-1" }
    ]
  },
  "createdAt": "2026-04-12T08:30:11.000Z",
  "updatedAt": "2026-04-29T14:02:55.000Z"
}