> ## 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 the [MCP tools](/mcp/tools-reference) 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`.
</Note>

## 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](/api-reference/http/management/begin-client-package-upload) | `POST /v1/management/games/{gameId}/builds/{buildId}/client-packages` | Bearer token |
| [Read a Build pack and its checks](/api-reference/http/management/get-client-package-upload) | `GET /v1/management/games/{gameId}/builds/{buildId}/client-packages/{uploadId}` | Bearer token |
| [Recover a Game's publications and exported client pack checks](/api-reference/http/management/list-build-publications) | `GET /v1/management/games/{gameId}/build-publications` | Bearer token |
| [Begin a Build from an exported game or from project source](/api-reference/http/management/create-build-publication) | `POST /v1/management/games/{gameId}/build-publications` | Bearer token |
| [Read a publication, its progress and its exported client pack checks](/api-reference/http/management/get-build-publication) | `GET /v1/management/games/{gameId}/build-publications/{publicationId}` | Bearer token |
| [Open the publication's upload](/api-reference/http/management/begin-build-publication-upload) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:source-upload` | Bearer token |
| [Grant writes for an exported game's upload parts](/api-reference/http/management/sign-build-publication-parts) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:signParts` | Bearer token |
| [Seal the upload and accept it](/api-reference/http/management/complete-build-publication-source) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:source-complete` | Bearer token |
| [Approve the preview Build](/api-reference/http/management/publish-build-publication) | `POST /v1/management/games/{gameId}/build-publications/{publicationId}:publish` | Bearer token |
| [List creator game tags](/api-reference/http/management/list-creator-game-tags) | `GET /v1/management/game-tags` | Bearer token |
| [List release drafts](/api-reference/http/management/list-release-drafts) | `GET /v1/management/games/{gameId}/environments/{envId}/release-drafts` | Bearer token |
| [Create release draft](/api-reference/http/management/create-release-draft) | `POST /v1/management/games/{gameId}/environments/{envId}/release-drafts` | Bearer token |
| [Get release draft](/api-reference/http/management/get-release-draft) | `GET /v1/management/games/{gameId}/environments/{envId}/release-drafts/{draftId}` | Bearer token |
| [Publish coordinated release](/api-reference/http/management/publish-coordinated-release) | `POST /v1/management/games/{gameId}/environments/{envId}/release-drafts/{draftId}:publish` | Bearer token |
| [List game builds](/api-reference/http/management/list-game-builds) | `GET /v1/management/games/{gameId}/builds` | Bearer token |
| [Get game build](/api-reference/http/management/get-game-build) | `GET /v1/management/games/{gameId}/builds/{buildId}` | Bearer token |
| [List creator games](/api-reference/http/management/list-creator-games) | `GET /v1/management/games` | Bearer token |
| [Create creator game](/api-reference/http/management/create-creator-game) | `POST /v1/management/games` | Bearer token |
| [Get creator game](/api-reference/http/management/get-creator-game) | `GET /v1/management/games/{gameId}` | Bearer token |
| [List game revisions](/api-reference/http/management/list-game-revisions) | `GET /v1/management/games/{gameId}/revisions` | Bearer token |
| [Fork game revision](/api-reference/http/management/fork-game-revision) | `POST /v1/management/games/{gameId}/revisions` | Bearer token |
| [Get game approval](/api-reference/http/management/get-game-approval) | `GET /v1/management/games/{gameId}/approval` | Bearer token |
| [Get game revision](/api-reference/http/management/get-game-revision) | `GET /v1/management/games/{gameId}/revisions/{revisionId}` | Bearer token |
| [Patch game revision](/api-reference/http/management/patch-game-revision) | `PATCH /v1/management/games/{gameId}/revisions/{revisionId}` | Bearer token |
| [Preview game revision](/api-reference/http/management/preview-game-revision) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/preview` | Bearer token |
| [List game revision preview links](/api-reference/http/management/list-game-revision-preview-links) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/preview-links` | Bearer token |
| [Create game revision preview link](/api-reference/http/management/create-game-revision-preview-link) | `POST /v1/management/games/{gameId}/revisions/{revisionId}/preview-links` | Bearer token |
| [Get game revision verification](/api-reference/http/management/get-game-revision-verification) | `GET /v1/management/games/{gameId}/revisions/{revisionId}/verification` | Bearer token |
| [Submit game revision](/api-reference/http/management/submit-game-revision) | `POST /v1/management/games/{gameId}/revisions/{revisionId}:submit` | Bearer token |
| [List owner approvals](/api-reference/http/management/list-owner-approvals) | `GET /v1/management/games/{gameId}/owner-approvals` | Bearer token |
| [Get owner approval](/api-reference/http/management/get-owner-approval) | `GET /v1/management/games/{gameId}/owner-approvals/{approvalId}` | Bearer token |
| [Cancel owner approval](/api-reference/http/management/cancel-owner-approval) | `POST /v1/management/games/{gameId}/owner-approvals/{approvalId}:cancel` | Bearer token |
| [Publish game revision](/api-reference/http/management/publish-game-revision) | `POST /v1/management/games/{gameId}/revisions/{revisionId}:publish` | Bearer token |
| [Get storefront live](/api-reference/http/management/get-storefront-live) | `GET /v1/management/games/{gameId}/storefront/live` | Bearer token |
| [Get game store interest](/api-reference/http/management/get-game-store-interest) | `GET /v1/management/games/{gameId}/store/interest` | Bearer token |
| [Get game price](/api-reference/http/management/get-game-price) | `GET /v1/management/games/{gameId}/price` | Bearer token |
| [Begin media upload](/api-reference/http/management/begin-media-upload) | `POST /v1/management/media-assets:begin-upload` | Bearer token |
| [Get media asset](/api-reference/http/management/get-media-asset) | `GET /v1/management/media-assets/{assetId}` | Bearer token |
| [Complete media upload](/api-reference/http/management/complete-media-upload) | `POST /v1/management/media-assets/{assetId}:complete` | Bearer token |
| [Preview media asset](/api-reference/http/management/preview-media-asset) | `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](/api-reference/http/analytics/get-game-activity-overview) | `GET /v1/management/games/{gameId}/environments/{envId}/analytics/activity` | Bearer token |
| [Discover observed event and property names](/api-reference/http/analytics/get-analytics-catalog) | `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)](/api-reference/http/player/get-o-auth-authorization-server-metadata) | `GET /.well-known/oauth-authorization-server` | None |
| [Register a player MCP client (RFC 7591)](/api-reference/http/player/register-o-auth-client) | `POST /v1/oauth/register` | None |
| [Exchange a code or refresh token for a player MCP access token](/api-reference/http/player/exchange-o-auth-token) | `POST /v1/oauth/token` | None |
| [Read the collected lifetime Play total for a public Game](/api-reference/http/player/read-public-play-total) | `GET /v1/store/games/{gameId}/play-total` | None |
| [Get player profile](/api-reference/http/player/get-player-profile) | `GET /v1/identity/me/profile` | Bearer token |
| [Update player profile](/api-reference/http/player/update-player-profile) | `PATCH /v1/identity/me/profile` | Bearer token |
| [Get player preferences](/api-reference/http/player/get-player-preferences) | `GET /v1/identity/me/preferences` | Bearer token |
| [Replace player preferences](/api-reference/http/player/replace-player-preferences) | `PUT /v1/identity/me/preferences` | Bearer token |
| [Browse games](/api-reference/http/player/browse-games) | `GET /v1/store/games` | None |
| [Get published game](/api-reference/http/player/get-published-game) | `GET /v1/store/games/{gameId}` | None |
| [Get published game image](/api-reference/http/player/get-published-game-image) | `GET /v1/store/games/{gameId}/publications/{publicationId}/images/{assetId}` | None |
| [Get published game image variant](/api-reference/http/player/get-published-game-image-variant) | `GET /v1/store/games/{gameId}/publications/{publicationId}/images/{assetId}/variants/{size}` | None |
| [Get published item image](/api-reference/http/player/get-published-item-image) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/images/{assetId}` | None |
| [Get published item image variant](/api-reference/http/player/get-published-item-image-variant) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/images/{assetId}/variants/{size}` | None |
| [Get published game model](/api-reference/http/player/get-published-game-model) | `GET /v1/store/games/{gameId}/publications/{publicationId}/models/{assetId}` | None |
| [Get published item model](/api-reference/http/player/get-published-item-model) | `GET /v1/games/{gameId}/store/items/{itemId}/publications/{publicationId}/models/{assetId}` | None |
| [List game updates](/api-reference/http/player/list-game-updates) | `GET /v1/store/games/{gameId}/updates` | None |
| [Get game update](/api-reference/http/player/get-game-update) | `GET /v1/store/games/{gameId}/updates/{activationId}` | None |
| [List published store items](/api-reference/http/player/list-published-store-items) | `GET /v1/store/items` | None |
| [List published game items](/api-reference/http/player/list-published-game-items) | `GET /v1/games/{gameId}/store/items` | None |
| [Get published item](/api-reference/http/player/get-published-item) | `GET /v1/games/{gameId}/store/items/{itemId}` | None |
| [List game tags](/api-reference/http/player/list-game-tags) | `GET /v1/store/tags` | None |
| [List featured games](/api-reference/http/player/list-featured-games) | `GET /v1/store/featured` | None |


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