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

# Update Universe

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

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/cloud/v2/universes/{universeId}`
- 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`

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

## Path parameters

- `universeId` string, required

## Query parameters

- `updateMask` string

## Request body

- OpenCloudUniversesServiceUniverse: 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': Represents whether or not the Universe is publicly accessible.
  - `facebookSocialLink` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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': Supported age ratings for the universe. This field is read only.
  - `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

- OpenCloudUniversesServiceUniverse: 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': Represents whether or not the Universe is publicly accessible.
  - `facebookSocialLink` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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` OpenCloudUniversesServiceUniverseSocialLink: 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': Supported age ratings for the universe. This field is read only.
  - `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.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/e1e00fbc18e5?raw)
