--- title: Versions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workflows](https://developers.cloudflare.com/api/resources/workflows) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Versions ##### [List deployed Workflow versions](https://developers.cloudflare.com/api/resources/workflows/subresources/versions/methods/list) GET/accounts/{account\_id}/workflows/{workflow\_name}/versions ##### [Get Workflow version details](https://developers.cloudflare.com/api/resources/workflows/subresources/versions/methods/get) GET/accounts/{account\_id}/workflows/{workflow\_name}/versions/{version\_id} ##### [Get Workflow version graph](https://developers.cloudflare.com/api/resources/workflows/subresources/versions/methods/graph) GET/accounts/{account\_id}/workflows/{workflow\_name}/versions/{version\_id}/graph ##### ModelsExpand Collapse
VersionListResponse object {id, class\_name, created\_on, 7 more } id: string formatuuid Link to this property class\_name: string Link to this property created\_on: string formatdate-time Link to this property has\_dag: boolean Link to this property
language: "javascript"or "python" The programming language of the workflow implementation. One of the following: "javascript" Link to this property "python" Link to this property
Link to this property modified\_on: string formatdate-time Link to this property workflow\_id: string formatuuid Link to this property
concurrency: optional object {limit } limit: optional number Maximum number of instances of this workflow that can run concurrently. Additional instances are queued and started as running instances complete. Must not exceed the account concurrency limit. maximum9007199254740991 minimum1 Link to this property
Link to this property
default\_retention: optional object {error\_retention, success\_retention } error\_retention: optional number Default error retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property success\_retention: optional number Default success retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property
Link to this property
limits: optional object {steps } steps: optional number maximum9007199254740991 minimum1 Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(model)%20version_list_response%20%3E%20(schema)>)
VersionGetResponse object {id, class\_name, created\_on, 7 more } id: string formatuuid Link to this property class\_name: string Link to this property created\_on: string formatdate-time Link to this property has\_dag: boolean Link to this property
language: "javascript"or "python" The programming language of the workflow implementation. One of the following: "javascript" Link to this property "python" Link to this property
Link to this property modified\_on: string formatdate-time Link to this property workflow\_id: string formatuuid Link to this property
concurrency: optional object {limit } limit: optional number Maximum number of instances of this workflow that can run concurrently. Additional instances are queued and started as running instances complete. Must not exceed the account concurrency limit. maximum9007199254740991 minimum1 Link to this property
Link to this property
default\_retention: optional object {error\_retention, success\_retention } error\_retention: optional number Default error retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property success\_retention: optional number Default success retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property
Link to this property
limits: optional object {steps } steps: optional number maximum9007199254740991 minimum1 Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(model)%20version_get_response%20%3E%20(schema)>)
VersionGraphResponse object {id, class\_name, created\_on, 3 more } id: string formatuuid Link to this property class\_name: string Link to this property created\_on: string formatdate-time Link to this property
graph: object {version, workflow } Versioned workflow graph payload. version: number Link to this property
workflow: object {class\_name, functions, nodes, payload } A parsed workflow entrypoint with its step graph. class\_name: string Link to this property
functions: map\[object {name, nodes, type } ] name: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property
nodes: array of object {duration, name, type, 2 more } or object {config, name, nodes, 3 more } or object {name, options, type, 3 more } or 11 more One of the following:
object {duration, name, type, 2 more }
duration: numberor string Duration as milliseconds (number) or human-readable string. One of the following: number Link to this property string Link to this property
Link to this property name: string Link to this property type: "step\_sleep" Link to this property resolves: optional number Link to this property starts: optional number Link to this property
Link to this property
object {config, name, nodes, 3 more }
config: object {retries, timeout } Configuration for a step (retries and timeout).
retries: object {backoff, delay, limit } Retry policy for a step.
backoff: "constant"or "linear"or "exponential" Backoff strategy for step retries. One of the following: "constant" Link to this property "linear" Link to this property "exponential" Link to this property
Link to this property
delay: numberor string Duration as milliseconds (number) or human-readable string. One of the following: number Link to this property string Link to this property
Link to this property limit: number Link to this property
Link to this property
timeout: numberor string Duration as milliseconds (number) or human-readable string. One of the following: number Link to this property string Link to this property
Link to this property
Link to this property name: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "step\_do" Link to this property resolves: optional number Link to this property starts: optional number Link to this property
Link to this property
object {name, options, type, 3 more } name: string Link to this property
options: object {event\_type, timeout } Options for a waitForEvent step. event\_type: string Link to this property
timeout: numberor string Duration as milliseconds (number) or human-readable string. One of the following: number Link to this property string Link to this property
Link to this property
Link to this property type: "step\_wait\_for\_event" Link to this property
payload: optional object {type } or object {fields, type } Shape descriptor for JSON payloads. One of the following:
Type object {type } type: "unknown" Link to this property
Link to this property
object {fields, type } fields: map\[unknown] Nested JsonShape fields (recursive structure). Link to this property type: "object" Link to this property
Link to this property
Link to this property resolves: optional number Link to this property starts: optional number Link to this property
Link to this property
object {name, timestamp, type, 2 more } name: string Link to this property timestamp: string Link to this property type: "step\_sleep\_until" Link to this property resolves: optional number Link to this property starts: optional number Link to this property
Link to this property
object {nodes, type } nodes: array of unknown Child nodes (recursive). Link to this property type: "loop" Link to this property
Link to this property
object {kind, nodes, type }
kind: "all"or "any"or "all\_settled"or "race" Parallel execution strategy. One of the following: "all" Link to this property "any" Link to this property "all\_settled" Link to this property "race" Link to this property
Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "parallel" Link to this property
Link to this property
object {catch\_block, finally\_block, try\_block, type }
catch\_block: object {nodes, type } nodes: array of unknown Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
finally\_block: object {nodes, type } nodes: array of unknown Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
try\_block: object {nodes, type } nodes: array of unknown Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property type: "try" Link to this property
Link to this property
object {nodes, type } nodes: array of unknown Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
object {branches, type }
branches: array of object {condition, nodes } condition: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property
Link to this property type: "if" Link to this property
Link to this property
object {branches, discriminant, type }
branches: array of object {condition, nodes } condition: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property
Link to this property discriminant: string Link to this property type: "switch" Link to this property
Link to this property
object {class\_name, functions, nodes, 2 more } class\_name: string Link to this property
functions: map\[object {name, nodes, type } ] name: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "start" Link to this property
payload: optional object {type } or object {fields, type } Shape descriptor for JSON payloads. One of the following:
Type object {type } type: "unknown" Link to this property
Link to this property
object {fields, type } fields: map\[unknown] Nested JsonShape fields (recursive structure). Link to this property type: "object" Link to this property
Link to this property
Link to this property
Link to this property
object {name, type, resolves, starts } name: string Link to this property type: "function\_call" Link to this property resolves: optional number Link to this property starts: optional number Link to this property
Link to this property
object {name, nodes, type } name: string Link to this property nodes: array of unknown Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property
object {kind, type }
kind: "break"or "return" Break or return from a loop. One of the following: "break" Link to this property "return" Link to this property
Link to this property type: "break" Link to this property
Link to this property
Link to this property
payload: optional object {type } or object {fields, type } Shape descriptor for JSON payloads. One of the following:
Type object {type } type: "unknown" Link to this property
Link to this property
object {fields, type } fields: map\[unknown] Nested JsonShape fields (recursive structure). Link to this property type: "object" Link to this property
Link to this property
Link to this property
Link to this property
Link to this property modified\_on: string formatdate-time Link to this property workflow\_id: string formatuuid Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(model)%20version_graph_response%20%3E%20(schema)>)