publish

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

Parameters

Name	Type	Required	Rules
`game_id`	UUID string	Yes	Must identify a game owned by the current account.
`lane`	string	No	Defaults to `main`. Use 1–32 lowercase letters, digits, or hyphens.

Example call

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

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/vikgmdev/ceiba",
  "sdk_status": "injected",
  "integration_prompt": "Your game is live at https://play.totemlabs.io/vikgmdev/ceiba (unlisted). Analytics are already flowing — zero code changes needed.\n\nRecommended one-liner: when your game reaches its score/end state, call\n\n  window.Totem.gameOver({ score });   // score: number\n\nthen re-upload (request_upload → tar+PUT) and publish again. This powers the score screen and leaderboard on the play page."
}

The new version is ready when this response returns. If processing is still active, the tool returns:

{
  "status": "publishing",
  "detail": "still running — call publish again to check"
}

Test lanes

Use a lane such as beta, alpha, or develop to publish a build without changing the live main build:

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

The resulting build is available at https://play.totemlabs.io/<handle>/<game-slug>@beta. A non-main lane is unlisted, but anyone with the exact link can open it. Scores, analytics, and discovery include only main sessions. Restricted tester access and build feedback remain planned.

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.

Connect

Tools

Parameters

Example call

Success

Test lanes

Validation failure

​Parameters

​Example call

​Success

​Test lanes

​Validation failure

Parameters

Example call

Success

Test lanes

Validation failure