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.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
instance_id |
String | Yes | |
account_id |
String | Yes | |
workflow_name |
String | Yes |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
attempt |
Integer | No |
Specific attempt number to retrieve output or error for. |
name |
String | Yes |
Exact step name from the instance logs response, including the generated counter suffix. |
type |
String | Yes |
Step type to disambiguate step.do and waitForEvent entries that share the same name. Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.