> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get game update

> Full public update addressed by stable activation ID, not release ID.



## OpenAPI

````yaml scripts/reference/sources/openapi/player.json GET /v1/store/games/{gameId}/updates/{activationId}
openapi: 3.1.0
info:
  title: Summer Player Game Platform API
  version: summer.player.games/v1
  description: >-
    Public Summer Games store reads, the connected-app OAuth endpoints, and the
    signed-in player's profile and preferences.
servers:
  - url: https://api.summer.games
security:
  - playerBearer: []
paths:
  /v1/store/games/{gameId}/updates/{activationId}:
    get:
      description: >-
        Full public update addressed by stable activation ID, not release ID.
        Current published Game visibility and non-Preview activation are
        required. Editorial corrections do not change activation identity or
        time. All responses use Cache-Control no-store; no conditional 304.
      operationId: getGameUpdate
      parameters:
        - name: gameId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
        - name: activationId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
      responses:
        '200':
          description: Full activation entry with optional release notes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameUpdateDetail'
        '400':
          description: Unknown query parameter.
        '404':
          description: Game is not published or public activation does not exist.
        '503':
          description: History or media delivery unavailable.
      security: []
components:
  schemas:
    GameUpdateDetail:
      allOf:
        - $ref: '#/components/schemas/GameUpdateActivation'
        - type: object
          properties:
            releaseNote:
              $ref: '#/components/schemas/ReleaseNoteDetail'
    GameUpdateActivation:
      type: object
      required:
        - activationId
        - releaseId
        - reason
        - activatedAt
        - platforms
      properties:
        activationId:
          type: string
        releaseId:
          type: string
        reason:
          type: string
          enum:
            - deploy
            - rollback
            - recovery
        activatedAt:
          type: string
          format: date-time
        platforms:
          type: array
          items:
            $ref: '#/components/schemas/GamePlatform'
    ReleaseNoteDetail:
      allOf:
        - $ref: '#/components/schemas/ReleaseNoteSummary'
        - type: object
          required:
            - markdown
            - media
          properties:
            markdown:
              type: string
              description: >-
                At most 32768 UTF-8 bytes. Render Markdown with raw HTML
                disabled. Uploaded images use summer-media:asset_ID references
                resolved from media; no signed URLs are persisted. Only
                supported canonical YouTube/Vimeo links may be embedded;
                external images are unsupported.
            media:
              type: array
              maxItems: 16
              items:
                allOf:
                  - $ref: '#/components/schemas/Media'
                  - type: object
                    properties:
                      kind:
                        type: string
                        const: IMAGE
              description: >-
                Fresh signed delivery URLs for verified Game-owned images. URLs
                expire; reload the entry to refresh. Previously issued URLs
                remain usable until expiry after withdrawal. Storage keys and
                buckets are never exposed.
    GamePlatform:
      type: string
      enum:
        - android
        - ios
        - linux
        - macos
        - web
        - windows
    ReleaseNoteSummary:
      type: object
      required:
        - title
        - revision
        - createdAt
        - updatedAt
      properties:
        title:
          type: string
          description: At most 120 UTF-8 bytes.
        revision:
          type: integer
          format: int64
          minimum: 1
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
          description: Editorial correction time; independent of activation time.
    Media:
      type: object
      properties:
        assetId:
          type: string
          minLength: 1
          maxLength: 128
        kind:
          type: string
          enum:
            - IMAGE
            - VIDEO
            - MODEL_3D
        url:
          type: string
          format: uri
          description: >-
            Stable Platform URL for public IMAGE and MODEL_3D delivery; no
            redirect or signature. Images use the 1920px maximum-edge web
            version when prepared, otherwise the original. Other delivery
            references may remain signed.
        variants:
          type: array
          maxItems: 4
          description: >-
            Optional publication-scoped image representations. All share this
            media reference's expiry and visibility rules; dimensions preserve
            aspect ratio without upscaling. Sizes 128, 256 and 512 target the
            shorter edge with a four-times-size longer-edge cap (2048 pixels for
            size 512); size 1920 remains a maximum-edge rendition. Smaller
            originals retain their dimensions. Publications may omit variants
            until prepared.
          items:
            type: object
            required:
              - size
              - width
              - height
              - url
              - contentType
            properties:
              size:
                type: integer
                enum:
                  - 128
                  - 256
                  - 512
                  - 1920
              width:
                type: integer
                minimum: 1
                maximum: 2048
              height:
                type: integer
                minimum: 1
                maximum: 2048
              url:
                type: string
                format: uri
              contentType:
                type: string
                enum:
                  - image/jpeg
                  - image/png
        expiresAt:
          type: string
          format: date-time
          description: >-
            Refresh or revalidate the delivery reference by this deadline. For
            stable public IMAGE and MODEL_3D URLs this is a revalidation
            deadline, not URL invalidation. Other signed or private references
            retain their URL expiry semantics. Required for backward
            compatibility.
      required:
        - assetId
        - kind
        - url
        - expiresAt
  securitySchemes:
    playerBearer:
      type: http
      scheme: bearer
      description: >-
        A player access token. Store reads need no token. Other apps get a token
        through connected-app OAuth: register the client, let the player approve
        it on summer.games, then exchange the code at the token endpoint.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.