Update a model alias
Changes the benchmark, the candidates, the default or the pin, then ranks again. Omitted fields keep their value; null clears task_id, default_model_id or pinned_model_id. New candidates must keep the alias’s API format. A default or pin that would no longer be a candidate must be replaced or cleared in the same request.
Authorizations
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Body
The alias to change. An alias cannot be renamed.
1 - 255An eval suite owned by this organization.
1 - 255A metric id the suite's active version declares. Its higher_is_better decides which score wins.
1 - 128A task of the suite to rank on. Null ranks the metric averaged over every task, counting only runs that cover every task of the version.
1 - 255Two to 16 active models of one API format. The alias only ever serves one of these. Order breaks ties: the earlier model wins an equal score.
2 - 16 elements1 - 255A candidate to serve until a first winner exists. Null leaves the alias unresolvable until then.
1 - 255A candidate to serve regardless of results. While set, recomputes still record the standings but do not change what is served. Null unpins.
1 - 255Response
OK
The suite version the last recompute ranked. Null before one could be read.
-9007199254740991 <= x <= 9007199254740991responses, completions, embeddings, images, transcriptions, tts, rerank The benchmark winner. Null until one exists.
What a request for the alias is served by: the pin, else the winner, else the default.
pinned, benchmark, default ok: serving a ranked winner. waiting_for_results: no complete result to rank yet, so the last winner or the default holds. metric_missing: the suite's active version no longer declares the metric or task. suite_missing: the suite was deleted. The last two hold the last winner until the alias is edited.
ok, waiting_for_results, metric_missing, suite_missing Whether a request for the alias resolves right now: it serves a model that is still active in the registry.