--- title: Get full step output from instance --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api/go) [Workflows](https://developers.cloudflare.com/api/go/resources/workflows) [Instances](https://developers.cloudflare.com/api/go/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 client.Workflows.Instances.Step(ctx, workflowName, instanceID, params) (\*[InstanceStepResponse](https://developers.cloudflare.com/api/go/resources/workflows#%28resource%29%20workflows.instances%20%3E%20%28model%29%20InstanceStepResponse%20%3E%20%28schema%29), error) 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](https://developers.cloudflare.com/fundamentals/api/get-started/create-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` ##### ParametersExpand Collapse workflowName string maxLength64 minLength1 instanceID string maxLength271 minLength1 params InstanceStepParams AccountID param.Field\[string\] Path param Name param.Field\[string\] Query param: Exact step name from the instance logs response, including the generated counter suffix. minLength1 Type param.Field\[[InstanceStepParamsType](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/step#%28resource%29%20workflows.instances%20%3E%20%28method%29%20step%20%3E%20%28params%29%20default%20%3E%20%28param%29%20type%20%3E%20%28schema%29)\] Query param: Step type to disambiguate step.do and waitForEvent entries that share the same name. const InstanceStepParamsTypeStep [InstanceStepParamsType](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/step#%28resource%29%20workflows.instances%20%3E%20%28method%29%20step%20%3E%20%28params%29%20default%20%3E%20%28param%29%20type%20%3E%20%28schema%29) \= "step" const InstanceStepParamsTypeWaitForEvent [InstanceStepParamsType](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/step#%28resource%29%20workflows.instances%20%3E%20%28method%29%20step%20%3E%20%28params%29%20default%20%3E%20%28param%29%20type%20%3E%20%28schema%29) \= "waitForEvent" Attempt param.Field\[int64\]Optional Query param: Specific attempt number to retrieve output or error for. exclusiveMinimum maximum9007199254740991 minimum0 ##### ReturnsExpand Collapse type InstanceStepResponse struct{…} Error InstanceStepResponseError Error details when status=‘errored’; null otherwise. Message string Name string Status InstanceStepResponseStatus One of the following: const InstanceStepResponseStatusQueued InstanceStepResponseStatus \= "queued" const InstanceStepResponseStatusRunning InstanceStepResponseStatus \= "running" const InstanceStepResponseStatusPaused InstanceStepResponseStatus \= "paused" const InstanceStepResponseStatusErrored InstanceStepResponseStatus \= "errored" const InstanceStepResponseStatusTerminated InstanceStepResponseStatus \= "terminated" const InstanceStepResponseStatusComplete InstanceStepResponseStatus \= "complete" const InstanceStepResponseStatusWaitingForPause InstanceStepResponseStatus \= "waitingForPause" const InstanceStepResponseStatusWaiting InstanceStepResponseStatus \= "waiting" const InstanceStepResponseStatusRollingBack InstanceStepResponseStatus \= "rollingBack" EventType stringOptional The event type the step is waiting on, as supplied to step.waitForEvent. Only present when type=‘waitForEvent’. Output unknownOptional 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. ### Get full step output from instance Go HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/workflows" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.Workflows.Instances.Step( context.TODO(), "x", "x", workflows.InstanceStepParams{ AccountID: cloudflare.F("account_id"), Name: cloudflare.F("x"), Type: cloudflare.F(workflows.InstanceStepParamsTypeStep), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Error) } ``` 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 } } ```