Skip to main content
GET
Rank runs by a metric

Authorizations

Authorization
string
header
required

API key obtained from the mlop dashboard

Query Parameters

projectName
string
required

Project name

logName
string
required

Metric name to rank by (e.g., 'train/loss', 'eval/accuracy')

aggregation
enum<string>
default:LAST

Aggregation type: MIN, MAX, AVG, LAST, VARIANCE (default: LAST)

Available options:
MIN,
MAX,
AVG,
LAST,
VARIANCE
direction
enum<string>
default:ASC

Sort direction: ASC (lowest first) or DESC (highest first). Default: ASC

Available options:
ASC,
DESC
limit
number | null
default:20

Number of runs to return (default: 20, max: 100)

offset
number | null
default:0

Offset for pagination (default: 0)

Response

200 - application/json

Ranked list of runs with metric values

projectName
string
required
logName
string
required
aggregation
string
required
direction
string
required
runs
object[]
required
total
number
required

Total number of runs that have this metric