---
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 no description.
  - `initialBoostLevel` integer, nullable — Initial boost level applied to the campaign of every run created from this benchmark. Leave unset to fall back to DefaultInitialBoostLevel. Admins may set any value the validator allows (0-10); non-admins are restricted to 0..BenchmarkEntity.DefaultInitialBoostLevel — anything outside that range returns 403 Forbidden via IsAllowedToSetInitialBoostLevel.
  - `scoreShift` number, double, nullable — Additive offset applied to displayed scores on the overall scoreboard of this benchmark. Defaults to 0 when unset.
  - `scoreScale` number, double, nullable — Multiplicative factor applied to displayed scores (relative to the Bradley-Terry center) on the overall scoreboard of this benchmark. Defaults to 1.0 when unset; 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

---

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