Skip to main content
POST
Create a benchmark from a bundle zip
A bundle is the full benchmark format, so this is how you create anything a spec cannot express: several phases, several tasks, your own scoring program and metrics, custom leaderboard columns, image and code benchmarks, and a custom Docker image. See Bundle structure for the files and YAML reference for every competition.yaml field.

Authorizations

Authorization
string
header
required

Platform API token created under Profile Settings > Platform API tokens. Scopes are fixed at creation.

Query Parameters

dry_run
boolean

Validate only: answers 200 with a summary and creates nothing

Body

multipart/form-data
bundle
file
required

The competition bundle .zip

file
file

Accepted as an alias for bundle

Response

dry_run: the bundle is usable; nothing was created

valid
boolean
title
string

The title from competition.yaml

files
integer
bytes
integer
unpacked_bytes
integer
warnings
string[]

Advice that does not block creation: a leaderboard column no scoring program appears to write, placeholder text left in the manifest, an empty image, or a manifest with no pages.

Last modified on September 16, 2026