---
title: "restart a completed flow at a given step"
method: POST
path: "/w/{workspace}/jobs/restart/f/{id}"
tags: ["job"]
---

# restart a completed flow at a given step

`POST /w/{workspace}/jobs/restart/f/{id}`

## Path parameters

- `workspace` string, required
- `id` string, uuid, required

## Query parameters

- `scheduled_for` string, date-time
- `scheduled_in_secs` integer
- `parent_job` string, uuid
- `tag` string
- `job_id` string, uuid
- `include_header` string
- `invisible_to_owner` boolean

## Request body

- object
  - `step_id` string, required — top-level step id to restart the flow from (or the outermost container when restarting at a nested step)
  - `branch_or_iteration_n` integer — for branchall or loop at the top level, the iteration at which the flow should restart (optional)
  - `flow_version` integer — specific flow version to use for restart (optional, uses current version if not specified)
  - `nested_path` object[] — path of additional steps to descend into AFTER `step_id`. Each entry represents one level of nesting inside the spawned child of the previous level's container (BranchOne / sequential ForLoop iteration / Subflow). When non-empty, the actual restart point is the LAST entry's step_id.
    - `step_id` string, required — step id at this nesting level
    - `branch_or_iteration_n` integer — for ForLoop containers, the iteration to restart at (0-based; iterations 0..n-1 are preserved)

## Response `201`

job created

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/063a4e2b46d8/schema)