---
title: "Forecast the outcome of launching an update"
method: POST
path: "/matchmaking-api/v1/game-instances/forecast-update"
tags: ["Matchmaking"]
---

# Forecast the outcome of launching an update

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

## Request body

- ForecastUpdateRequest — ForecastUpdateRequest is used to request an update to the forecast of a Place in a Universe.
  - `universeId` integer — The Universe ID to update.

## Response `200`

Success

- ForecastUpdateResponse — ForecastUpdateResponse is used to return information about the forecasted update of a place.
  - `placeSummaries` PlaceSummaryForGameUpdate[], nullable
    - `placeId` integer — Place ID of the place to be updated.
    - `playersToBeKicked` integer — Number of players to be kicked from the place during the game update.
    - `totalPlayers` integer — Total number of players in the place.
    - `instancesToBeClosed` integer — Number of instances to be closed for the place during the game update.
    - `totalInstances` integer — Total number of instances for the place.
    - `placeVersion` integer — Lastest version of the place to be updated.
    - `lastUpdated` string, date-time — The timestamp of the last update to the place summary.
    - `isInUniverse` boolean — Indicates whether the place is still part of the universe. A place may have active games but is no longer in the universe if it has been removed from the universe.
    - `versionToPlayerCounts` object, nullable — Player counts broken down by place version. Key is the place version, value is the number of players on that version.
    - `versionToInstanceCounts` object, nullable — Instance counts broken down by place version. Key is the place version, value is the number of instances on that version.

---

[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/revisions/958b2b40425d/schema)