v1

latestOpenAPI 3.0.42026-08-04342835917.6 KB
Leaderboard

Creates a new leaderboard.

post/leaderboard

Request body

benchmarkIdstring nullable

If the leaderboard should be added to a preexisting benchmark, the benchmark id.

benchmarkNamestring nullable

When no BenchmarkId is provided, the name of the new benchmark to create.

benchmarkDescriptionstring nullable

Optional plain-text credit for the people or sources behind the benchmark, applied to the new benchmark created via BenchmarkName. Limited to 2000 characters. Ignored when an existing BenchmarkId is provided. Leave unset for no description.

namestring required

The name of the leaderboard.

instructionstring required

The instruction datapoints will be matched up against.

showPromptboolean required

Indicates if the prompt is shown on the rapids.

showPromptAssetboolean

Whether the prompt asset should be shown on the rapids.

responseBudgetinteger nullable

Total amount of responses that get collected per run.

minResponsesinteger nullable

The minimum amount of responses that need to be collected per comparison.

isInversedboolean

Whether the results should be inversed, selecting the worse model.

audienceIdstring nullable

Optional audience id; defaults to the global audience when unset.

priorityinteger

Optional priority override applied to every run's job. Admin-only. When unset, runs use the default leaderboard priority.

weightnumber double

Multiplier applied to every match result of this leaderboard when it contributes to the parent benchmark's overall / combined scoreboards. Defaults to 1.0 when unset; unbounded (negative and zero values are accepted).

scoreShiftnumber double

Additive offset applied to displayed scores on this leaderboard's per-leaderboard scoreboard. Defaults to 0 when unset.

scoreScalenumber double

Multiplicative factor applied to displayed scores (relative to the Bradley-Terry center) on this leaderboard's per-leaderboard scoreboard. Defaults to 1.0 when unset; must be strictly positive.

isHiddenboolean

Whether the leaderboard should be created hidden. Admin-only.

isExcludedFromOverallboolean

Whether the leaderboard is excluded from its benchmark's overall / combined scoreboard. When set, the leaderboard becomes an owner-only private experiment: its results do not contribute to the overall and it is visible only to its owner and admins. Defaults to false when unset.

voteAggregation'AllVotes' | 'MajorityVote'
includedTagsstring[]

Prompt tag values to restrict the leaderboard's matchups to. Only prompts carrying at least one of these tags are used; an empty list means no restriction.

excludedTagsstring[]

Prompt tag values the leaderboard never creates matchups for. Takes precedence over includedTags: a prompt carrying an excluded tag is skipped even when one of its other tags is included.

Response

OK

idstring required

The id of the created leaderboard.

benchmarkIdstring required

The id of the benchmark the leaderboard belongs to.

showPromptboolean required

Whether the prompt is shown on the rapids.

showPromptAssetboolean required

Whether the prompt asset is shown on the rapids.

responseBudgetinteger required

The response budget per run.

minResponsesinteger required

The minimum responses per comparison.

isInversedboolean required

Whether the leaderboard results are inversed.

voteAggregation'AllVotes' | 'MajorityVote' required