Flow

List flows

GET
/flows

Returns a paginated list of flows ordered by creation time. Without authentication, only public flows are returned.

BearerAuth
headerAuthorizationBearer <JWT>

Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.

pageSize?integer

The number of results per page. Defaults to 20, maximum 100.

pageToken?string

Cursor for pagination. Pass the nextPageToken from a previous response to retrieve the next page.

displayName?string

Case-insensitive substring filter applied to displayName. Empty values are ignored.

A paginated list of flows.

application/json
  1. response
flows*array<>
nextPageToken?string

Cursor for the next page. Empty when no more results exist.

totalSize*integer

Total number of flows matching the query.

Example Request
curl -X GET 'https://example.com/api/hub/flows'
Example Response
{  "flows": [    {      "name": "flows/550e8400-e29b-41d4-a716-446655440000",      "displayName": "Data Ingestion Pipeline",      "description": "Pulls CSV files from S3, transforms them, and loads into Postgres.",      "path": "flows/550e8400-e29b-41d4-a716-446655440000/bundle-1760000000000000000.tar.gz",      "createTime": "2026-03-20T14:30:00Z",      "public": false,      "actions": [        {          "name": "string",          "integration": "string",          "scopes": [            "string"          ]        }      ],      "latestDeploy": {        "name": "deploys/0190f5a2-7c3e-7b1a-9d4e-2f6a8b0c1d3e",        "flow": "flows/550e8400-e29b-41d4-a716-446655440000",        "state": "PENDING",        "error": {          "reason": "INVALID_BUNDLE",          "message": "Syntax error in src/index.ts: Variable declaration expected.",          "fluxCode": "parse",          "file": "src/index.ts",          "range": {}        },        "createTime": "2019-08-24T14:15:22Z",        "updateTime": "2019-08-24T14:15:22Z"      }    }  ],  "nextPageToken": "string",  "totalSize": 42}