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

# Read Flow Run Graph V2

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

Get a graph of the tasks and subflow runs for the given flow run

## Path parameters

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

## Query parameters

- `since` string, date-time — Only include runs that start or end after this time.

## Headers

- `x-prefect-api-version` string

## Response `200`

Successful Response

- Graph — 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.
  - `start_time` string, date-time, required
  - `end_time` string, date-time
  - `root_node_ids` string[], required
  - `nodes` array[], required
    - unknown[]
      - unknown
  - `artifacts` GraphArtifact[], required
    - `id` string, uuid, required
    - `created` string, date-time, required
    - `key` string
    - `type` string, required
    - `is_latest` boolean, required
  - `states` GraphState[], required
    - `id` string, uuid, required
    - `timestamp` string, date-time, required
    - `type` 'SCHEDULED' | 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'CRASHED' | 'PAUSED' | 'CANCELLING', required — Enumeration of state types.
    - `name` string, 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)