Skip to main content
GET
List observability runs

Authorizations

x-api-key
string
header
required

Query Parameters

from
string

Range start as an ISO instant or a relative token (e.g. 30d); defaults to 30 days ago.

to
string

Range end as an ISO instant or a relative token; defaults to now.

tags
string

Tag filter as a JSON list (["a","b"]) or a comma-separated string.

status
enum<string>

Restrict to error runs; success is unfiltered.

Available options:
error,
success
user
string

Filter to one run user (the backend's native user identity dimension).

session
string

Filter to one run session/thread (the backend's native session dimension).

version
string

Filter to one run version (the backend's native version dimension; e.g. a preset's version).

minCost
number

Inclusive lower bound on run cost.

maxCost
number

Inclusive upper bound on run cost.

minTokens
number

Inclusive lower bound on token count.

maxTokens
number

Inclusive upper bound on token count.

minLatencyMs
number

Inclusive lower bound on latency in milliseconds.

maxLatencyMs
number

Inclusive upper bound on latency in milliseconds.

sort
enum<string>

Sort key.

Available options:
createdAt,
cost,
latencyMs,
totalTokens
dir
enum<string>

Sort direction; defaults to desc.

Available options:
asc,
desc
page
integer
default:1

1-based page number.

Required range: x >= 1
pageSize
integer
default:50

Items per page; capped to 100, never refused.

Required range: x >= 1

Response

Success.

data
ObservabilityRunsPage · object
required

One page of observability runs; nextPage is null on the last page.