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

## Changes

> 34 revisions in range; 2 could not be searched.

- **2026-06-22** `fad74baea1a5` — 1 breaking
  - added the new required request property `compute_type`
- **2026-02-03** `9d7802077a26` — 2 breaking, 3 warning
  - added the new required request property `track_settings`
  - the request property `settings` became required
  - removed the request property `hyperparameters`
  - removed the request property `num_nonces`
  - …1 more
- **2025-11-25** `2621ceeee7f1` — 1 warning, 1 info
  - removed the request property `settings/race_id`
  - added the new optional request property `settings/track_id`
- **2025-11-18** `f5c2c49d48ea` — 1 warning, 3 info
  - removed the request property `settings/difficulty`
  - added the new optional request property `hyperparameters`
  - added the new optional request property `runtime_config`
  - added the new optional request property `settings/race_id`
- **2024-10-04** `619cf3c6322a` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/tig-foundation/apis/the-innovation-game-api/changes/submit-precommit/post.md)

---

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