---
title: "Creates a benchmark."
method: POST
path: "/benchmark"
tags: ["Benchmark"]
---

# Creates a benchmark.

`POST /benchmark`

## Request body

- CreateBenchmarkEndpointInput
  - `name` string, required — The name of the benchmark.
  - `description` string, nullable — Optional plain-text credit for the people or sources behind the benchmark. Limited to 2000 characters; leave unset for none.
  - `initialBoostLevel` integer, nullable — Initial boost level applied to the campaign of every run created from this benchmark. Leave unset to fall back to DefaultInitialBoostLevel.
  - `minAssetsPerPrompt` integer, nullable — Optional submission quality gate. When set (at least 2), submitting a participant warns for any prompt it generated between 1 and N-1 samples for. Leave unset to disable.
  - `scoreShift` number, double, nullable — Additive offset applied to displayed scores on the benchmark's overall scoreboard; defaults to 0.
  - `scoreScale` number, double, nullable — Multiplicative factor applied to displayed scores on the benchmark's overall scoreboard, relative to the Bradley-Terry center. Defaults to 1.0; must be strictly positive.

## Response `200`

OK

- CreateBenchmarkEndpointOutput
  - `id` string, required — The id of the created benchmark.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

## Changes

- **2026-09-04** `9da534659e5f` — 2 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
  - added the new optional request property `minAssetsPerPrompt`

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/benchmark/post.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/9da534659e5f/schema)