Skip to main content
POST
cURL

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
Required string length: 1 - 128

Path Parameters

gameId
string
required
Required string length: 1 - 128
envId
string
required
Required string length: 1 - 128

Body

application/json
sourceReleaseId
string
Required string length: 1 - 128
title
string

At most 120 UTF-8 bytes.

notes
string

Optional Markdown, at most 32768 UTF-8 bytes (not Unicode code points). Images reference verified Game-owned uploads as summer-media:asset_ID; at most 16 unique images, no external image URLs. Initial notes are copied when the draft is published; public visibility requires actual non-Preview activation and current Game publication.

targets
object

Independent target selections. The server key takes buildId only; other keys name client platforms.

configRevisionId
string
Required string length: 1 - 128
secretVersions
object[]

Reserved for a qualified Game secret-reference capability. This runtime accepts only an empty list; nonempty references return unsupported_feature.

Response

Success.

id
string
required
Required string length: 1 - 128
gameId
string
required
Required string length: 1 - 128
environmentId
string
required
Required string length: 1 - 128
baseEnvironmentRevision
integer
required
Required range: x >= 0
revision
integer
required
Required range: x >= 1
title
string
required
notes
string
required

Optional Markdown, at most 32768 UTF-8 bytes.

targets
object
required

Independent target selections. The server key takes buildId only; other keys name client platforms.

secretVersions
object[]
required
baseReleaseId
string
Required string length: 1 - 128
configRevisionId
string
Required string length: 1 - 128
publishedReleaseId
string
Required string length: 1 - 128
createdAt
string<date-time>
updatedAt
string<date-time>