---
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: eJztWG2P27gR/isDfknW1drONcEdXPTDJk3aLYo02GyQA3KLmBZHEm8pUkeOvOsz/N+LIWXZXmtfkPaAfsh+WVki543PPDOctSBZBjH7Ij47f10YdwN4i3lL2tkgrjKhMOReN/xbzMQFUuttAFyiX4EkwrohkFaBJvSSV4ErwFmEQNhkIM2NXAW40VRB0RoD2jYthQxcS+mBNxtXhrHIhGs6IedKzMRNZ9Fpb9HMo1SnLFlkopFe1kjo2fy10GxfI6kSmbCyRjETWolMePyt1R6VmJFvMRMhr7CWYrYWtGp4VSCvbSk2d329rHAXC9CKDcRbWTeGd/GXrz8Vf5YvFj/kL9UrFJts0Ai29vy/NoSlgFYgAyjMjfSoQFugCkFhoa3mtYcWKiTM6avyuiCxucpEwLz1mlYxXAuUHv1ZS5WYfbnizx5D42zAwCb9MJ3yv2FDngXQdunyeFTx4HJnCS3xFtk0RqdPk18D71sfu+oWv2JOfIiez5x00trFaigkewr3vkvv5UpkQhPW6b2m6PzHhJG76g79+XcH0y2Qx/AvHQj6QICrNcE8QXaewbwD7XyHWlis+ABkaygDqZbsS9C25JPRHoL+HUHbQCjVX6CRIbC43LQK/9rIlXFShTk8dx4Y2SCB95pk1QkUzscTjonjMXc+gvAwZj1E7wncfTG9Hyppz/sI33sEXsaXD4msnWoNJ4VoTFtq+/iO3CmMqZ6USGrD4Abb1sxXDVqV3vjW2vSUO5ZFyOlWSG3iQ7jWTROfcmlzNPz2apOJ7tD3dGhLWKI/wsmL04UMqHq+s229QD+OsNzS3rlVePsEWdNOlub1cFNhSuIIQy8tOJsjNOiZUOuoAr13/i6238aXxwDfkcyXGFCRiRpDkCUymR8iJ35/8Ej+cXn54eur6ZTN2IoZ5iuS2oTjBN+wReRXcmH2dy6cMyit2GxiZnNODZHD3Ww1q1RIBlLIeXC2y57TFEyUKsQAdln7B2pILrxeEYYnQOAjei2N/h1V4gdXRAgw2RCqnm/guTlgo5N9Z/5XuraMNqzMuPKNa+1TcuR9zAmWb1wJaMlrDFHXNmsa71SboxpWVSNJJWmgSCQ28ITqjIbgWjhfS2IWk4SnpOvIOj0VPH3T9i8TL3/++bj6vTEaLUFMxzFwLVw4tYIQ+5tKEtzw5xvvbDkDadNCmLNmLhhQtbW0pwwazgaYp6RJtSRjbC2l0Sr1UExerUfukyzGaK4iKbiiSLQHhUajHii9jXcLg/WfBkpwRyMf0opHq2Sq+tIq6VXnVHT8+cW7N/DjT9MfodMFHQ1kENAvMTYr8/tsmp8clzK6p0Yc2hOpD3gNfLo4zwDH5RjmFVETZpNJ3zSGVWAGVbicRKPD7pN1dFq41qr5Ycf0TTIYbF1IH6LS946gX39U3XZZ1e94OX3ZM+tjomFrVmIvreCm+KqLz68Xn4umLacW8FYHComr+DDzR8ztHQ2TXX8ZJnfE9uVpqCc7PLUPHgPnxzDOZ4/jfNfiPdhCxub7YdeYvMMk5NJOcmcLXT5Y3g6amjYQVHKJsK2z0GlfwTMup8/2WeTVEIt8snjbYM7kG7PEd4TyPZO/Z/L3TP6/zOTUnVSOZxIlRkOjafuh3Q1NJmutNp1l63T52vAtJCZ7GlW03uxhVDZ6bFtjGiOJ25Jx7uqD+/pHTvgUk/1be+8eCxLdPCF213GRyLqHd9tW55+fL0VquAu3Tx/byU8QmWAbu4vK+MV4enT4r1ttVAZNuzA6VBn41qbLsFtED3v8BsYHt3/7ru3QjbbUFse/2F/sO9d60AplAOdLablNpUoHOPtwPuMFpzAa/W0H3dEIpMcouxenXN7WaCmM4W0cTQU+2gXmrsYAsruxoYLRyONSs4ujUQbBgXVUMTp1GmqBcYHGSeeZ0TLgVh+PcxQ0jhPcByAHErayuKW9RpgbvcT5yRjOctJLSSxXWpAshxXELjEN0DQFIK/LkmU522l826NoNOou/N2oLcY53joWq260lgji3nFakvgRc48U4uul9JpbTxZ+jdhA7lGhJS1NWhCQ2ObA0rY3hf3pEl/mXaBaxjrUzbcuusHF0VzoLnbWuwL3R88Ru8QgvKVJY6SO9BazbksrX/rpYoi80I88MzGLY8OYwPyrm59cZaJygXjnes1X+E/ebDb8+rcWPc/UrjKxjXDMcqUDPysxK6QJ+EA0nl90HHQCQ0PHQW+2FG2ZoJfStPxLZOIaV2nyyePIbzbhyePGb7CtC+iGZzAVSoU+hit9PMtzbGhv29E4kZmxp+O/v70UmZCHfHiH/6L0QZPW67Ti0l2j3Wx6C4l/s4GbzX8A7/EZcQ==
sidebar_class_name: "get api-method"
info_path: docs/api/workflows
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<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>