---
title: "Restart Universe Servers"
method: POST
path: "/cloud/v2/universes/{universe_id}:restartServers"
tags: ["Universes"]
---

# Restart Universe Servers

`POST /cloud/v2/universes/{universe_id}:restartServers`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/cloud/v2/universes/{universe_id}:restartServers`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `universe:write`

Restarts active servers for a specific universe. Defaults to only
restarting servers running older versions, but can be configured to restart
all servers regardless of version. Used for releasing experience updates.

## Path parameters

- `universe_id` string, required

## Request body

- RestartUniverseServersRequest: Restarts all of the universe's servers.
  - `placeIds` integer[]: The place IDs to update. If none are specified, all active places in the universe will be updated.
  - `closeAllVersions` boolean: If true, players from servers running both old and new place versions will be restarted. If false, restarts all active servers for a specific universe if and only if a new version of the experience has been published.
  - `bleedOffServers` boolean: If true, matchmaking to servers will stop, but servers will stay up for bleed_off_duration_minutes before shutting down. This setting gives players time to naturally migrate to the newer version. If false, servers will immediately start shutting down.
  - `bleedOffDurationMinutes` integer: If bleed_off_servers is true, how long (in minutes) old servers are allowed to stay up before shutting them down. Valid values: 1-60 minutes.

## Response `200`

OK

- RestartUniverseServersResponse: Empty response. May later contain a status.

## Changes

- **2026-10-20** `93616db823f3`: 1 info
  - the security scope `universe:write` was added to the endpoint's security scheme `roblox-oauth2`

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/cloud/v2/universes/:universe_id:restartServers/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/bcfdc20689cd?raw)