List workflows

GET/v1/workflows

Secret key — sk_… or sk_test_… · Base URL https://api.volanea.com

Every workflow in the project — draft, active, and paused — with its trigger and its full node graph.

Unpaginated. Only active workflows enrol anyone: a draft or paused workflow whose trigger matches is reported in the skipped array of POST /v1/events rather than running.

Response

All workflows.

dataobject[]required
- workflowIdstringrequired
- projectIdstring
- namestringrequired
- statusenumrequired
  draftactivepaused
- triggerstringrequired
  `event:<name>`, `contact.created`, `segment:enter:<ref>`, or `segment:exit:<ref>`.
- graphobject | null
- reentryenumrequired
  neverafter_exitalways
- enteredinteger
- completedinteger
- activeinteger
- createdAtdate-timerequired

Errors

Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.

401Missing or invalid API key.

Request

curl https://api.volanea.com/v1/workflows \
  -H "Authorization: Bearer sk_..."

Response

200 · application/json

{
  "success": true,
  "data": {
    "data": [
      {
        "workflowId": "wf_7d31",
        "projectId": "<projectId>",
        "name": "Welcome",
        "status": "draft",
        "trigger": "<trigger>",
        "graph": {
          "nodes": null,
          "edges": null
        },
        "reentry": "never",
        "entered": 1,
        "completed": 1,
        "active": 1,
        "createdAt": "2026-01-01T09:00:00.000Z"
      }
    ]
  }
}

92 endpoints · OpenAPI document