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

# Summer Platform HTTP API

> The public Summer Platform HTTP API: creator management, analytics reads, the Summer Games store and account basics. Base URL, sign-in and every operation, generated from the platform's OpenAPI specs.

All operations use one base URL: `https://api.summer.games`. Most agents use these through [Summer operations](https://docs.summerengine.com/mcp/operations.md) instead; call HTTP directly when you build your own tool or service.

> [!NOTE]
>
> Generated from the OpenAPI specs in summer-platform (`api/management/openapi.yaml`, `api/analytics/openapi.yaml`, `api/player/openapi.yaml`) at commit `ff4f240996`. Only operations that developers and agents can call from outside are listed; internal, staff, game-server and owner-only operations are left out. The allowlist is `scripts/reference/http-api-allowlist.json`.

## Creator management

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.

**Sign-in:** 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.

| Operation | Method and path | Sign-in |
| - | - | - |
| [Begin a Build's client pack](https://docs.summerengine.com/api-reference/http/management/begin-client-package-upload.md) | `POST /v1/management/games/{gameId}/builds/{buildId}/client-packages` | Bearer token |
| [Read a Build pack and its checks](https://docs.summerengine.com/api-reference/http/management/get-client-package-upload.md) | `GET /v1/management/games/{gameId}/builds/{buildId}/client-packages/{uploadId}` | Bearer token |
| [Recover a Game's publications and exported client pack checks](https://docs.summerengine.com/api-reference/http/management/list-build-publications.md) | `GET /v1/management/games/{gameId}/build-publications` | Bearer token |
| [Begin a Build from an exported game or from project source](https://docs.summerengine.com/api-reference/http/management/create-build-publication.md) | `POST /v1/management/games/{gameId}/build-publications` | Bearer token |
| [Read a publication, its progress and its exported client pack checks](https://docs.summerengine.com/api-reference/http/management/get-build-publication.md) | `GET /v1/management/games/{gameId}/build-publications/{publicationId}` | Bearer token |
| [Open the publication's upload](https://docs.summerengine.com/api-reference/http/management/begin-build-publication-upload.md) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:source-upload` | Bearer token |
| [Grant writes for an exported game's upload parts](https://docs.summerengine.com/api-reference/http/management/sign-build-publication-parts.md) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:signParts` | Bearer token |
| [Seal the upload and accept it](https://docs.summerengine.com/api-reference/http/management/complete-build-publication-source.md) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:source-complete` | Bearer token |
| [Approve the preview Build](https://docs.summerengine.com/api-reference/http/management/publish-build-publication.md) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:publish` | Bearer token |
| [List creator game tags](https://docs.summerengine.com/api-reference/http/management/list-creator-game-tags.md) | `GET /v1/management/game-tags` | Bearer token |
| [List release drafts](https://docs.summerengine.com/api-reference/http/management/list-release-drafts.md) | `GET /v1/management/games/{gameId}/environments/{envId}/release-drafts` | Bearer token |
| [Create release draft](https://docs.summerengine.com/api-reference/http/management/create-release-draft.md) | `POST /v1/management/games/{gameId}/environments/{envId}/release-drafts` | Bearer token |
| [Get release draft](https://docs.summerengine.com/api-reference/http/management/get-release-draft.md) | `GET /v1/management/games/{gameId}/environments/{envId}/release-drafts/{draftId}` | Bearer token |
| [Publish coordinated release](https://docs.summerengine.com/api-reference/http/management/publish-coordinated-release.md) | `POST /v1/management/games/{gameId}/environments/{envId}/release-drafts/{draftId}:publish` | Bearer token |
| [List game builds](https://docs.summerengine.com/api-reference/http/management/list-game-builds.md) | `GET /v1/management/games/{gameId}/builds` | Bearer token |
| [Get game build](https://docs.summerengine.com/api-reference/http/management/get-game-build.md) | `GET /v1/management/games/{gameId}/builds/{buildId}` | Bearer token |
| [List creator games](https://docs.summerengine.com/api-reference/http/management/list-creator-games.md) | `GET /v1/management/games` | Bearer token |
| [Create creator game](https://docs.summerengine.com/api-reference/http/management/create-creator-game.md) | `POST /v1/management/games` | Bearer token |
| [Get creator game](https://docs.summerengine.com/api-reference/http/management/get-creator-game.md) | `GET /v1/management/games/{gameId}` | Bearer token |
| [List game revisions](https://docs.summerengine.com/api-reference/http/management/list-game-revisions.md) | `GET /v1/management/games/{gameId}/revisions` | Bearer token |
| [Fork game revision](https://docs.summerengine.com/api-reference/http/management/fork-game-revision.md) | `POST /v1/management/games/{gameId}/revisions` | Bearer token |
| [Get game approval](https://docs.summerengine.com/api-reference/http/management/get-game-approval.md) | `GET /v1/management/games/{gameId}/approval` | Bearer token |
| [Get game revision](https://docs.summerengine.com/api-reference/http/management/get-game-revision.md) | `GET /v1/management/games/{gameId}/revisions/{revisionId}` | Bearer token |
| [Patch game revision](https://docs.summerengine.com/api-reference/http/management/patch-game-revision.md) | `PATCH /v1/management/games/{gameId}/revisions/{revisionId}` | Bearer token |
| [Preview game revision](https://docs.summerengine.com/api-reference/http/management/preview-game-revision.md) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/preview` | Bearer token |
| [List game revision preview links](https://docs.summerengine.com/api-reference/http/management/list-game-revision-preview-links.md) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/preview-links` | Bearer token |
| [Create game revision preview link](https://docs.summerengine.com/api-reference/http/management/create-game-revision-preview-link.md) | `POST /v1/management/games/{gameId}/revisions/{revisionId}/preview-links` | Bearer token |
| [Get game revision verification](https://docs.summerengine.com/api-reference/http/management/get-game-revision-verification.md) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/verification` | Bearer token |
| [Submit game revision](https://docs.summerengine.com/api-reference/http/management/submit-game-revision.md) | `POST /v1/management/games/{gameId}/revisions/{revisionId}:submit` | Bearer token |
| [List owner approvals](https://docs.summerengine.com/api-reference/http/management/list-owner-approvals.md) | `GET /v1/management/games/{gameId}/owner-approvals` | Bearer token |
| [Get owner approval](https://docs.summerengine.com/api-reference/http/management/get-owner-approval.md) | `GET /v1/management/games/{gameId}/owner-approvals/{approvalId}` | Bearer token |
| [Cancel owner approval](https://docs.summerengine.com/api-reference/http/management/cancel-owner-approval.md) | `POST /v1/management/games/{gameId}/owner-approvals/{approvalId}:cancel` | Bearer token |
| [Publish game revision](https://docs.summerengine.com/api-reference/http/management/publish-game-revision.md) | `POST /v1/management/games/{gameId}/revisions/{revisionId}:publish` | Bearer token |
| [Get storefront live](https://docs.summerengine.com/api-reference/http/management/get-storefront-live.md) | `GET /v1/management/games/{gameId}/storefront/live` | Bearer token |
| [Get game store interest](https://docs.summerengine.com/api-reference/http/management/get-game-store-interest.md) | `GET /v1/management/games/{gameId}/store/interest` | Bearer token |
| [Get game price](https://docs.summerengine.com/api-reference/http/management/get-game-price.md) | `GET /v1/management/games/{gameId}/price` | Bearer token |
| [Begin media upload](https://docs.summerengine.com/api-reference/http/management/begin-media-upload.md) | `POST /v1/management/media-assets:begin-upload` | Bearer token |
| [Get media asset](https://docs.summerengine.com/api-reference/http/management/get-media-asset.md) | `GET /v1/management/media-assets/{assetId}` | Bearer token |
| [Complete media upload](https://docs.summerengine.com/api-reference/http/management/complete-media-upload.md) | `POST /v1/management/media-assets/{assetId}:complete` | Bearer token |
| [Preview media asset](https://docs.summerengine.com/api-reference/http/management/preview-media-asset.md) | `GET /v1/management/media-assets/{assetId}/preview` | Bearer token |

## Analytics

Read your game's analytics: the activity overview and the catalog of events your game sends.

**Sign-in:** Your Summer account token, the same one the creator management API uses (`summer login --store`). You can read only games you own or manage.

| Operation | Method and path | Sign-in |
| - | - | - |
| [Read built-in Game activity for the last whole UTC days](https://docs.summerengine.com/api-reference/http/analytics/get-game-activity-overview.md) | `GET /v1/management/games/{gameId}/environments/{envId}/analytics/activity` | Bearer token |
| [Discover observed event and property names](https://docs.summerengine.com/api-reference/http/analytics/get-analytics-catalog.md) | `GET /v1/management/games/{gameId}/environments/{envId}/analytics/catalog` | Bearer token |

## Store and account

Public Summer Games store reads, the connected-app OAuth endpoints, and the signed-in player's profile and preferences.

**Sign-in:** 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.

| Operation | Method and path | Sign-in |
| - | - | - |
| [Player MCP authorization server metadata (RFC 8414)](https://docs.summerengine.com/api-reference/http/player/get-o-auth-authorization-server-metadata.md) | `GET /.well-known/oauth-authorization-server` | None |
| [Register a player MCP client (RFC 7591)](https://docs.summerengine.com/api-reference/http/player/register-o-auth-client.md) | `POST /v1/oauth/register` | None |
| [Exchange a code or refresh token for a player MCP access token](https://docs.summerengine.com/api-reference/http/player/exchange-o-auth-token.md) | `POST /v1/oauth/token` | None |
| [Read the collected lifetime Play total for a public Game](https://docs.summerengine.com/api-reference/http/player/read-public-play-total.md) | `GET /v1/store/games/{gameId}/play-total` | None |
| [Get player profile](https://docs.summerengine.com/api-reference/http/player/get-player-profile.md) | `GET /v1/identity/me/profile` | Bearer token |
| [Update player profile](https://docs.summerengine.com/api-reference/http/player/update-player-profile.md) | `PATCH /v1/identity/me/profile` | Bearer token |
| [Get player preferences](https://docs.summerengine.com/api-reference/http/player/get-player-preferences.md) | `GET /v1/identity/me/preferences` | Bearer token |
| [Replace player preferences](https://docs.summerengine.com/api-reference/http/player/replace-player-preferences.md) | `PUT /v1/identity/me/preferences` | Bearer token |
| [Browse games](https://docs.summerengine.com/api-reference/http/player/browse-games.md) | `GET /v1/store/games` | None |
| [Get published game](https://docs.summerengine.com/api-reference/http/player/get-published-game.md) | `GET /v1/store/games/{gameId}` | None |
| [Get published game image](https://docs.summerengine.com/api-reference/http/player/get-published-game-image.md) | `GET /v1/store/games/{gameId}/publications/{publicationId}/images/{assetId}` | None |
| [Get published game image variant](https://docs.summerengine.com/api-reference/http/player/get-published-game-image-variant.md) | `GET /v1/store/games/{gameId}/publications/{publicationId}/images/{assetId}/variants/{size}` | None |
| [Get published item image](https://docs.summerengine.com/api-reference/http/player/get-published-item-image.md) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/images/{assetId}` | None |
| [Get published item image variant](https://docs.summerengine.com/api-reference/http/player/get-published-item-image-variant.md) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/images/{assetId}/variants/{size}` | None |
| [Get published game model](https://docs.summerengine.com/api-reference/http/player/get-published-game-model.md) | `GET /v1/store/games/{gameId}/publications/{publicationId}/models/{assetId}` | None |
| [Get published item model](https://docs.summerengine.com/api-reference/http/player/get-published-item-model.md) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/models/{assetId}` | None |
| [List game updates](https://docs.summerengine.com/api-reference/http/player/list-game-updates.md) | `GET /v1/store/games/{gameId}/updates` | None |
| [Get game update](https://docs.summerengine.com/api-reference/http/player/get-game-update.md) | `GET /v1/store/games/{gameId}/updates/{activationId}` | None |
| [List published store items](https://docs.summerengine.com/api-reference/http/player/list-published-store-items.md) | `GET /v1/store/items` | None |
| [List published game items](https://docs.summerengine.com/api-reference/http/player/list-published-game-items.md) | `GET /v1/games/{gameId}/store/items` | None |
| [Get published item](https://docs.summerengine.com/api-reference/http/player/get-published-item.md) | `GET /v1/games/{gameId}/store/items/{itemId}` | None |
| [List game tags](https://docs.summerengine.com/api-reference/http/player/list-game-tags.md) | `GET /v1/store/tags` | None |
| [List featured games](https://docs.summerengine.com/api-reference/http/player/list-featured-games.md) | `GET /v1/store/featured` | None |


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