Workflows
Fetch published workflow versions and their definitions.
Get a published workflow
GET /v1/workflows/:idFetches the canonical definition of a published version. :id is either the
workflow's published <org-slug>/<workflow-slug> address (preferred, e.g.
acme/sprite-pack) or its internal UUID. When using the address in a URL
path, encode the / as %2F.
The version can be given inline in the path segment using the same
<id>@<version> notation the SDK and MCP clients use — e.g.
/v1/workflows/acme%2Fsprite-pack@2.1.0 — or as the version query
parameter. Giving it both inline and as ?version= is a 400.
Query parameters
| Parameter | Type | Description |
|---|---|---|
version | string | latest (default — follows the current pointer, including rollbacks), a full semver like 2.1.0, or a bare major like 2 (its highest version) |
This is the query-string form of the <id>@<version> notation — see
Versioning.
Example
# by published address (the "/" is URL-encoded)
curl "https://studio.blitflow.com/api/v1/workflows/acme%2Fsprite-pack?version=2.1.0" \
-H "Authorization: Bearer $BLITFLOW_TOKEN"
# same thing with the version inline in the path
curl "https://studio.blitflow.com/api/v1/workflows/acme%2Fsprite-pack@2.1.0" \
-H "Authorization: Bearer $BLITFLOW_TOKEN"
# or by internal UUID
curl "https://studio.blitflow.com/api/v1/workflows/8f61e451-40a7-4f65-8fa9-69704576b6d4?version=2.1.0" \
-H "Authorization: Bearer $BLITFLOW_TOKEN"{
"id": "8f61e451-40a7-4f65-8fa9-69704576b6d4",
"address": "acme/sprite-pack",
"version": "2.1.0",
"sequence": 7,
"workflow": {
"version": 2,
"nodes": [
{ "id": "prompt", "uses": "input", "outputType": "TEXT" },
{
"id": "gen",
"uses": "rd-fast",
"inputs": { "prompt": "${prompt.value}" }
},
{ "id": "image", "uses": "output", "inputs": { "value": "${gen.image}" } }
]
}
}| Field | Description |
|---|---|
id | Workflow id (UUID) |
address | Published <org-slug>/<workflow-slug> address; null if no slug is claimed |
version | The resolved full semver |
sequence | Monotonic publish counter — increases with every publish, independent of semver |
workflow | The immutable workflow definition |
Errors
| Status | Cause |
|---|---|
400 | Invalid selector (e.g. version=1.2 — partial versions are rejected) |
400 | Version given twice — inline in the path (@2.1.0) and as ?version= |
404 | Unknown workflow id/address, or no published version matches the selector |
Publishing, rollback, and version history are Studio actions — design and publish in the editor, then consume the published versions from code.