Skip to main content
GET
List runs with optional search and tag filtering

Authorizations

Authorization
string
header
required

API key obtained from the mlop dashboard

Query Parameters

projectName
string
required

Project name

Example:

"my-project"

Search term for run names (substring match)

Example:

"training"

tags
string

Comma-separated list of tags to filter by (OR logic)

Example:

"baseline,experiment"

limit
number
default:50

Maximum number of runs to return

Required range: 1 <= x <= 200
Example:

50

includeFieldValues
boolean | null
default:false

When true, attach _flatConfig and _flatSystemMetadata to each run. Off by default for lean SDK responses.

Example:

false

visibleColumns
string

JSON-encoded array of {source:'config'|'systemMetadata', key:string}. Restricts _flatConfig/_flatSystemMetadata to the listed keys. Empty array = no field values.

Example:

"[{\"source\":\"config\",\"key\":\"lr\"}]"

Response

List of runs

runs
object[]
required
total
number
required

Total count of matching runs