---
title: "Read Flow Run Graph V1"
method: GET
path: "/api/flow_runs/{id}/graph"
tags: ["Flow Runs"]
---

# Read Flow Run Graph V1

`GET /api/flow_runs/{id}/graph`

Get a task run dependency map for a given flow run.

## Path parameters

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

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- DependencyResult[]
  - `id` string, uuid, required
  - `name` string, required
  - `upstream_dependencies` TaskRunResult[], required
    - `input_type` 'task_run'
    - `id` string, uuid, required
  - `state` State, required — Represents the state of a run.
    - `id` string, uuid
    - `type` 'SCHEDULED' | 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'CRASHED' | 'PAUSED' | 'CANCELLING', required — Enumeration of state types.
    - `name` string
    - `timestamp` string, date-time
    - `message` string
    - `data` unknown
    - `state_details` StateDetails — A base pydantic.BaseModel for all Prefect schemas and pydantic models. As the basis for most Prefect schemas, this base model usually ignores extra fields that are passed to it at instantiation. Because adding new fields to API payloads is not considered a breaking change, this ensures that any Prefect client loading data from a server running a possibly-newer version of Prefect will be able to process those new fields gracefully. However, when PREFECT_TEST_MODE is on, extra fields are forbidden in order to catch subtle unintentional testing errors.
      - `flow_run_id` string, uuid
      - `task_run_id` string, uuid
      - `child_flow_run_id` string, uuid
      - `scheduled_time` string, date-time
      - `cache_key` string
      - `cache_expiration` string, date-time
      - `untrackable_result` boolean
      - `pause_timeout` string, date-time
      - `pause_reschedule` boolean
      - `pause_key` string
      - `run_input_keyset` object
      - `refresh_cache` boolean
      - `retriable` boolean
      - `transition_id` string, uuid
      - `task_parameters_id` string, uuid
  - `expected_start_time` string, date-time
  - `start_time` string, date-time
  - `end_time` string, date-time
  - `total_run_time` number
  - `estimated_run_time` number
  - `untrackable_result` boolean, required

## 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)