Retrieve a flow
GET
Returns the full flow resource for the given identifier. Without authentication, only public flows are accessible.
BearerAuthheader
AuthorizationBearer <JWT>Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.
flow*stringFormat
uuidThe requested flow.
application/json- response
name*stringUnique resource name.
displayName*stringHuman-readable name.
description*stringFree-text description of what the flow does.
path?stringObject-store key for the flow tarball. Absent while the flow has no bundle.
createTime*stringTime at which the flow was created.
Format
date-timepublic*booleanWhether the flow is publicly visible.
actions?array<>Actions used by the flow.
latestDeploy?A deploy of a flow: of a bundle, which is indexed before it goes live, or of a new flow without one.
curl -X GET 'https://example.com/api/hub/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "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" }}