Skip to main content
GET
Error

Authorizations

X-API-Key
string
header
required
X-Tenant-Id
string
header
required

Query Parameters

id
string[]

Only return projects with these IDs

name
string

Only return the project with this exact name

name_contains
string

Only return projects whose name contains this substring

reference_dataset_id
string[]

Only return experiments run against these dataset IDs

type
enum<string>[]

Only return projects of these types

Available options:
PROJECT,
AGENT,
EXPERIMENT
tag_value_id
string[]

Only return projects tagged with all of these tag value IDs

metadata
string

JSON object the project metadata must contain

filter
string

Filter expression, for example eq(name, 'my-project')

sort_by
enum<string>
default:START_TIME

Sort column. FEEDBACK requires reference_dataset_id

Available options:
NAME,
START_TIME,
LAST_RUN_START_TIME,
ERROR_RATE,
LATENCY_P50,
LATENCY_P99,
FEEDBACK
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
sort_by_feedback_key
string

Feedback key to sort by; required when sort_by is FEEDBACK

sort_by_feedback_source
enum<string>

Where the sort feedback is recorded; defaults to RUN when sort_by is FEEDBACK

Available options:
RUN,
SESSION
dataset_version
string<date-time>

Only return experiments run against this dataset version (RFC 3339 timestamp)

include_stats
boolean
default:false

Include run statistics

include_facets
boolean
default:false

Include run facets

use_approx_stats
boolean
default:false

Compute statistics from pre-aggregated data, which is faster but up to an hour stale

stats_start_time
string<date-time>

Only aggregate statistics at or after this time, within the last 31 days

stats_select
string[]

Statistics to include when include_stats is true; defaults to all

stats_filter
string

Run filter expression that scopes the statistics

cursor
string

next_cursor from the previous page; omit for the first page

page_size
integer
default:20

Number of projects per page

Required range: 1 <= x <= 100

Response

A page of tracing projects

items
Session · object[]
required

Tracing projects on this page.

next_cursor
string | null
required

Pass as cursor to fetch the next page. Null on the last page.