--- title: Get full step output from instance --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workflows](https://developers.cloudflare.com/api/resources/workflows) [Instances](https://developers.cloudflare.com/api/resources/workflows/subresources/instances) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get full step output from instance GET/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id}/step Retrieves the full, untruncated output for a specific step on a workflow instance. Returns a flat status-shaped JSON body with step `status` (‘running’ | ‘waiting’ | ‘complete’ | ‘errored’), `error` (nullable), and `output` (the step value, or null while running/waiting/errored). When the step returned a ReadableStream from step.do, the response is served as ‘application/octet-stream’ with the raw bytes as the body instead of JSON. A `status='running'` response with non-null `error` indicates the step is currently retrying after a prior attempt failed. ##### 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.instances%20%3E%20(method)%20step%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.instances%20%3E%20(method)%20step%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>) instance\_id: string maxLength271 minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(params)%20default%20%3E%20(param)%20instance_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse name: string Exact step name from the instance logs response, including the generated counter suffix. minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
type: "step"or "waitForEvent" Step type to disambiguate step.do and waitForEvent entries that share the same name. One of the following: "step" Link to this property "waitForEvent" Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>) attempt: optional number Specific attempt number to retrieve output or error for. exclusiveMinimum maximum9007199254740991 minimum0 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(params)%20default%20%3E%20(param)%20attempt%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.instances%20%3E%20(method)%20step%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.instances%20%3E%20(method)%20step%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {error, status, event\_type, output }
error: object {message, name } Error details when status=‘errored’; null otherwise. message: string Link to this property name: string Link to this property
Link to this property
status: "queued"or "running"or "paused"or 6 more One of the following: "queued" Link to this property "running" Link to this property "paused" Link to this property "errored" Link to this property "terminated" Link to this property "complete" Link to this property "waitingForPause" Link to this property "waiting" Link to this property "rollingBack" Link to this property
Link to this property event\_type: optional string The event type the step is waiting on, as supplied to step.waitForEvent. Only present when type=‘waitForEvent’. Link to this property output: optional unknown Contains the full step output or waitForEvent payload without truncation. Uses ‘\[REDACTED]’ for sensitive outputs. Contains a value when status=‘complete’. May contain a ReadableStream when step.do returns one; the response serves stream outputs as application/octet-stream rather than JSON. Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%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.instances%20%3E%20(method)%20step%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### Get full step output from instance HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workflows/$WORKFLOW_NAME/instances/$INSTANCE_ID/step \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": { "error": { "message": "message", "name": "name" }, "status": "queued", "event_type": "event_type", "output": {} }, "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": { "error": { "message": "message", "name": "name" }, "status": "queued", "event_type": "event_type", "output": {} }, "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ```