---
title: "Launch a game update"
method: POST
path: "/matchmaking-api/v1/game-instances/launch-update"
tags: ["Matchmaking"]
---

# Launch a game update

`POST /matchmaking-api/v1/game-instances/launch-update`

## Request body

- LaunchUpdateRequest — Launch Update Request. Contains specification for how update should roll out
  - `universeId` integer — The Universe ID to update.
  - `placeIds` integer[], nullable — The place IDs to update. If none are specified, we will update all active Places in the Universe
  - `closeOldVersionsOnly` boolean — If true (default in UI), we will only migrate players from servers running old PlaceVersions. If false, we will migrate all players
  - `bleedOffServers` boolean — If true (default in UI), we will stop matchmaking to servers but keep them up before shutting them down, allowing players to naturally migrate to the newer version. If false, we will immediately start shutting down servers
  - `bleedOffDurationMinutes` integer — If BleedOffServers=true, how long will we allow old servers to stay up before shutting them down. Valid values: 1 - 60 minutes
  - `placeIdToVersions` object, nullable — Optional. A mapping of PlaceId to the specific versions to restart/bleed off for that place. When set for a place, only servers running those exact versions will be affected. If a place is not in this dictionary or has an empty set, behavior falls back to CloseOldVersionsOnly logic.
  - `attributes` string, nullable — Optional. Attributes string to include in the ServerLifecycleChanged CSM payload published to game servers.

## Response `200`

Success

- LaunchUpdateResponse — Launch Update response.
  - `updateId` string, uuid — An ID for UI to query status of this update
  - `numPlayersToBeKicked` integer — How many players are playing in servers that will be shut down according to the update configuration
  - `instancesToBeClosed` integer — How many game instances will be closed according to the update configuration

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)