PcoWSkbVqDnWTu_dm2ix
The Developer Hub is now deprecated and information on this page may no longer be accurate. To see our new and improved documentation, please click here. You can read more about the future of documentation here.
Collapse Sidebar
  1. Learn Roblox
  2. OPEN CLOUD

Place Management API Reference

Hide content
  1. Learn Roblox
  2. OPEN CLOUD

Place Management API Reference

10 min

This document describes the request and response payloads that you’ll send and receive to the Place Management API.

Request

Signature / URL 
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 
curl  --location --request POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
	--header 'x-api-key: abc...' \
	--header 'Content-Type: application/xml' \
	--data-raw ''

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.