---
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/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-execution-rerun'
---
<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>