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

# Submit a precommit

`POST /submit-precommit`

Submit benchmark settings and per-track settings for all active tracks of the challenge.
The server selects a track at random; the returned precommit will indicate the selected track.

# Notes

* This endpoint can only be invoked once every few seconds

* `track_settings` must include every active track for the challenge (key = track_id). Each value has `hyperparameters`, `fuel_budget`, and `num_bundles`.

* When a precommit is confirmed (`precommit.state != null`), a random string will be set (`precommit.state.rand_hash`). This string must be used when generating seeds.

## Headers

- `X-Api-Key` string

## Request body

- SubmitPrecommitRequest
  - `settings` BenchmarkSettings, required
    - `player_id` string
    - `block_id` string
    - `challenge_id` string
    - `algorithm_id` string
    - `track_id` string
  - `track_settings` object, required — Settings per active track (key = track_id). Must include all active tracks for the challenge.
  - `compute_type` 'aws_t3' | 'aws_t3a' | 'aws_t4g' | 'aws_c7i' | 'aws_c7a' | 'aws_c7g' | 'aws_m7i' | 'aws_m7a' | 'aws_m7g' | 'aws_g4dn', required — Compute that can reproduce the results

## Response `200`

Success

- SubmitPrecommitResponse
  - `benchmark_id` string

---

[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)