---
id: workflow-execution-rerun
title: "Re-run an execution"
description: "Starts a new execution of the same workflow and revision. With `fromStep`, resumes from that step replaying the prior steps' outputs. Optional body `inputs` override the original run inputs."
sidebar_label: "Re-run an execution"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post 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={"Re-run an execution"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/workflows/executions/{id}/rerun"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Starts a new execution of the same workflow and revision. With `fromStep`, resumes from that step replaying the prior steps' outputs. Optional body `inputs` override the original run inputs.

<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":"query","name":"fromStep","schema":{"type":"string"},"description":"Step id to resume from.","example":"detect_drift"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"type":"object"}}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"202":{"description":"The re-run was started.","content":{"application/json":{"schema":{"type":"object","properties":{"execution":{"title":"Execution","type":"object","required":["id","workflowId","revision","status","inputs","startedAt","updatedAt"],"properties":{"id":{"type":"string","example":"exec_8f3a1b2c4d5e"},"workflowId":{"type":"string","example":"wf_ifWBbWfpug0n"},"revision":{"type":"integer","example":3},"aliasName":{"type":"string","example":"live"},"organizationId":{"type":"string"},"correlationKey":{"type":"string","description":"Client-chosen key used to target the execution with signals."},"idempotencyKey":{"type":"string"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled","timed_out"]},"inputs":{"type":"object","description":"Run inputs. Credential-named keys are masked on reads."},"outputs":{"type":"object"},"variables":{"type":"object"},"error":{"title":"StepError","type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"HTTP_500"},"message":{"type":"string"},"details":{"type":"object"},"retryable":{"type":"boolean"}}},"parentExecutionId":{"type":"string","description":"Present on sub-workflow executions."},"parentStepId":{"type":"string"},"metadata":{"type":"object"},"startedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}},"parentExecutionId":{"type":"string"},"resumeFromStep":{"type":"string","description":"Echoed when `fromStep` was given."}}}}}},"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>