Skip to main content
GET
/
api
/
workflows
List workflows
curl --request GET \
  --url https://app.puffle.ai/api/workflows \
  --header 'Authorization: Bearer <token>'
{
  "workflows": [
    {
      "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",
      "workflow_nodes": [
        {
          "count": 0
        }
      ],
      "workflow_runs": [
        {
          "count": 0
        }
      ]
    }
  ]
}

​
Overview

Return every workflow the caller has created, sorted by updated_at descending. Each item includes nested count aggregates for workflow_nodes and workflow_runs so a list view can render badges without a second request.

​
AI agent notes

No pagination. Returns all workflows in a single response. Fine at current scale; if you have hundreds of workflows this endpoint will eventually get a limit/cursor pair.Related: Create a workflow to add a new one; Get a workflow for full detail including nodes + edges.

Authorizations

​
Authorization
string
header
required

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

Response

Array of workflows (may be empty).

​
workflows
object[]
required