Endpoints
DEVELOPER REFERENCE

Get workflow

GET /workflows/{workflowId}

Read workflow metadata and its graph.

GET /api/v1/workflows/{workflowId}

Permission: workflows:read. Write endpoints also require a workspace role that permits changes. See authentication and errors.

Request

curl --request GET 'https://app.innflow.ai/api/v1/workflows/workflow_id' \
  --header "Authorization: Bearer $INNFLOW_API_KEY"

Examples use placeholder IDs. Set INNFLOW_API_KEY in your shell and replace IDs with your own before sending a request.

Parameters

NameInRequiredDetails
workflowIdpathYesResource identifier.
X-Innflow-WorkspaceheaderNoOrganization ID, or personal. Set explicitly; omission uses legacy user-owned resource scope.
viewqueryNoUse summary to omit nodes and connections.
nodeIdsqueryNoComma-separated list of at most 50 node IDs. Filters nodes only; connections remain unfiltered.

Response

HTTP 200 — Returns data with workflow metadata, graphRevision, executionVersion, canvasLayoutVersion, nodes and connections. Summary view returns nodeCount and connectionCount instead of graph arrays.

See OpenAPI download for the machine-readable request contract and errors for errors and retry behavior.

On this page