---
id: workflow-execution-read-step
title: Read a step's invocations
description: >-
  Returns every attempt and iteration of one step, always with full inputs,
  outputs, and logs.
sidebar_label: Read a step's invocations
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: get api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-execution-read-step'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read a step's invocations"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/workflows/executions/{id}/steps/{stepId}"}
  context={"endpoint"}
>

</MethodEndpoint>

Returns every attempt and iteration of one step, always with full inputs, outputs, and logs.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The execution id.","example":"exec_8f3a1b2c4d5e"},{"in":"path","name":"stepId","required":true,"schema":{"type":"string"},"description":"The step id as declared in the definition.","example":"detect_drift"}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The step's invocations.","content":{"application/json":{"schema":{"type":"object","properties":{"stepId":{"type":"string"},"invocations":{"type":"array","items":{"title":"Step","type":"object","description":"One step attempt. List responses omit `inputs`, `outputs`, and logs by default, advertising their size instead; pass `include=payloads` (or read a single step) for the full record.","properties":{"executionId":{"type":"string"},"stepId":{"type":"string","example":"detect_drift"},"stepName":{"type":"string"},"stepType":{"type":"string","example":"module"},"pluginType":{"type":"string","example":"code-exec"},"status":{"type":"string","enum":["pending","running","completed","failed","skipped","cancelled"]},"attempt":{"type":"integer","description":"1-based attempt number."},"iterationIndex":{"type":"integer","description":"0-based index when the step ran once per item."},"error":{"title":"StepError","type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"HTTP_500"},"message":{"type":"string"},"details":{"type":"object"},"retryable":{"type":"boolean"}}},"inputs":{"type":"object","description":"Only with `include=payloads` or on single-step reads."},"outputs":{"type":"object","description":"Only with `include=payloads` or on single-step reads."},"inputsBytes":{"type":"integer","description":"Serialized size of the omitted `inputs` (list responses)."},"outputsBytes":{"type":"integer","description":"Serialized size of the omitted `outputs` (list responses)."},"logCount":{"type":"integer","description":"Number of log entries the attempt produced (list responses)."},"metadata":{"type":"object"},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}}}}}}}},"4XX":{"description":"Client error. The body says what went wrong: an error `type`, a human-readable `detail`, and, on validation failures, one entry per offending field.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>

</StatusCodes>