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
If-Match
string

Exact Game revision ETag; enables durable single-command publication.

Required string length: 3 - 160

Path Parameters

gameId
string
required
Pattern: ^game_[A-Za-z0-9_-]{8,123}$
revisionId
string
required
Pattern: ^(grev|irev)_[A-Za-z0-9_-]{8,123}$

Body

application/json
publishAt
string<date-time>

Response

Saved publication request

publicationId
string
required
operationId
string
required
status
enum<string>
required
Available options:
pending,
running,
succeeded,
failed
gameId
string
required
resourceType
string
required
Allowed value: "GAME_REVISION"
resourceId
string
required
revisionId
string
required
resourceVersion
integer
required
Required range: x >= 1
digestSha256
string
required
Pattern: ^[a-f0-9]{64}$
state
enum<string>
required
Available options:
WAITING_VERIFICATION,
REQUESTED,
SCHEDULED,
CANCELLED,
REJECTED,
BLOCKED,
ACTIVATING,
ACTIVATED,
UNPUBLISHING,
UNPUBLISHED,
SUPERSEDED
publishAt
string<date-time>
verificationRunId
string

Present for durable publication intent; absent on legacy publications.

errorCode
string

Reason for REJECTED or BLOCKED, including verification_changes_requested, verification_rejected or publication_authorization_revoked.