Skip to main content
POST
cURL

Body

application/json
experiment_ids
string[]

List of experiment IDs to search over.

filter
string

A filter expression over params, metrics, and tags, that allows returning a subset of runs. The syntax is a subset of SQL that supports ANDing together binary operations between a param, metric, or tag and a constant.

Example: metrics.rmse < 1 and params.model_class = 'LogisticRegression'

You can select columns with special characters (hyphen, space, period, etc.) by using double quotes: metrics."model class" = 'LinearRegression' and tags."user-name" = 'Tomas'

Supported operators are =, !=, >, >=, <, and <=.

max_results
default:1000

Maximum number of runs desired. Max threshold is 50000

order_by
string[]

List of columns to be ordered by, including attributes, params, metrics, and tags with an optional "DESC" or "ASC" annotation, where "ASC" is the default. Example: ["params.input DESC", "metrics.alpha ASC", "metrics.rmse"] Tiebreaks are done by start_time DESC followed by run_id for runs with the same start time (and this is the default ordering criterion if order_by is not provided).

page_token
string
run_view_type
enum<string>
default:ACTIVE_ONLY

Whether to display only active, only deleted, or all runs. Defaults to only active runs.

Available options:
ACTIVE_ONLY,
DELETED_ONLY,
ALL

Response

Runs matching search

next_page_token
string
runs
object[]

Runs that match the search criteria.