> ## 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.

# Recover a Game's publications and exported client pack checks

> Requires builds.read for the Game.



## OpenAPI

````yaml scripts/reference/sources/openapi/management.json GET /v1/management/games/{gameId}/build-publications
openapi: 3.1.0
info:
  title: Summer Creator Management API
  version: summer.management.creator/v1
  description: >-
    Create and manage your Summer Games store games: store page drafts,
    revisions, preview links, media, builds and releases, and the owner approval
    that publishes them.
servers:
  - url: https://api.summer.games
security:
  - developerBearer: []
tags:
  - name: Games
  - name: Items
  - name: Media
paths:
  /v1/management/games/{gameId}/build-publications:
    parameters:
      - $ref: '#/components/parameters/GameID'
    get:
      tags:
        - Games
      summary: Recover a Game's publications and exported client pack checks
      description: >-
        Requires builds.read for the Game. Returns durable publications before
        and after their Build exists, ordered by createdAt then id descending.
        An exported publication includes clientPackage once its exact inspected
        pack is attached to the Build. A later client-only upload does not
        replace that identity. Package verifications report each platform's
        current check; uploaded does not mean qualified or released. Cursors are
        bound to the requesting principal and Game. No upload URLs or storage
        credentials are returned.
      operationId: listBuildPublications
      parameters:
        - $ref: '#/components/parameters/InventoryLimit'
        - $ref: '#/components/parameters/InventoryCursor'
      responses:
        '200':
          description: Current publication page
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - nextCursor
                properties:
                  items:
                    type: array
                    maxItems: 100
                    items:
                      $ref: '#/components/schemas/BuildPublication'
                  nextCursor:
                    type: string
                    description: Opaque continuation cursor; empty at the end.
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          description: Invalid query or cursor
components:
  parameters:
    GameID:
      name: gameId
      in: path
      required: true
      schema:
        type: string
        pattern: ^game_[A-Za-z0-9_-]{8,123}$
    InventoryLimit:
      name: limit
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 50
    InventoryCursor:
      name: cursor
      in: query
      schema:
        type: string
        minLength: 1
        maxLength: 2048
  schemas:
    BuildPublication:
      type: object
      required:
        - id
        - operationId
        - gameId
        - version
        - source
        - state
        - progress
        - executionMode
        - targetPlatforms
      properties:
        id:
          type: string
        operationId:
          type: string
        gameId:
          type: string
        buildId:
          type: string
        version:
          type: string
        source:
          type: object
          required:
            - kind
            - archiveSha256
            - sizeBytes
          properties:
            kind:
              type: string
              enum:
                - platform-upload
                - exported-game
                - summer-cloud
            format:
              type: string
              enum:
                - summer-bundle
                - pck
            uploadId:
              type: string
              description: Private Game upload reused by this publication, when present.
            id:
              type: string
            archiveSha256:
              type: string
            sizeBytes:
              type: integer
        clientVersion:
          type: string
          description: An exported game's client version.
        clientPackage:
          allOf:
            - $ref: '#/components/schemas/ClientPackageUpload'
          description: >-
            The exact inspected pack attached from this exported game; absent
            before Build completion. Later client-only uploads do not change it.
            Read verifications for platform readiness.
        executionMode:
          type: string
          enum:
            - hosted
            - standalone
        client:
          type: object
          properties:
            exportPreset:
              type: string
            entryPoint:
              type: string
        targetPlatforms:
          type: array
          items:
            type: string
        schema:
          type: string
          description: >-
            The summer.build.json schema; empty for an exported game without a
            host.
        summerVersion:
          type: string
          description: >-
            The project's or pack's Summer version that selected the template
            set.
        templateSetVersion:
          type: string
        state:
          type: string
          enum:
            - uploading
            - draft
            - orchestrating
            - pending
            - queued
            - materializing
            - building
            - packaging
            - publishing
            - verifying
            - preview_ready
            - published
            - succeeded
            - failed
            - cancelled
        progress:
          type: object
          description: >-
            checkpoint and phase; an exported game is inspecting between sealing
            and its outcome.
        errorCode:
          type: string
          description: >-
            Why the publication failed. Exported-game intake uses bundle_invalid
            (the bytes are not an admissible bundle or stamped pack),
            declaration_mismatch, template_set_unavailable,
            client_version_conflict, artifact_exists, approval_denied and
            capacity_limit_reached.
        errorMessage:
          type: string
        revision:
          type: integer
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        completedAt:
          type: string
          format: date-time
    ClientPackageUpload:
      type: object
      required:
        - id
        - gameId
        - buildId
        - clientSha256
        - clientSize
        - mainScene
        - version
        - declarationSha256
        - state
        - createdAt
      properties:
        id:
          type: string
        gameId:
          type: string
        buildId:
          type: string
        clientSha256:
          type: string
          pattern: ^sha256:[0-9a-f]{64}$
        clientSize:
          type: integer
          minimum: 100
          maximum: 42949672960
        mainScene:
          type: string
        compositionPath:
          type: string
        version:
          type: string
        declarationSha256:
          type: string
          description: >-
            Digest of the pack's bytes, scene, composition and version. A
            qualification binds to it.
        state:
          type: string
          enum:
            - awaiting_upload
            - verifying
            - uploaded
            - rejected
          description: >-
            verifying means storage sealed the bytes and Platform has not
            finished reading them; uploaded means Platform inspected them and
            queued its checks.
        verificationError:
          type: string
          enum:
            - package_not_verified
          description: >-
            Present when background verification permanently rejected the stored
            bytes.
        verifications:
          type: array
          description: The latest check of this pack for each platform its Build declares.
          items:
            $ref: '#/components/schemas/ClientVerificationJob'
        createdAt:
          type: string
          format: date-time
        completedAt:
          type: string
          format: date-time
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
            - retryable
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
            retryable:
              type: boolean
    ClientVerificationJob:
      type: object
      required:
        - id
        - gameId
        - buildId
        - uploadId
        - platform
        - state
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
        gameId:
          type: string
        buildId:
          type: string
        platform:
          type: string
          enum:
            - android
            - ios
            - macos
            - windows
        uploadId:
          type: string
        state:
          type: string
          enum:
            - checking
            - ready
            - failed
        qualificationId:
          type: string
        errorCode:
          type: string
        errorMessage:
          type: string
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        completedAt:
          type: string
          format: date-time
  responses:
    NotFound:
      description: Missing or inaccessible resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    developerBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        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.

````

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