---
title: "Return one cached exact Agent Graph."
method: POST
path: "/tracer/trace/agent_graph/"
tags: ["tracer"]
---

# Return one cached exact Agent Graph.

`POST /tracer/trace/agent_graph/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/trace/agent_graph/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

``path_edges`` remains an empty compatibility field until telemetry
records authoritative chronological execution transitions.

## Request body

- TraceAgentGraphQuery
  - `project_id` string, uuid, required
  - `filters` string: JSON-encoded canonical filter list.
  - `refresh` boolean: Recompute and atomically replace the last exact graph snapshot.

## Response `200`

OK

- TraceAgentGraphResponse
  - `status` boolean, required
  - `result` TraceAgentGraphResult, required
    - `nodes` TraceAgentGraphNode[], required
      - `id` string, required
      - `name` string, required
      - `type` string, required
      - `span_count` integer, required
      - `avg_latency_ms` number, required
      - `total_tokens` integer, required
      - `total_cost` number, required
      - `error_count` integer, required
      - `trace_count` integer, nullable, required
      - `trace_count_exact` boolean
      - `is_aggregate` boolean
      - `member_count` integer
    - `edges` TraceAgentGraphEdge[], required
      - `source` string, required
      - `target` string, required
      - `transition_count` integer, required
      - `avg_latency_ms` number, required
      - `total_tokens` integer, required
      - `total_cost` number, required
      - `error_count` integer, required
      - `trace_count` integer, nullable, required
      - `trace_count_exact` boolean
      - `is_self_loop` boolean, required
      - `is_aggregate` boolean
    - `path_edges` TraceAgentGraphEdge[], required
      - `source` string, required
      - `target` string, required
      - `transition_count` integer, required
      - `avg_latency_ms` number, required
      - `total_tokens` integer, required
      - `total_cost` number, required
      - `error_count` integer, required
      - `trace_count` integer, nullable, required
      - `trace_count_exact` boolean
      - `is_self_loop` boolean, required
      - `is_aggregate` boolean
    - `graph_collapsed` boolean
    - `graph_node_limit` integer
    - `omitted_node_count` integer
    - `query_complete` boolean
    - `query_status` 'complete' | 'pending'
    - `query_sampled` boolean
    - `query_count` integer
    - `query_rows_returned` integer
    - `query_elapsed_ms` number
    - `query_completed_at` string, date-time
    - `query_cached` boolean
    - `query_refresh_failed` boolean
    - `query_refreshing` boolean

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)