---
title: "Update Flow Run"
method: PATCH
path: "/api/flow_runs/{id}"
tags: ["Flow Runs"]
---

# Update Flow Run

`PATCH /api/flow_runs/{id}`

## Request

- The document declares no server URL.
- Auth: none declared

Updates a flow run.

## Path parameters

- `id` string, uuid, required: The flow run id

## Headers

- `x-prefect-api-version` string

## Request body

- FlowRunUpdate: Data used by the Prefect REST API to update a flow run.
  - `name` string
  - `flow_version` string
  - `parameters` object
  - `empirical_policy` FlowRunPolicy: Defines of how a flow run should retry.
    - `max_retries` integer: The maximum number of retries. Field is not used. Please use `retries` instead.
    - `retry_delay_seconds` number: The delay between retries. Field is not used. Please use `retry_delay` instead.
    - `retries` integer: The number of retries.
    - `retry_delay` integer: The delay time between retries, in seconds.
    - `pause_keys` unknown[]: Tracks pauses this run has observed.
      - unknown
    - `resuming` boolean: Indicates if this run is resuming from a pause.
  - `tags` string[]
  - `infrastructure_pid` string
  - `job_variables` object

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/prefecthq/apis/prefect-versions-api.md) - [All operations](https://skmtc.dev/prefecthq/apis/prefect-versions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prefecthq/apis/prefect-versions-api/revisions/a7958ce57e96?raw)