Universe

Attributes

pathstring
createTimestring
Output Only
updateTimestring
Output Only
displayNamestring
Output Only
descriptionstring
Output Only

One of the following for owner:

userstring
Output Only
groupstring
Output Only
visibilityEnum<string>
Output Only
facebookSocialLinkobject
twitterSocialLinkobject
youtubeSocialLinkobject
twitchSocialLinkobject
discordSocialLinkobject
robloxGroupSocialLinkobject
guildedSocialLinkobject
voiceChatEnabledboolean
ageRatingEnum<string>
Output Only
privateServerPriceRobuxnumber
desktopEnabledboolean
mobileEnabledboolean
tabletEnabledboolean
consoleEnabledboolean
vrEnabledboolean
Base URL
https://apis.roblox.com
The Universe Resource
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Get Universe

GET /cloud/v2/universes/{universe_id}
RequestPath Parameters
universe_idstring
Required
ResponseUniverse
GET /cloud/v2/universes/{universe_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}' \

  -H 'x-api-key: {your-api-key}'
Response
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Update Universe

PATCH /cloud/v2/universes/{universe_id}
Scopes
universe:write
RequestPath Parameters
universe_idstring
Required
Query Parameters
updateMaskstring
Request BodyUniverse
ResponseUniverse
PATCH /cloud/v2/universes/{universe_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}?updateMask={string}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}'
Response
{

  "path": "universes/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "displayName": "ROBLOX Battle [OPEN]",

  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",

  "user": "string",

  "visibility": "VISIBILITY_UNSPECIFIED",

  "facebookSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitterSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "youtubeSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "twitchSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "discordSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "robloxGroupSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "guildedSocialLink": {

    "title": "string",

    "uri": "string"

  },

  "voiceChatEnabled": true,

  "ageRating": "AGE_RATING_UNSPECIFIED",

  "privateServerPriceRobux": "integer",

  "desktopEnabled": true,

  "mobileEnabled": true,

  "tabletEnabled": true,

  "consoleEnabled": true,

  "vrEnabled": true

}

Universe

Publish Universe Message
Beta

POST /cloud/v2/universes/{universe_id}:publishMessage
Scopes
universe-messaging-service:publish
RequestPath Parameters
universe_idstring
Required
Request Body
topicstring
messagestring
POST /cloud/v2/universes/{universe_id}:publishMessage
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:publishMessage' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "topic": "my-topic",

  "message": "Hello, world!"

}'

Universe

Restart Universe Servers

POST /cloud/v2/universes/{universe_id}:restartServers
Scopes
universe:write
RequestPath Parameters
universe_idstring
Required
Request Body
Response
POST /cloud/v2/universes/{universe_id}:restartServers
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:restartServers' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{}'
Response
{}