Read one published version, including its full snapshot
Requires scope
workflow:readReturns the version row WITH definition — the exact bytes production executed while this version was live. This is the read that pairs with POST /api/workflows/{id}/run?versionId=… (replay a run as it ran) and with restore.
onCanvas is NOT computed on this single read; it appears only in the list.
Authorization
bearerAuth AuthorizationBearer <token>
An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
id*string
Workflow id (UUID).
Format
uuidversionId*string
Version id (UUID). It must belong to this workflow — a real version of a DIFFERENT workflow is a 404, not another tenant's data.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "workflowId": "43c4fa9b-0cbc-4b57-a121-9d7d46a3eaa4", "versionNumber": 0, "definition": { "schemaVersion": 2, "trigger": { "name": "string", "displayName": "string", "type": "manual", "pieceId": "string", "pieceVersion": "string", "actionId": "string", "config": {}, "connectionId": "string", "valid": true, "nextAction": { "name": "string", "displayName": "string", "type": "PIECE", "pieceId": "string", "pieceVersion": "string", "actionId": "string", "config": {}, "connectionId": "string", "valid": true, "skip": true, "nextAction": {}, "branches": [ { "name": "string", "conditions": [ [ { "field": "string", "operator": "string", "value": null } ] ], "firstAction": {} } ], "firstLoopAction": {}, "onErrorAction": {} } }, "settings": { "timeoutSeconds": 0, "errorWorkflowId": "string", "concurrencyLimit": 0, "maintenanceMode": true, "autoPublishFixes": true }, "variables": {}, "annotations": null, "pinnedData": {} }, "publishedBy": "cbfccdb4-87bb-4311-ae53-25484c11300e", "changeMessage": "string", "createdAt": "2019-08-24T14:15:22Z", "onCanvas": true }}