---
title: "Start a benchmark run"
method: POST
path: "/benchmark/start"
tags: ["Benchmark"]
---

# Start a benchmark run

`POST /benchmark/start`

Starts a benchmark run with the supplied (or default) configuration.
The run executes in the background; poll GET /api/benchmark/status
and GET /api/benchmark/report for progress and results.
Creates temporary `_benchmark_*` collections that are cleaned up
automatically on completion or cancellation.

## Request body

- BenchmarkConfig — Configuration for a benchmark run. All values have safe defaults designed to avoid overloading a shared production database. Omit the body entirely to use all defaults.
  - `seedCount` integer — Number of deterministic seed records to create.
  - `concurrency` integer — Maximum degree of parallelism for scenario execution.
  - `duration` string — Total benchmark duration (TimeSpan format, e.g. '00:03:00'). Scenarios loop until this elapses.
  - `throttleDelay` string — Delay injected between every Mongo operation (TimeSpan format, e.g. '00:00:00.010').
  - `collectionPrefix` string — Prefix applied to all temporary benchmark collections.

## Response `202`

Benchmark started

- StartBenchmarkResponse
  - `message` string
  - `config` BenchmarkConfig — Configuration for a benchmark run. All values have safe defaults designed to avoid overloading a shared production database. Omit the body entirely to use all defaults.
    - `seedCount` integer — Number of deterministic seed records to create.
    - `concurrency` integer — Maximum degree of parallelism for scenario execution.
    - `duration` string — Total benchmark duration (TimeSpan format, e.g. '00:03:00'). Scenarios loop until this elapses.
    - `throttleDelay` string — Delay injected between every Mongo operation (TimeSpan format, e.g. '00:00:00.010').
    - `collectionPrefix` string — Prefix applied to all temporary benchmark collections.

## Other responses

- `409` — A benchmark is already running

---

[API](https://skmtc.net/defra/apis/keeper-data-bridge-api.md) · [All operations](https://skmtc.net/defra/apis/keeper-data-bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/defra/keeper-data-bridge-api/versions/0ab7d7a7a24f/schema)