Skip to main content
PATCH
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
required
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
minimumAge
enum<integer> | null

Optional declared minimum age; not an official rating or access rule. Omission preserves the value on PATCH; null resets it to All ages. Published metadata changes only after revision publication.

Available options:
3,
7,
12,
16,
18,
null

Ordered currently published Items of this Game. Empty clears selection; prices remain live.

Maximum array length: 6
Pattern: ^item_[A-Za-z0-9_-]+$
languages
string[]
Maximum array length: 30
Pattern: ^[a-z]{2,3}(-[a-z0-9]{2,8}){0,2}$
subtitle
string

Optional single-line subtitle; empty clears it.

Maximum string length: 160
supportedPlatforms
enum<string>[]

Creator-declared player platforms; this does not certify a playable build. New Games and newly submitted drafts require explicit targets. Historical revisions may have an empty declaration.

Required array length: 1 - 6 elements
Available options:
android,
ios,
linux,
macos,
web,
windows
name
string
Required string length: 1 - 120
description
string
Required string length: 1 - 5000
tags
string[]
Maximum array length: 20
mediaAssetIds
string[]
Maximum array length: 20
iconAssetId
string

Verified image in mediaAssetIds used as the Game icon. Empty string clears it; omission preserves the selection.

Pattern: ^(|asset_[0-9A-Za-z]{26})$
release
object | null

Declared release. Omission preserves it; null clears it, so the Game is out once published. A published Coming Soon Game is listed but cannot be bought, played or downloaded until a revision that releases it is published.

systemRequirements
object | null

Omission preserves; null clears. Published with the reviewed revision.

aiDisclosure
object | null

Omission preserves; null clears. Published with the reviewed revision.

contentSurvey
object | null

Omission preserves; null clears. Published with the reviewed revision.

mediaSlots
object | null

Omission preserves; null clears; a value replaces every slot. Each referenced asset must be in this revision's mediaAssetIds (send both together when they change). Published with the reviewed revision.

longDescription
string | null

The store page's About this game, plain text; blank lines separate paragraphs (trimmed, up to 12000 characters). The short description is description. Omission preserves; null or an empty string clears. Published with the reviewed revision.

Maximum string length: 12000
genres
string[] | null

Omission preserves; null clears. Published with the reviewed revision.

Required array length: 1 - 5 elements
Pattern: ^[a-z0-9][a-z0-9._-]{0,47}$
features
enum<string>[] | null

Omission preserves; null clears. Published with the reviewed revision.

Minimum array length: 1
Available options:
single_player,
online_multiplayer,
local_multiplayer,
online_coop,
local_coop,
cross_platform,
controller_full,
controller_partial,
cloud_saves,
plays_in_browser,
level_editor,
achievements,
in_game_purchases
credits
object | null

Omission preserves; null clears; a value replaces the credits. Published with the reviewed revision.

languageSupport
object[] | null

Omission preserves; null clears the support matrix and keeps languages. A value sets languages to its codes when languages is omitted; when both are sent, or languages is sent alone while support is declared, the codes must equal languages or the edit is 422. Published with the reviewed revision.

Required array length: 1 - 30 elements

Omission preserves; null clears; a value replaces every link. Published with the reviewed revision.

Required array length: 1 - 10 elements
mobile
object | null

The iPhone and Android tagline and description. Omission preserves; null clears it, and so does a value whose texts are all null or empty, so the phone apps use the desktop subtitle and description. A value replaces both texts. Revision reads always carry mobile, null when cleared. Published with the reviewed revision.

Response

Resource view

The response is of type object.