publish

Validate an uploaded build and create a playable version.

Validates the most recently uploaded archive for a game. A valid build becomes an immutable, numbered version.

Parameters

Name	Type	Required	Rules
game_id	UUID string	Yes	Must identify a game owned by the current account.

Example call

{
  "game_id": "018f2f4e-b73b-7e91-a419-0c8ac91af1c2"
}

Call publish only after the HTTP PUT to the current upload URL succeeds.

Success

{
  "game_id": "018f2f4e-b73b-7e91-a419-0c8ac91af1c2",
  "play_url": "https://play.totemlabs.io/moonforge/afterlight",
  "integration_prompt": "Call window.Totem.gameOver({ score }) when a run ends."
}

The new version is ready when this response returns.

Validation failure

publish returns every detected violation in one response.

{
  "game_id": "018f2f4e-b73b-7e91-a419-0c8ac91af1c2",
  "errors": [
    {
      "code": "NO_INDEX_HTML",
      "path": null,
      "remediation": "Place index.html at the archive root and upload a new build."
    },
    {
      "code": "DISALLOWED_EXTENSION",
      "path": "tools/dev-server.sh",
      "remediation": "Remove the file or convert it to an allowed static web asset."
    }
  ]
}

Read When publishing fails for the complete code table.

A failed build never replaces the current public version.