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

# Update Flow Run

`PATCH /api/flow_runs/{id}`

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.
    - `retry_type` 'in_process' | 'reschedule' — The type of retry this run is undergoing.
  - `tags` string[]
  - `infrastructure_pid` string
  - `job_variables` object

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prefecthq/apis/untitled-api-2.md) · [All operations](https://skmtc.net/prefecthq/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prefecthq/untitled-api-2/versions/29ba6c4f8837/schema)