Skip to main content
POST
Search Traces with Advanced Filters

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

db_id
string | null

Database ID to query traces from

Body

application/json

Request body for POST /traces/search with advanced filtering.

The filter field accepts a FilterExpr DSL dict supporting composable queries with AND/OR/NOT logic and operators like EQ, NEQ, GT, GTE, LT, LTE, IN, CONTAINS, STARTSWITH.

Example for run grouping (default): { "filter": { "op": "AND", "conditions": [ {"op": "EQ", "key": "status", "value": "OK"}, {"op": "CONTAINS", "key": "user_id", "value": "admin"} ] }, "group_by": "run", "page": 1, "limit": 20 }

Example for session grouping: { "filter": {"op": "EQ", "key": "agent_id", "value": "my-agent"}, "group_by": "session", "page": 1, "limit": 20 }

filter
Filter · object | null

FilterExpr DSL as JSON dict. Supports operators: EQ, NEQ, GT, GTE, LT, LTE, IN, CONTAINS, STARTSWITH, AND, OR, NOT.

group_by
enum<string>
default:run

Grouping mode: 'run' returns individual TraceDetail, 'session' returns aggregated TraceSessionStats.

Available options:
run,
session
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
limit
integer
default:20

Number of traces per page (max 100)

Required range: 1 <= x <= 100

Response

Successful Response

data
TraceDetail · object[]
required

List of items for the current page

meta
PaginationInfo · object
required

Pagination metadata