Place Publishing API

You can send and receive the following request and response payloads to Place Publishing API of Open Cloud. For information on the usage of the API, see Publishing Places with API Keys.

Request

Signature / URL POST https://apis.roblox.com/universes/v1/{universeId}/places{placeId}/versions
Params

versionType:

  • Saved - The place file should be saved, but not published.
  • Published - The place file should be saved and published.
Throttle Limit 10 requests per minute per API Key/IP
Size Limit 100MB
Sample Code

1curl \
2 --location --request POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
3 --header 'x-api-key: abc...' \
4 --header 'Content-Type: application/xml' \
5 --data-raw '<roblox></roblox>'
6

Response

Format {"versionNumber":7} -- Indicates the latest version that was saved and/or publishedResponses
Sample Code {"versionNumber":7}

Error Codes

If an error occurs, reference the following table for context on how to solve the error:

Error Code Error Message
400 Invalid request / Invalid file content.
401 API key not valid for operation, user does not have authorization.
403 Publish not allowed on place.
404 Place or universe does not exist.
409 Place not part of the universe.
500 Server internal error / Unknown error.