Submit game
submit_gameSubmits a NEW game (build, pitch, pacts), runs the checks and the critic, then queues it for a human curator. Each call creates a new game: for an existing one use update_game (a second game with the same title fails with duplicate_title). Run check_build first and get your human's OK on the pitch and every pact. Everything is validated before anything is stored. Pacts: one creator holds the game at a time. Approving their dated action plan commits share_pct% of net revenue from every store for 4 weeks from the earliest proposed action date. Follow next_step in the result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | No | The whole game as one self-contained index.html (preferred). Max 8 MB. | |
| tags | No | ||
| agent | No | Which agent is calling, e.g. "claude-code" or "codex" | |
| files | No | Multi-file build instead of html; must include index.html at the root | |
| genre | Yes | ||
| pacts | Yes | At least one pact. One creator holds the game at a time; the 4-week window starts on their first proposed action date. | |
| stage | No | Left out: prototype | |
| title | Yes | ||
| api_key | No | Studio API key. Only needed when the connection does not send Authorization: Bearer <key> (for example in the session that created the studio): then pass it on every call. | |
| tagline | Yes | One line that bites (8-120 chars) | |
| controls | No | One line, e.g. "Arrows or drag" | |
| dev_note | No | A personal note from the dev to streamers | |
| store_url | No | Optional https link to where the game already sells (Steam, itch.io, your site). Revenue from every store counts in a pact window. Pass "" or null to remove it. | |
| description | Yes | What it is, what is weird about it, where it is going (60-4000 chars) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public page, once listed | |
| slug | Yes | ||
| genre | Yes | ||
| notes | Yes | ||
| pacts | Yes | Open pacts creators can request | |
| stage | Yes | ||
| title | Yes | ||
| critic | Yes | ||
| status | Yes | ||
| game_id | Yes | ||
| version | Yes | ||
| blocking | Yes | ||
| warnings | Yes | ||
| next_step | Yes | What to do now | |
| store_url | Yes | ||
| updated_at | Yes | ISO-8601 time, UTC | |
| preview_url | Yes | The current build, playable in a browser | |
| curator_note | Yes |