--- title: Get Workflow version graph --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workflows](https://developers.cloudflare.com/api/resources/workflows) [Versions](https://developers.cloudflare.com/api/resources/workflows/subresources/versions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Workflow version graph GET/accounts/{account\_id}/workflows/{workflow\_name}/versions/{version\_id}/graph Retrieves the graph visualization of a workflow version. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Workers Tail Read``Workers Scripts Write``Workers Scripts Read` ##### P ath ParametersExpand Collapse account\_id: string [Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) workflow\_name: string maxLength64 minLength1 [Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>) version\_id: string formatuuid [Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(params)%20default%20%3E%20(param)%20version_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
errors: array of object {code, message } code: number Link to this property message: string Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message } code: number Link to this property message: string Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: 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(method)%20graph%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true [Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result\_info: optional object {count, per\_page, total\_count, 3 more } count: number Link to this property per\_page: number Link to this property total\_count: number Link to this property cursor: optional string Link to this property page: optional number Link to this property total\_pages: optional number Link to this property
[Link to this property](<#(resource)%20workflows.versions%20%3E%20(method)%20graph%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### Get Workflow version graph HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workflows/$WORKFLOW_NAME/versions/$VERSION_ID/graph \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "class_name": "class_name", "created_on": "2019-12-27T18:11:19.117Z", "graph": { "version": 0, "workflow": { "class_name": "class_name", "functions": { "foo": { "name": "name", "nodes": [ {} ], "type": "function_def" } }, "nodes": [ { "duration": 0, "name": "name", "type": "step_sleep", "resolves": 0, "starts": 0 } ], "payload": { "type": "unknown" } } }, "modified_on": "2019-12-27T18:11:19.117Z", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" }, "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "class_name": "class_name", "created_on": "2019-12-27T18:11:19.117Z", "graph": { "version": 0, "workflow": { "class_name": "class_name", "functions": { "foo": { "name": "name", "nodes": [ {} ], "type": "function_def" } }, "nodes": [ { "duration": 0, "name": "name", "type": "step_sleep", "resolves": 0, "starts": 0 } ], "payload": { "type": "unknown" } } }, "modified_on": "2019-12-27T18:11:19.117Z", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" }, "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ```