Skip to main content
GET
Error

Authorizations

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

Query Parameters

id
string<uuid>[]

Return only the datasets with these IDs. Repeat the parameter for several IDs.

data_type
enum<string>[]

Return only datasets of these data types. Repeat the parameter for several types.

Enum for dataset data types.

Available options:
kv,
llm,
chat
name
string

Return only the dataset with exactly this name.

name_contains
string

Return only datasets whose name contains this text, ignoring case.

metadata
string

A JSON object. Return only datasets whose metadata contains every key and value in it.

tag_value_id
string<uuid>[]

Return only datasets tagged with all of these tag value IDs.

exclude_corrections_datasets
boolean
default:false

Leave out datasets that store corrections for an evaluator.

exclude
enum<string>[]

Fields to leave out of each dataset. An excluded example_count is returned as null and makes the response faster.

Available options:
example_count
sort_by
enum<string>
default:last_session_start_time

Field to sort by. last_session_start_time is the start time of the most recent experiment on the dataset. Datasets without a value come last in both orders. While a sort value changes, for example when an experiment starts, a dataset can be skipped or listed twice across pages. Sort by created_at for a stable walk. Enum for available dataset columns to sort by.

Available options:
name,
created_at,
last_session_start_time,
example_count,
session_count,
modified_at
sort_order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
page_size
integer
default:20

Maximum number of datasets to return.

Required range: 1 <= x <= 100
cursor
string

The next_cursor of the previous response. Omit it for the first page.

Response

OK

items
Dataset · object[]
required

Datasets on this page.

next_cursor
string | null
required

Cursor for the next page. Null when this is the last page.