--- title: "Update universe settings for an owned universe." method: PATCH path: "/v1/universes/{universeId}/configuration" tags: ["Universes"] --- # Update universe settings for an owned universe. `PATCH /v1/universes/{universeId}/configuration` ## Path parameters - `universeId` integer, required ## Request body - RobloxApiDevelopModelsUniverseSettingsRequest — Model for UniverseSettings patch requests - `name` string — The name of the universe. - `universeAvatarType` 1 | 2 | 3 — Which avatar types are allowed in the universe. - `universeScaleType` 1 | 2 — Whether custom scales allowed in the universe. - `universeAnimationType` 1 | 2 — Whether custom animations are allowed in the universe. - `universeCollisionType` 1 | 2 — What type of collisions are used by the universe. - `universeBodyType` 1 | 2 — What avatar body types are allowed by the universe. - `universeJointPositioningType` 1 | 2 — What avatar joint positioning type is allowed by the universe. - `isArchived` boolean — Archive status of the universe. - `isFriendsOnly` boolean — Whether game access is limited to friends for user-owned games or group members for group-owned games. - `genre` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 — Game genre. - `playableDevices` integer[] — List of device types this game can be played on. - `isForSale` boolean — Whether the game is offered for sale. - `price` integer — Price of the game, in Robux. - `isMeshTextureApiAccessAllowed` boolean — Sets whether access to APIs for mesh and texture is enabled for this universe. - `isRewardedOnDemandAdsAllowed` boolean — Set is rewarded on-demand ads are allowed for this universe. - `fiatBasePriceId` string — Sets the base price of the experience for Fiat purchases. - `fiatProductChangeType` 0 | 1 | 2 | 3 — Determines the change type of the Fiat Product Change request. Can either Activate the product, Update the price, or Deactivate the product. - `demoModeEnabled` boolean — Whether demo mode is enabled for this paid access game. ## Response `200` OK - RobloxApiDevelopModelsUniverseSettingsResponse — Model for UniverseSettings controller responses - `allowPrivateServers` boolean — If the universe allows the use of private servers. - `privateServerPrice` integer — The price to purchase a private server in robux. - `isMeshTextureApiAccessAllowed` boolean — Whether access to APIs for mesh and texture is enabled for this universe. - `isRewardedOnDemandAdsAllowed` boolean — Whether rewarded on-demand ads are allowed for this universe. - `id` integer — The universe Id. - `name` string — The universe name. - `universeAvatarType` 1 | 2 | 3 — Which avatar types are allowed in the universe. ['MorphToR6' = 1, 'PlayerChoice' = 2, 'MorphToR15' = 3] - `universeScaleType` 1 | 2 — Whether custom scales allowed in the universe. ['NoScales' = 1, 'AllScales' = 2] - `universeAnimationType` 1 | 2 — Whether custom animations are allowed in the universe. ['Standard' = 1, 'PlayerChoice' = 2] - `universeCollisionType` 1 | 2 — What type of collisions are used by the universe. ['InnerBox' = 1, 'OuterBox' = 2] - `universeBodyType` 1 | 2 — What avatar body types are allowed by the universe. ['Standard' = 1, 'PlayerChoice' = 2] - `universeJointPositioningType` 1 | 2 — What avatar joint positioning is allowed by the universe. ['Standard' = 1, 'ArtistIntent' = 2] - `isArchived` boolean — Archive status of the universe - `isFriendsOnly` boolean — Whether game access is limited to friends for user-owned games or group members for group-owned games. - `genre` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 — Game genre. ['All' = 0, 'Tutorial' = 1, 'Scary' = 2, 'TownAndCity' = 3, 'War' = 4, 'Funny' = 5, 'Fantasy' = 6, 'Adventure' = 7, 'SciFi' = 8, 'Pirate' = 9, 'FPS' = 10, 'RPG' = 11, 'Sports' = 12, 'Ninja' = 13, 'WildWest' = 14] - `playableDevices` integer[] — List of device types this game can be played on. - `isForSale` boolean — Whether the game is offered for sale. - `price` integer — Price of the game, in Robux. - `isStudioAccessToApisAllowed` boolean — Whether studio access to APIs is allowed or not. - `privacyType` string — Privacy type of the universe. - `isForSaleInFiat` boolean — Whether the game is offered for sale in fiat. - `fiatBasePriceId` string — The basePriceId for the Fiat product. - `fiatModerationStatus` 0 | 1 | 2 | 3 | 4 — The current moderation status of the game if it is for sale in fiat. ['Invalid' = 0, 'NotModerated' = 1, 'Pending' = 2, 'Approved' = 3, 'Rejected' = 4] - `audiences` integer[] — The audiences this universe is visible to (e.g. Editors, PlayTesters, Friends, Public). Always non-null; may be empty when audience visibility has not been configured. - `demoModeEnabled` boolean — Whether demo mode is enabled. - `demoModeChangeableAfter` string, date-time — The earliest time at which demo mode can be toggled again (ISO 8601). Null when no cooldown is active (i.e. demo mode can be changed immediately). ## Other responses - `400` — 1: The universe does not exist. 3: Invalid UniverseAvatarType. 4: Invalid UniverseScaleType. 5: Invalid UniverseAnimationType. 6: Invalid UniverseCollisionType. 7: New universe name or description has been rejected. 8: New universe name is too long. 10: Invalid UniverseBodyType. 11: Invalid UniverseJointPositioningType. 12: The universe has no root place. 15: Price is required when isForSale is true. 16: This game cannot be offered for sale because it is not public. 17: This game cannot be offered for sale because it has private servers enabled. 18: The game price is outside of the allowed range. 19: Invalid genre. 20: The request body is missing. 21: Invalid device type. 22: Invalid asset type. 23: Invalid value, the min must be less than or equal to the max 24: Invalid scale value 41: You cannot change the private server price again so soon after the previous change. Please try again later. - `401` — 0: Authorization has been denied for this request. - `403` — 0: Token Validation Failed 2: You are not authorized to configure this universe. 14: You are not authorized to sell games. - `409` — 9: Failed to shutdown all intances of game after changing AvatarType. The change has been reverted. --- [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)