--- title: Versions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Workflows](https://developers.cloudflare.com/api/typescript/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/typescript/resources/workflows/subresources/versions/methods/list) client.workflows.versions.list(stringworkflowName, VersionListParams {account\_id, page, per\_page } params, RequestOptionsoptions?): V4PagePaginationArray< [VersionListResponse]() {id, class\_name, created\_on, 7 more } > GET/accounts/{account\_id}/workflows/{workflow\_name}/versions ##### [Get Workflow version details](https://developers.cloudflare.com/api/typescript/resources/workflows/subresources/versions/methods/get) client.workflows.versions.get(stringversionID, VersionGetParams {account\_id, workflow\_name } params, RequestOptionsoptions?): [VersionGetResponse]() {id, class\_name, created\_on, 7 more } GET/accounts/{account\_id}/workflows/{workflow\_name}/versions/{version\_id} ##### [Get Workflow version graph](https://developers.cloudflare.com/api/typescript/resources/workflows/subresources/versions/methods/graph) client.workflows.versions.graph(stringversionID, VersionGraphParams {account\_id, workflow\_name } params, RequestOptionsoptions?): [VersionGraphResponse]() {id, class\_name, created\_on, 3 more } GET/accounts/{account\_id}/workflows/{workflow\_name}/versions/{version\_id}/graph ##### ModelsExpand Collapse
VersionListResponse {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"| "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?: Concurrency {limit } limit?: 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?: DefaultRetention {error\_retention, success\_retention } error\_retention?: number Default error retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property success\_retention?: number Default success retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property
Link to this property
limits?: Limits {steps } steps?: 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 {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"| "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?: Concurrency {limit } limit?: 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?: DefaultRetention {error\_retention, success\_retention } error\_retention?: number Default error retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property success\_retention?: number Default success retention in milliseconds. maximum9007199254740991 minimum-9007199254740991 Link to this property
Link to this property
limits?: Limits {steps } steps?: 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 {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: Graph| null Versioned workflow graph payload. version: number Link to this property
workflow: Workflow {class\_name, functions, nodes, payload } A parsed workflow entrypoint with its step graph. class\_name: string Link to this property
functions: Record<string, Functions> name: string Link to this property nodes: Array<unknown> Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property
nodes: Array<UnionMember0 {duration, name, type, 2 more } | UnionMember1 {config, name, nodes, 3 more } | UnionMember2 {name, options, type, 3 more } | 11 more> One of the following:
UnionMember0 {duration, name, type, 2 more }
duration: number| 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?: number Link to this property starts?: number Link to this property
Link to this property
UnionMember1 {config, name, nodes, 3 more }
config: Config {retries, timeout } Configuration for a step (retries and timeout).
retries: Retries {backoff, delay, limit } Retry policy for a step.
backoff: "constant"| "linear"| "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: number| 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: number| 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<unknown> Child nodes (recursive). Link to this property type: "step\_do" Link to this property resolves?: number Link to this property starts?: number Link to this property
Link to this property
UnionMember2 {name, options, type, 3 more } name: string Link to this property
options: Options| null Options for a waitForEvent step. event\_type: string Link to this property
timeout: number| 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?: Type {type } | UnionMember1 {fields, type } Shape descriptor for JSON payloads. One of the following:
Type {type } type: "unknown" Link to this property
Link to this property
UnionMember1 {fields, type } fields: Record<string, 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?: number Link to this property starts?: number Link to this property
Link to this property
UnionMember3 {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?: number Link to this property starts?: number Link to this property
Link to this property
UnionMember4 {nodes, type } nodes: Array<unknown> Child nodes (recursive). Link to this property type: "loop" Link to this property
Link to this property
UnionMember5 {kind, nodes, type }
kind: "all"| "any"| "all\_settled"| "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<unknown> Child nodes (recursive). Link to this property type: "parallel" Link to this property
Link to this property
UnionMember6 {catch\_block, finally\_block, try\_block, type }
catch\_block: CatchBlock| null nodes: Array<unknown> Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
finally\_block: FinallyBlock| null nodes: Array<unknown> Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
try\_block: TryBlock| null nodes: Array<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
UnionMember7 {nodes, type } nodes: Array<unknown> Child nodes (recursive). Link to this property type: "block" Link to this property
Link to this property
UnionMember8 {branches, type }
branches: Array<Branch> condition: string| null Link to this property nodes: Array<unknown> Child nodes (recursive). Link to this property
Link to this property type: "if" Link to this property
Link to this property
UnionMember9 {branches, discriminant, type }
branches: Array<Branch> condition: string| null Link to this property nodes: Array<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
UnionMember10 {class\_name, functions, nodes, 2 more } class\_name: string Link to this property
functions: Record<string, Functions> name: string Link to this property nodes: Array<unknown> Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property nodes: Array<unknown> Child nodes (recursive). Link to this property type: "start" Link to this property
payload?: Type {type } | UnionMember1 {fields, type } Shape descriptor for JSON payloads. One of the following:
Type {type } type: "unknown" Link to this property
Link to this property
UnionMember1 {fields, type } fields: Record<string, 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
UnionMember11 {name, type, resolves, starts } name: string Link to this property type: "function\_call" Link to this property resolves?: number Link to this property starts?: number Link to this property
Link to this property
UnionMember12 {name, nodes, type } name: string Link to this property nodes: Array<unknown> Child nodes (recursive). Link to this property type: "function\_def" Link to this property
Link to this property
UnionMember13 {kind, type }
kind: "break"| "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?: Type {type } | UnionMember1 {fields, type } Shape descriptor for JSON payloads. One of the following:
Type {type } type: "unknown" Link to this property
Link to this property
UnionMember1 {fields, type } fields: Record<string, 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)>)