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

# List game builds

> Lists immutable Builds, including preview Builds, with optional platform filtering before pagination.



## OpenAPI

````yaml scripts/reference/sources/openapi/management.json GET /v1/management/games/{gameId}/builds
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}/builds:
    parameters:
      - $ref: '#/components/parameters/GameID'
    get:
      tags:
        - Games
      description: >-
        Lists immutable Builds, including preview Builds, with optional platform
        filtering before pagination. Requires builds.read; this is not a player
        delivery endpoint.
      operationId: listGameBuilds
      parameters:
        - name: platform
          in: query
          schema:
            type: string
            enum:
              - android
              - ios
              - linux
              - macos
              - web
              - windows
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: cursor
          in: query
          description: Opaque continuation bound to the creator, Game and platform filter.
          schema:
            type: string
      responses:
        '200':
          description: Builds newest first by immutable identity.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - nextCursor
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Build'
                  nextCursor:
                    type: string
        '422':
          description: Invalid platform or continuation.
components:
  parameters:
    GameID:
      name: gameId
      in: path
      required: true
      schema:
        type: string
        pattern: ^game_[A-Za-z0-9_-]{8,123}$
  schemas:
    Build:
      type: object
      required:
        - id
        - gameId
        - version
        - targetPlatforms
        - executionMode
        - artifactSha256
        - serverImage
        - sourceRevision
        - manifest
        - status
        - createdAt
      properties:
        id:
          type: string
        gameId:
          type: string
        version:
          type: string
        targetPlatforms:
          $ref: '#/components/schemas/RecordedBuildTargets'
        executionMode:
          type: string
          enum:
            - hosted
            - standalone
        client:
          type: object
          description: Immutable standalone export preset, entry point and runtime target.
        artifactSha256:
          type: string
        serverImage:
          type: string
        sourceRevision:
          type: string
        permissions:
          $ref: '#/components/schemas/BuildPermissions'
        manifest:
          type: object
          description: Runtime manifest. Build targets are top-level metadata.
        status:
          type: string
          enum:
            - pending
            - preview_ready
            - ready
            - failed
            - revoked
        createdAt:
          type: string
          format: date-time
    RecordedBuildTargets:
      type: array
      maxItems: 6
      uniqueItems: true
      description: >-
        Immutable Build declaration. Empty only for legacy Builds with
        unspecified targets; never inherited from mutable Game intent.
      items:
        type: string
        enum:
          - android
          - ios
          - linux
          - macos
          - web
          - windows
    BuildPermissions:
      type: array
      uniqueItems: true
      maxItems: 5
      description: >-
        Optional player-data and delegated-action requests declared by this
        immutable Build. Omission means none. A declaration is not player
        consent; refusal never prevents Game admission.
      items:
        type: string
        enum:
          - social.friends.read
          - social.messages.read
          - social.messages.send
          - social.messages.read_state.write
          - game.chat.send
  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.