---
title: "Submit a benchmark"
method: POST
path: "/submit-benchmark"
tags: ["POST"]
---

# Submit a benchmark

`POST /submit-benchmark`

# Notes

* This endpoint can only be invoked once every few seconds

* Order of `solution_nonces` does not matter

* When a benchmark is confirmed (`benchmark.state != null`), up to `3` nonces will be sampled (`benchmark.state.sampled_nonces`) for which the corresponding `merkle_proof` must be submitted via `/submit-proof` endpoint

* Header `X-Api-Key` is required. Use `/request-api-key` endpoint. 
  
  * If `<api_key>` is invalid, a `401` error will be returned

## Headers

- `X-Api-Key` string

## Request body

- SubmitBenchmarkRequest
  - `benchmark_id` string
  - `stopped` boolean
  - `merkle_root` string
  - `solution_quality` integer[]

## Response `200`

Success

- SubmitBenchmarkResponse
  - `ok` boolean

---

[API](https://skmtc.net/tig-foundation/apis/the-innovation-game-api.md) · [All operations](https://skmtc.net/tig-foundation/apis/the-innovation-game-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tig-foundation/the-innovation-game-api/versions/2af9c398c1d4/schema)