GET /v1/workflows/{id}/versions/{versionNumber}
/v1/workflows/{id}/versions/{versionNumber}
Path Parameters
id
string
required
path
versionNumber
integer
required
path
Responses
application/jsoncode
integer
data
object
aiDescription
string
aiName
string
conversationId
string
cooldownMs
integer
createdAt
string
createdBy
string
definition
object
blockExpansions
object
inputSchema
object[]
description
string
key
string
required
boolean
type
string
nodes
object
REQUIRED
sensitivePropKeys
string[]
triggerNodeIds
string[]
TriggerNodeIDs lists the node IDs that are trigger (root) nodes. Every workflow declares this — single-trigger workflows ship ["root"] (the legacy node id), multi-trigger workflows list every trigger node id. Treating single-trigger as a forest-of-1 removes the two-path branching throughout the BE + FE; older rows without the field are backfilled by migration 000282 and the field-missing path stays as a read-side safety net (see FindTriggerNodeIDs) but is no longer exercised by saves.
"root" is also a runtime alias for "the trigger that fired this run" — {{root.X}} variable references resolve to the firing trigger regardless of which trigger fired. Don't repurpose the literal "root" as a trigger id on a multi-trigger workflow.
variableDefs
object[]
default
unknown
description
string
lifetime
string
persist resetname
string
type
string
number text boolean list objectdescManuallySet
boolean
description
string
fundAutoSwapConfig
object
enabled
boolean
maxSwapAmountUsd
number
mode
string
sources
object[]
chainId
integer
id
string
priority
integer
slippageBps
integer
tokenAddress
string
tokenDecimals
integer
walletId
string
hasDraft
boolean
hasLiveVersion
boolean
id
string
lastTriggeredAt
string
liveVersionPaused
boolean
maxRuns
integer
name
string
nameManuallySet
boolean
organizationId
string
ownerUserId
string
pausedReason
string
cu_exhausted disabled_action consecutive_failures max_runs_exhausted invalid_chat member_removedpublicRunCooldownSeconds
integer
publicRunDailyLimit
integer
publicWidgetConfig
object
buttonLabel
string
description
string
enabled
boolean
maxAmount
string
minAmount
string
title
string
remainRuns
integer
sourceTemplateId
string
status
string
draft active paused archivedtriggerSecret
string
type
string
token-price-cexes evm-log cronjob schedule manual approval telegram-channel polymarket-user-bet polymarket-market-trade polymarket-new-market 48 more
polymarket-market-close slack-mentions erc20-receive erc20-send anyspend shopify-order-created shopify-order-paid shopify-inventory-level-updated ramp-new-transaction ramp-transaction-status-updated ramp-transfer-payment-updated slack-new-reaction-added slack-new-message-in-channels slack-new-channel-created slack-new-direct-message slack-new-keyword-mention slack-new-user-added slack-new-user-mention slack-new-interaction-event telegram-new-interaction-event email-new-email-received email-new-email-matching-criteria gmail-new-email-received gmail-new-email-matching-search stripe-payment-receive airwallex-event eth-receive eth-send farcaster-new-cast farcaster-new-follower farcaster-new-reaction x-new-tweet exchange-listing coinbase-payment-received coinbase-checkout-received solana-transaction hyperliquid-price-alert hyperliquid-trade hyperliquid-user-fill hyperliquid-liquidation hyperliquid-position-change hyperliquid-transfer unusual-whales-options-flow-alerts unusual-whales-market-news kalshi-market-trade kalshi-new-market kalshi-market-close situation-fireduiMetadata
object
comments
object[]
createdAt
string
createdBy
object
clientId
string
name
string
id
string
nodeId
string
position
object
x
number
y
number
replies
object[]
createdAt
string
createdBy
object
id
string
text
string
updatedAt
string
resolved
boolean
text
string
updatedAt
string
nodePositions
object
stickyNotes
object[]
color
string
createdAt
string
createdBy
object
clientId
string
name
string
id
string
position
object
x
number
y
number
size
object
height
number
width
number
text
string
updatedAt
string
zIndex
integer
updatedAt
string
updatedBy
string
variableDefs
object[]
default
unknown
description
string
lifetime
string
persist resetname
string
type
string
number text boolean list objectversion
integer
versionCreatedBy
string
visibility
string
private org public_view public_executex402Config
object
chainId
integer
discoverable
boolean
discoveryInput
object
example
unknown
schema
object
discoveryMetadata
object
category
string
description
string
documentation
string
logo
string
name
string
provider
string
tags
string[]
discoveryOutput
object
example
unknown
schema
object
price
string
recipient
string
token
string
message
string
requestId
string
curl -X GET 'https://api.example.com/v1/workflows/string/versions/0' \ -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://api.example.com/v1/workflows/string/versions/0', { method: 'GET', headers: { "Authorization": "Bearer YOUR_API_TOKEN" }});const data = await response.json();console.log(data);
import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://api.example.com/v1/workflows/string/versions/0', headers=headers)print(response.json())
package mainimport ( "fmt" "io" "net/http")func main() { req, _ := http.NewRequest("GET", "https://api.example.com/v1/workflows/string/versions/0", nil) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() result, _ := io.ReadAll(resp.Body) fmt.Println(string(result))}
{ "code": 200, "data": { "aiDescription": "<string>", "aiName": "<string>", "conversationId": "<string>", "cooldownMs": 123, "createdAt": "<string>", "createdBy": "<string>", "definition": { "blockExpansions": "<object>", "inputSchema": [ { "description": "<string>", "key": "<string>", "required": true, "type": "<string>" } ], "nodes": "<object>", "sensitivePropKeys": [ "<string>" ], "triggerNodeIds": [ "<string>" ], "variableDefs": [ { "default": "<unknown>", "description": "<string>", "lifetime": "persist", "name": "<string>", "type": "number" } ] }, "descManuallySet": true, "description": "<string>", "fundAutoSwapConfig": { "enabled": true, "maxSwapAmountUsd": 123, "mode": "<string>", "sources": [ { "chainId": 123, "id": "<string>", "priority": 123, "slippageBps": 123, "tokenAddress": "<string>", "tokenDecimals": 123, "walletId": "<string>" } ] }, "hasDraft": true, "hasLiveVersion": true, "id": "<string>", "lastTriggeredAt": "<string>", "liveVersionPaused": true, "maxRuns": 123, "name": "<string>", "nameManuallySet": true, "organizationId": "<string>", "ownerUserId": "<string>", "pausedReason": "cu_exhausted", "publicRunCooldownSeconds": 123, "publicRunDailyLimit": 123, "publicWidgetConfig": { "buttonLabel": "<string>", "description": "<string>", "enabled": true, "maxAmount": "<string>", "minAmount": "<string>", "title": "<string>" }, "remainRuns": 123, "sourceTemplateId": "<string>", "status": "draft", "triggerSecret": "<string>", "type": "token-price-cexes", "uiMetadata": { "comments": [ { "createdAt": "<string>", "createdBy": { "clientId": {}, "name": {} }, "id": "<string>", "nodeId": "<string>", "position": { "x": {}, "y": {} }, "replies": [ {} ], "resolved": true, "text": "<string>", "updatedAt": "<string>" } ], "nodePositions": "<object>", "stickyNotes": [ { "color": "<string>", "createdAt": "<string>", "createdBy": { "clientId": {}, "name": {} }, "id": "<string>", "position": { "x": {}, "y": {} }, "size": { "height": {}, "width": {} }, "text": "<string>", "updatedAt": "<string>", "zIndex": 123 } ] }, "updatedAt": "<string>", "updatedBy": "<string>", "variableDefs": [ { "default": "<unknown>", "description": "<string>", "lifetime": "persist", "name": "<string>", "type": "number" } ], "version": 123, "versionCreatedBy": "<string>", "visibility": "private", "x402Config": { "chainId": 123, "discoverable": true, "discoveryInput": { "example": "<unknown>", "schema": "<object>" }, "discoveryMetadata": { "category": "<string>", "description": "<string>", "documentation": "<string>", "logo": "<string>", "name": "<string>", "provider": "<string>", "tags": [ "<string>" ] }, "discoveryOutput": { "example": "<unknown>", "schema": "<object>" }, "price": "<string>", "recipient": "<string>", "token": "<string>" } }, "message": "success", "requestId": "abc-123"}
Try this endpoint
/v1/workflows/{id}/versions/{versionNumber}
