---
title: "Help Agent Trace Queries"
method: GET
path: "/v1/traces/query/help"
tags: ["agent tracing"]
---

# Help Agent Trace Queries

`GET /v1/traces/query/help`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/v1/traces/query/help`
- Auth: API key in header `x-litellm-api-key`

## Response `200`

Successful Response

- TraceQueryHelp
  - `dialect` string, required
  - `access` string, required
  - `response` string, required
  - `tables` TraceQueryTable[], required
    - `name` 'otel_traces' | 'agent_traces_by_key' | 'spend_logs', required
    - `columns` TraceQueryColumn[], required
      - `name` string, required
      - `type` string, required
  - `normalized_fields` TraceQueryNormalizedField[], required
    - `table` 'otel_traces' | 'agent_traces_by_key' | 'spend_logs', required
    - `name` string, required
    - `column` string, required
    - `type` string, required
    - `meaning` string, required
  - `metadata` TraceQueryMetadata, required
    - `table` 'otel_traces' | 'agent_traces_by_key' | 'spend_logs', required
    - `column` string, required
    - `fields` TraceQueryMetadataField[], required
      - `path` union[], required
        - union
          - string
          - integer
      - `types` string[], required
      - `expression` string, required
    - `sampled_rows` integer, required
    - `invalid_json_rows` integer, required
    - `truncated` boolean, required
    - `error` string, nullable
    - `sample_sql` string, required
    - `scope` string, required
  - `attributes` TraceQueryAttributes[], required
    - `table` 'otel_traces' | 'agent_traces_by_key' | 'spend_logs', required
    - `column` string, required
    - `fields` TraceQueryAttributeField[], required
      - `key` string, required
      - `type` 'String', required
      - `expression` string, required
    - `truncated` boolean, required
    - `error` string, nullable
    - `discovery_sql` string, required
    - `scope` string, required
  - `relationships` TraceQueryRelationship[], required
    - `left` string, required
    - `right` string, required
    - `additional_predicates` string, required
    - `meaning` string, required
  - `examples` TraceQueryExample[], required
    - `name` string, required
    - `sql` string, required
  - `gotchas` string[], required
  - `guide` string, required

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/v1/traces/query/help/get.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)