--- title: Get full step output from instance --- [Skip to content](#_top) [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](), 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. **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 [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)>) instanceID 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)>)
params InstanceStepParams AccountID param.Field\[string] Path param Link to this property Name param.Field\[string] Query param: Exact step name from the instance logs response, including the generated counter suffix. minLength1 Link to this property
Type param.Field\[InstanceStepParamsType] Query param: Step type to disambiguate step.do and waitForEvent entries that share the same name. const InstanceStepParamsTypeStep InstanceStepParamsType = "step" Link to this property const InstanceStepParamsTypeWaitForEvent InstanceStepParamsType = "waitForEvent" Link to this property
Link to this property Attempt param.Field\[int64]Optional Query param: Specific attempt number to retrieve output or error for. exclusiveMinimum maximum9007199254740991 minimum0 Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20step%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type InstanceStepResponse struct{…}
Error InstanceStepResponseError Error details when status=‘errored’; null otherwise. Message string Link to this property Name string Link to this property
Link to this property
Status InstanceStepResponseStatus One of the following: const InstanceStepResponseStatusQueued InstanceStepResponseStatus = "queued" Link to this property const InstanceStepResponseStatusRunning InstanceStepResponseStatus = "running" Link to this property const InstanceStepResponseStatusPaused InstanceStepResponseStatus = "paused" Link to this property const InstanceStepResponseStatusErrored InstanceStepResponseStatus = "errored" Link to this property const InstanceStepResponseStatusTerminated InstanceStepResponseStatus = "terminated" Link to this property const InstanceStepResponseStatusComplete InstanceStepResponseStatus = "complete" Link to this property const InstanceStepResponseStatusWaitingForPause InstanceStepResponseStatus = "waitingForPause" Link to this property const InstanceStepResponseStatusWaiting InstanceStepResponseStatus = "waiting" Link to this property const InstanceStepResponseStatusRollingBack InstanceStepResponseStatus = "rollingBack" Link to this property
Link to this property EventType stringOptional The event type the step is waiting on, as supplied to step.waitForEvent. Only present when type=‘waitForEvent’. Link to this property 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. Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(model)%20InstanceStepResponse%20%3E%20(schema)>) ### Get full step output from instance Go HTTPTypeScriptPythonGoTerraform ``` 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 } } ```