Universes (v1)

OpenCloud v1 reference for Universes.

Base URL: https://apis.roblox.com/universes

Endpoints

Method	Path	Name
POST	/v1/:universeId/places/:placeId/versions	postUniverseIdPlacesPlaceIdVersions

postUniverseIdPlacesPlaceIdVersions

POST /v1/:universeId/places/:placeId/versions

Publish a new place or update an existing place with a new version. Provide a RBXL or RBXLX file in the data-binary.

Scopes: universe-places:write

Usage

import { fetchApi } from 'rozod';
import { postUniverseIdPlacesPlaceIdVersions } from 'rozod/lib/opencloud/v1/universes';

const data = await fetchApi(postUniverseIdPlacesPlaceIdVersions, {
  universeId: /* integer */,
  placeId: /* integer */,
  versionType: /* string \| null? */
});

Parameters

Name	Type	Required	Description
universeId	integer	Yes	The identifier of the experience in which you want to publish your place to. You can copy your experience’s Universe ID on Creator Dashboard .
placeId	integer	Yes	The identifier of your place. See Publishing places with API keys on obtaining a Place ID.
versionType	string | null?	No	Can only be either: - Saved: the place file should be saved, but not published. - Published: the place file should be saved and published.

Response

Type: unknown

Errors

Status	Description
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.

---