TRtrainy
Runs

Rank runs by a metric

Returns runs ranked by a metric aggregation (MIN, MAX, AVG, LAST, VARIANCE) using pre-computed metric summaries. Much faster than comparing individual runs. Useful for finding the best runs in a project by loss, accuracy, or any other metric.

get/api/runs/leaderboard

Request

  • Base URL
    https://pluto-api.trainy.ai
  • Auth
    HTTP bearer

Query parameters

projectNamestring required

Project name

logNamestring required

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

aggregation'MIN' | 'MAX' | 'AVG' | 'LAST' | 'VARIANCE'

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

direction'ASC' | 'DESC'

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

limitnumber nullable

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

offsetnumber nullable

Offset for pagination (default: 0)

Response

Ranked list of runs with metric values

projectNamestring required
logNamestring required
aggregationstring required
directionstring required
totalnumber required

Total number of runs that have this metric

Changes

No recorded changes to this operation across all 1 revision of this API.