---
title: "Update Universe"
method: PATCH
path: "/cloud/v2/universes/{universe_id}"
tags: ["Universes"]
---

# Update Universe

`PATCH /cloud/v2/universes/{universe_id}`

Updates the specified universe.

This method is guaranteed to return all updated fields.
This method may additionally return the full resource.

## Path parameters

- `universe_id` string, required

## Query parameters

- `updateMask` string, field-mask

## Request body

- Universe — Represents a Roblox experience.
  - `path` string — The resource path of the universe. Format: `universes/{universe_id}`
  - `createTime` string, date-time — The timestamp when the universe was created.
  - `updateTime` string, date-time — The timestamp when the universe was last updated.
  - `displayName` string — The name of the universe. This field can be updated by updating the root place's name.
  - `description` string — The description of the universe. This field can be updated by updating the root place's description.
  - `user` string — The universe is user-owned.
  - `group` string — The universe is group-owned.
  - `visibility` 'VISIBILITY_UNSPECIFIED' | 'PUBLIC' | 'PRIVATE', enum — Whether or not the universe is publicly accessible. Possible values: | Value | Description | | --- | --- | | VISIBILITY_UNSPECIFIED | Updates using this value will throw an error on the backend. | | PUBLIC | The universe is public. | | PRIVATE | The universe is private. If a universe's visibility is set to PRIVATE, all active players will immediately be removed from all running servers. |
  - `facebookSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `twitterSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `youtubeSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `twitchSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `discordSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `robloxGroupSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `guildedSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `voiceChatEnabled` boolean — Whether or not voice chat is enabled for users in the Experience. Updating this value will not affect active servers.
  - `ageRating` 'AGE_RATING_UNSPECIFIED' | 'AGE_RATING_ALL' | 'AGE_RATING_9_PLUS' | 'AGE_RATING_13_PLUS' | 'AGE_RATING_17_PLUS', enum — The age rating of this universe. Possible values: | Value | Description | | --- | --- | | AGE_RATING_UNSPECIFIED | The age rating is not set. | | AGE_RATING_ALL | Supported for all users. | | AGE_RATING_9_PLUS | Supported for users aged 9 and up. | | AGE_RATING_13_PLUS | Supported for users aged 13 and up. | | AGE_RATING_17_PLUS | Supported for users aged 17 and up. |
  - `privateServerPriceRobux` integer — Represents the price in Robux of private servers. If unset, private servers are not supported for this universe. Can only be disabled when using a field mask. Setting to null will disable all active private servers. Changing the price will cancel all private server subscriptions.
  - `desktopEnabled` boolean — Whether or not players can join the Experience via Desktop.
  - `mobileEnabled` boolean — Whether or not players can join the Experience via Mobile.
  - `tabletEnabled` boolean — Whether or not players can join the Experience via Tablet.
  - `consoleEnabled` boolean — Whether or not players can join the Experience via Console.
  - `vrEnabled` boolean — Whether or not players can join the Experience via VR.
  - `rootPlace` string — The resource path of the root place of this universe Format: universes/{universe_id}/places/{place_id}
  - `templateRootPlace` string, required — The resource path of the template place, used for CreateUniverse. The root place of the newly-created universe will be a clone of this template. A list of the valid template places can be obtained from ListTemplatePlaces. Format: universes/{universe_id}/places/{place_id}

## Response `200`

OK

- Universe — Represents a Roblox experience.
  - `path` string — The resource path of the universe. Format: `universes/{universe_id}`
  - `createTime` string, date-time — The timestamp when the universe was created.
  - `updateTime` string, date-time — The timestamp when the universe was last updated.
  - `displayName` string — The name of the universe. This field can be updated by updating the root place's name.
  - `description` string — The description of the universe. This field can be updated by updating the root place's description.
  - `user` string — The universe is user-owned.
  - `group` string — The universe is group-owned.
  - `visibility` 'VISIBILITY_UNSPECIFIED' | 'PUBLIC' | 'PRIVATE', enum — Whether or not the universe is publicly accessible. Possible values: | Value | Description | | --- | --- | | VISIBILITY_UNSPECIFIED | Updates using this value will throw an error on the backend. | | PUBLIC | The universe is public. | | PRIVATE | The universe is private. If a universe's visibility is set to PRIVATE, all active players will immediately be removed from all running servers. |
  - `facebookSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `twitterSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `youtubeSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `twitchSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `discordSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `robloxGroupSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `guildedSocialLink` UniverseSocialLink — A social link that may be associated with the universe. Can only be removed when using a field mask.
    - `title` string — The title of the social link.
    - `uri` string — The uri of the social link.
  - `voiceChatEnabled` boolean — Whether or not voice chat is enabled for users in the Experience. Updating this value will not affect active servers.
  - `ageRating` 'AGE_RATING_UNSPECIFIED' | 'AGE_RATING_ALL' | 'AGE_RATING_9_PLUS' | 'AGE_RATING_13_PLUS' | 'AGE_RATING_17_PLUS', enum — The age rating of this universe. Possible values: | Value | Description | | --- | --- | | AGE_RATING_UNSPECIFIED | The age rating is not set. | | AGE_RATING_ALL | Supported for all users. | | AGE_RATING_9_PLUS | Supported for users aged 9 and up. | | AGE_RATING_13_PLUS | Supported for users aged 13 and up. | | AGE_RATING_17_PLUS | Supported for users aged 17 and up. |
  - `privateServerPriceRobux` integer — Represents the price in Robux of private servers. If unset, private servers are not supported for this universe. Can only be disabled when using a field mask. Setting to null will disable all active private servers. Changing the price will cancel all private server subscriptions.
  - `desktopEnabled` boolean — Whether or not players can join the Experience via Desktop.
  - `mobileEnabled` boolean — Whether or not players can join the Experience via Mobile.
  - `tabletEnabled` boolean — Whether or not players can join the Experience via Tablet.
  - `consoleEnabled` boolean — Whether or not players can join the Experience via Console.
  - `vrEnabled` boolean — Whether or not players can join the Experience via VR.
  - `rootPlace` string — The resource path of the root place of this universe Format: universes/{universe_id}/places/{place_id}
  - `templateRootPlace` string, required — The resource path of the template place, used for CreateUniverse. The root place of the newly-created universe will be a clone of this template. A list of the valid template places can be obtained from ListTemplatePlaces. Format: universes/{universe_id}/places/{place_id}

---

[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/756260310407/schema)