---
title: "Fork Run"
method: POST
path: "/api/v1/runs/{id}/fork"
tags: ["Runs"]
---

# Fork Run

`POST /api/v1/runs/{id}/fork`

Creates a new run from a checkpoint of the source run. The source run is left untouched.

## Path parameters

- `id` string, required

## Request body

- ForkRequest — Request body for creating a new run from a source run checkpoint.
  - `target` string, nullable — Optional checkpoint target such as `@2`, `build`, or `build@1`. Defaults to the latest checkpoint.

## Response `200`

New run created

- ForkResponse — Response returned after creating a forked run.
  - `source_run_id` string, required
  - `new_run_id` string, required
  - `target` string, required

## Other responses

- `400` — Invalid fork target
- `404` — Run not found
- `409` — Source run is archived
- `501` — Operation unsupported for this run

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/versions/bee030053823/schema)