List flows
GET
Returns a paginated list of flows ordered by creation time. Without authentication, only public flows are returned.
BearerAuthheader
AuthorizationBearer <JWT>Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.
pageSize?integerThe number of results per page. Defaults to 20, maximum 100.
pageToken?stringCursor for pagination. Pass the nextPageToken from a previous response to retrieve the next page.
displayName?stringCase-insensitive substring filter applied to displayName. Empty values are ignored.
A paginated list of flows.
application/json- response
flows*array<>nextPageToken?stringCursor for the next page. Empty when no more results exist.
totalSize*integerTotal number of flows matching the query.
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}