Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.
PATCH /cloud/v2/universes/{universe_id} — cloud.docs
Update Universe
Updates the specified universe.
This method is guaranteed to return all updated fields. This method may additionally return the full resource.
Endpoint
Method: PATCH
Path: /cloud/v2/universes/{universe_id}
Servers:
https://apis.roblox.com
Parameters
| Name | Location | Required | Description |
|---|---|---|---|
| universe_id | path | true | The universe ID. |
| updateMask | query | false | The list of fields to update. |
[
{
"name": "universe_id",
"in": "path",
"description": "The universe ID.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "updateMask",
"in": "query",
"description": "The list of fields to update.",
"schema": {
"type": "string",
"format": "field-mask"
}
}
] Request Body
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Universe"
}
}
},
"required": true
} Responses
| Status | Description |
|---|---|
| 200 | OK |
{
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Universe"
}
}
}
}
} Authentication
{
"security": [],
"securitySchemes": {}
} Related Schemas
Complete Operation Definition
{
"tags": [
"Cloud"
],
"summary": "Update Universe",
"description": "Updates the specified universe.\n\nThis method is guaranteed to return all updated fields.\nThis method may additionally return the full resource.",
"operationId": "Cloud_UpdateUniverse",
"parameters": [
{
"name": "universe_id",
"in": "path",
"description": "The universe ID.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "updateMask",
"in": "query",
"description": "The list of fields to update.",
"schema": {
"type": "string",
"format": "field-mask"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Universe"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Universe"
}
}
}
}
},
"x-visibility": "STABLE",
"x-roblox-engine-usability": {
"apiKeyWithHttpService": false
},
"x-roblox-scopes": [
{
"name": "universe:write"
}
],
"x-roblox-docs": {
"category": "Universes and places",
"methodProperties": {
"scopes": [
"universe:write"
]
},
"resource": {
"$ref": "#/components/schemas/Universe",
"name": "Universe"
}
}
}