---
title: "Get Aggregated Trace View"
method: POST
path: "/projects/{project_id}/traces/aggregated"
tags: ["trace"]
---

# Get Aggregated Trace View

`POST /projects/{project_id}/traces/aggregated`

## Path parameters

- `project_id` string, uuid4, required

## Request body

- AggregatedTraceViewRequest
  - `log_stream_id` string, uuid4, required — Log stream id associated with the traces.
  - `filters` union[] — Filters to apply on the traces. Note: Only trace-level filters are supported.
    - union
      - LogRecordsIDFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
        - `type` 'id'
      - LogRecordsDateFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` string, date-time, required
        - `type` 'date'
      - LogRecordsNumberFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'between', required
        - `value` union, required
          - integer
          - number
          - integer[]
          - number[]
        - `type` 'number'
      - LogRecordsBooleanFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'ne'
        - `value` boolean, required
        - `type` 'boolean'
      - LogRecordsCollectionFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
        - `type` 'collection'
      - LogRecordsTextFilter
        - `column_id` string, required — ID of the column to filter.
        - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
        - `type` 'text'
      - LogRecordsFullyAnnotatedFilter — Queue-scoped filter for records rated across all queue templates.
        - `column_id` 'fully_annotated' — Queue-scoped filter identifier. This filter only works for annotation-queue searches that provide queue context.
        - `type` 'fully_annotated'
        - `user_ids` string[], nullable — Optional queue member IDs to require for full annotation in a queue-scoped search. If omitted, all tracked queue members visible to the requester are used.

## Response `200`

Successful Response

- AggregatedTraceViewResponse
  - `graph` AggregatedTraceViewGraph, required
    - `nodes` AggregatedTraceViewNode[], required
      - `id` string, required
      - `name` string, nullable, required
      - `type` 'llm' | 'retriever' | 'tool' | 'workflow' | 'agent' | 'control' | 'trace' | 'session', required
      - `occurrences` integer, required
      - `parent_id` string, nullable
      - `has_children` boolean, required
      - `metrics` object, required
      - `trace_count` integer, required
      - `weight` number, required
      - `insights` InsightSummary[]
        - `id` string, uuid4, required
        - `title` string, required
        - `observation` string, required
        - `details` string, required
        - `suggested_action` string, required
        - `priority` integer, required
        - `priority_category` 'error' | 'warning' | 'info', nullable
    - `edges` AggregatedTraceViewEdge[], required
      - `source` string, required
      - `target` string, required
      - `weight` number, required
      - `occurrences` integer, required
      - `trace_count` integer, required
      - `trace_ids` string[], required
    - `edge_occurrences_histogram` Histogram
      - `strategy` 'fixed' | 'trimmed' | 'quantile', required
      - `edges` number[], required — List of bin edges (monotonically increasing, length = number of buckets + 1)
      - `buckets` HistogramBucket[], required — List of histogram buckets containing the binned data
        - `lower` number, required — Lower bound of the histogram bucket (inclusive)
        - `upper` number, required — Upper bound of the histogram bucket (exclusive, but inclusive for the last bucket)
        - `count` integer, required — Number of data points that fall within this bucket
      - `total` integer, required — Total number of data points in the histogram
  - `num_traces` integer, required — Number of traces in the aggregated view
  - `num_sessions` integer, required — Number of sessions in the aggregated view
  - `start_time` string, date-time, nullable — created_at of earliest record of the aggregated view
  - `end_time` string, date-time, nullable — created_at of latest record of the aggregated view
  - `has_all_traces` boolean, required — Whether all traces were returned

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)