Skip to main content
POST
Begin a Build from an exported game or from project source

Authorizations

Authorization
string
header
required

Your Summer account token. An agent gets it by signing in with OAuth: summer login --store in the Summer CLI, or the Summer connector in an AI app. Agent tokens can call only the operations on these pages. Publishing needs an approval from the game's owner first.

Headers

Idempotency-Key
string
required
Minimum string length: 1

Path Parameters

gameId
string
required
Pattern: ^game_[A-Za-z0-9_-]{8,123}$

Body

application/json

A game without a host targets iOS and names its client in build.client. A hosted game uploads a summer-bundle, declares its full server-only summer.build.v2 intent, and names the client scene in exportedClient. Intake verifies both packs, configuration and declarations. The export stamp selects the template set; Platform packages the exported server without rebuilding it.

build
object
required
source
object
required
clientVersion
string
required

The client pack's version: canonical vMAJOR.MINOR.PATCH with optional positive -rREVISION. A client version names exactly one pack for the Game.

exportedClient
object

Client scene for a hosted bundle; the hosted Build remains server-only.

Response

Publication accepted and awaiting its upload

operationId
string
required
publicationId
string
required
buildId
string
required

Preallocated; readable once the publication is preview_ready.

sourceId
string
required
state
string
required