Changelog

What has changed in the platform API, newest first. See Versioning for what each kind of change means for your client.

November 2026: platforms and cross-play

Added, so nothing a client already does changes:

  • GET /players/:playerId/platform says where a player last signed in from (pc, playstation, xbox, switch, android, ios, other), the accounts at other networks their EOS sign-ins came through, and their cross-play. PUT /players/:playerId/crossplay sets their choice. A player with cross-play off is seated only beside players on their own platform: a join it does not allow is refused with conflict and details.lobby gm.party.crossplay-refused. Session answers gain crossplayOpen, and each seat platform.
  • PUT /players/me/platform-claims reports what the player's console lets them do (text, voice, what other players made, cross-network play); each report holds until the next, due 90 minutes on. PUT /players/me/platform-blocks syncs the console's block list at one named network. Both are the client's report, enforced as a floor.
  • GET and POST /players/me/deletion-request let a player of one of GreenMind's own games ask for their GreenMind account to be deleted, linked or not; a player of any other game is refused with no-greenmind-account.
  • Commerce names playstation and xbox, answered provider-not-configured until those stores can sell here.

October 2026: other names of a map

Added, so nothing a client already does changes:

  • POST /maps/:mapKey/versions takes aliases: other names your sessions and events give the same map, comma separated. Deaths under any of them are drawn over the map's pictures. An upload under a name that is already another map's alias is refused with conflict. See Sessions.

October 2026: monitoring and heat maps

Added, so nothing a client already does changes:

  • POST /sessions/:sessionId/events reports what happened during a match and where: deaths, with their cause, place and time. The console's new Monitoring section counts them and draws them on a heat map. See Sessions.
  • POST /maps/:mapKey/versions uploads a picture of one of your maps, with where the world sits on it, for the heat map to draw over. Upload it from the build machine or editor that draws the map.
  • Plans gain two limits: session events per day, per environment, and map pictures per project.

October 2026: config connectors and column rules

Added, so nothing a client already does changes:

  • GET /.well-known/config-connector-jwks.json, which needs no credential, publishes the keys the platform signs its requests to your backend's config connector with.
  • A config table's columns may be of type enum, reference or json, and may carry rules: description, required, default, min, max, values, table and local, each only when it is set. Every cell is still a string, a number, a boolean or null, and a cell a row leaves unset reads as its column's default where it has one. Treat a column type you do not know as text. See Config and flags.

October 2026: languages

Changed, so a client that buys through the API must change too:

  • POST /commerce/orders takes locale, one of the platform's language codes (en, zh-Hans, es-419 and the rest, as GET /apps/{appKey}/languages lists them), instead of language. Steam is sent its own code for it, and shows the listing's description in that language. A body with language is refused.

Added:

  • GET /apps/:appKey/languages, which needs no credential, lists the languages an environment offers its players: { languages: [{ code, nativeName, englishName }] }, English first.
  • Every answer is in the caller's language. Send Accept-Language with one of the codes above; names, descriptions and other text come back in that language where the environment's content is translated, and in English where it is not. Content-Language says which language was chosen.
  • A skill tree node gains params: the text each {{placeholder}} in its description stands for.

October 2026: whether a player is linked

Added, so nothing a client already does changes:

  • Player gains linked: the player is under a GreenMind account somebody has signed in to. It is always false for a studio's players, who have no GreenMind account; GreenMind's own games read it to decide whether to offer linking. See Players.

October 2026: Patreon supporters

Added, so nothing a client already does changes:

  • An org can connect its Patreon campaign on its Patreon page in the console, and GET /players/:playerId/patreon answers whether a player supports it, with the tiers they are entitled to and whether they show a supporter badge. See Players.

October 2026: Steam names

Added, so nothing a client already does changes unless the project switches it on:

  • A project can name its players by their Steam names, with its own Steam Web API key, entered on the project page. A player who signs in with EOS through Steam gets a steam identity, and a lobby seat of a player with no display name shows their Steam name rather than Player. See Players.

Added, so nothing a client already does changes:

  • A legal document's text can be written in the console and hosted by GreenMind, as versions that are kept as they were published. Its url is then its page on the publishing site. See Other services.
  • GET /legal/documents/:document answers a hosted document's text, at its current version or one named, as Markdown and as HTML safe to show.
  • LegalDocument gains hosted.

October 2026: GreenMind's review of new projects

  • Every new project waits for GreenMind's review before it can use the platform. Until it is approved, every route that acts for one of its environments, and its sign-ins and crash uploads, answer the new refusal 403 project-not-approved, as they do while GreenMind has a project suspended. Projects that existed before are approved, so nothing a client already does changes. See Getting started.
  • The sessions socket closes with the new code 4006 for such a project.

October 2026: custom dashboards

Added, so nothing a client already does changes:

  • Dashboard tokens, a third credential, for a project's custom dashboard: a person signed in with GreenMind, in one environment, reaching only the routes that let a dashboard in, each with a permission checked on every call.
  • POST /auth/dashboard, GET /dashboard/session and GET /players, for dashboards.
  • GET /config/values, GET /config/tables, GET /config/tables/:key and GET /flags take a dashboard token too, for whoever may open a dashboard in the environment.

October 2026: the sessions socket

Lobbies no longer need polling, and no game needs a realtime server of its own for them. See Realtime.

  • The sessions socket: one WebSocket per player's client, following every session the player is seated in. It sends each change as it happens (seat.joined, seat.left, seat.kicked, seat.promoted, seat.ready, session.status), with the session as it now stands; who is connected (presence); and your game's own messages between seats (relay), held to a size and rate per environment. Every frame is JSON in a versioned envelope, { "v": 1, "type", "payload" }.
  • GET /realtime answers where to open the socket, the protocol version, and the limits your plan sets.
  • Seats per session are set per project, in the console, up to what the org's plan allows; they were 4 for every project. Every session now answers its seats, and a full one's conflict carries details.limit.
  • Plans gained the socket's limits and the most seats a session may have: see Realtime.

October 2026: webhooks

  • Webhooks: each environment can have endpoints its events are sent to as they happen, signed with a secret of each endpoint's own. Twelve events to start: player.created, player.deleted, purchase.settled, purchase.refunded, grant.created, crash_group.created, crash_group.regressed, config.promoted, session.ended, support_request.created, legal.accepted and webhook.test. Managed in the console under Live ops, Webhooks, with the new Webhooks permission (manage_webhooks). See Webhooks.
  • GET /openapi.json describes each event in a webhooks section, its body as JSON Schema.
  • Plans gain two limits: webhook endpoints per environment, and deliveries per environment per minute.

October 2026: an explorer, and headers a browser can read

  • The API explorer reads the OpenAPI document and lists every route by area, with its credential, parameters, body schema, an example and its refusals, and sends any of them from your browser with a server key you paste or a test player the console makes outside production.
  • A page's script on another site can read X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After, ETag, Deprecation and Sunset: every answer names them in Access-Control-Expose-Headers. Before, a browser hid them from scripts, so a web client could not see where it stood against the rate limits.
  • The GmPlatform sample, an Unreal Engine project that signs a player in with Epic Online Services and reads and writes through the plugin, is linked from Getting started.

October 2026: v1 settled

The platform API before its first release had grown three ways of refusing, four ways of paging and three ways of acknowledging. This settles v1 as one API. The API had not been released, so these changes were made without deprecation; from here on, v1 changes only as Versioning describes.

Described for programs

  • GET /openapi.json: the whole API as an OpenAPI 3.1 document, made from the same declarations that serve the routes.

One way to refuse

  • Every refusal is { "error", "message", "details"? }, with one list of codes and their statuses (Errors).
  • A validation failure names its field in details.field: body.<field>, query.<name>, path.<name> or header.<name>.
  • A limit on how many of something there may be is quota-exceeded (403), with details.quota and details.limit, where it was conflict: new players and saved bytes past the plan, a player's 5 MB of saves, a licence's seats; and in the console projects, environments, server keys and members.
  • A body over its route's limit is payload-too-large (413), where it was invalid-request.
  • Something not set up or not reachable is unavailable (503): crash reports or symbols with no bucket, a store that cannot be reached. This replaces symbols-not-configured, crash-reports-not-configured and commerce's provider-unavailable.
  • The game services' and commerce's own codes are said the platform's way: invalid and data-too-large are invalid-request; unknown-provider is invalid-request naming query.provider or body.provider; unknown-product and order-not-found are not-found; idempotency-key-reused is idempotency-conflict; too-many-orders and too-many-requests are rate-limited, with Retry-After.
  • A path the API does not have is a JSON not-found.

One way to page

  • Every list takes limit (1 to 200, 50 by default) and an opaque cursor, and answers { "items", "next" }. This replaces the blog's nextCursor (with total, category and tag), the ledger's before, the commerce grants' after, and the crash symbols' truncated; and every list that had no paging, and named its items (configs, tables, flags, documents, tours, entitlements, inventories, decks, tracks, trees, unlocks, stats, realms, currencies, itemTypes and the rest), now has it.
  • The commerce changes feed is its own route, GET /commerce/grants/changes, whose next is never null.
  • GET /crash-symbols/builds is GET /crash-symbols/files: one item per file.
  • What one inventory holds is split by kind: .../items and .../item-stacks, .../cards and .../card-stacks, each with the inventory beside its items.
  • GET /realms lists the open realms; GET /realms/current answers the current one.

One way to answer

  • A single thing is answered as itself: GET /config/tables/:key, GET /players/:playerId/inventories/:inventory and POST /commerce/orders no longer wrap theirs in { "table" }, { "inventory" } and { "order" }.
  • Something done with nothing to say answers 204: leaving a session, finishing a tour, deleting a player, a save slot, a deck or an unlock, releasing a licence. They answered { "left": true }, { "completed": true }, { "deleted": ... } and { "released": ... }.
  • Something made answers 201: a sign-in that makes the player, a save slot written for the first time, an unlock recorded for the first time, an order, and a support request or report, which now answers { "id" } where it answered { "filed": true }.

One way to name paths

Was Is
POST /players/sign-in POST /auth/server
GET /me, PATCH /me GET /players/me, PATCH /players/me
GET /legal/outstanding GET /players/me/legal/outstanding
POST /legal/accept POST /players/me/legal/accept
GET /tours, POST /tours/:tourId/complete GET /players/me/tours, POST /players/me/tours/:tourId/complete
GET /commerce/entitlements[?playerId=] GET /players/:playerId/entitlements
POST /sessions/:id/kick, /promote { playerId } POST /sessions/:id/players/:playerId/kick, /promote
POST /players/:playerId/items/use { itemId } POST /players/:playerId/items/:itemId/use
POST /players/:playerId/items/use { itemTypeKey } POST /players/:playerId/item-stacks/use
POST /players/:playerId/items/consume { itemId } POST /players/:playerId/items/:itemId/consume
POST /players/:playerId/items/consume { itemTypeKey } POST /players/:playerId/item-stacks/consume
POST /players/:playerId/cards/consume { cardId } POST /players/:playerId/cards/:cardId/consume

GET /players/:playerId and PATCH /players/:playerId take a player's token as me, as every /players/:playerId route does.

Rate limits you can see

  • Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and every 429 a Retry-After, including support filings, which promised one and did not send it.
  • The licence routes, the public key sets and requests with a credential that is not good are counted against the address they come from.

Signing out everywhere

  • POST /players/:playerId/sign-out, with a server key or as me, ends every token a player holds, refresh tokens included; and so does the console, from the player's page. A refresh token no longer outlives its player's sign-out.

Faster

  • Server keys and players are checked against a short-lived cache, cleared at once when a key is revoked or a player deleted or signed out.
  • Config values, tables and flags answer with an ETag, and 304 while nothing has changed.
  • Crash uploads are read after the crash reporter is answered, by a worker, not by the API.