Away 8:45 PM

3 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

PATCH /v2/places/{placeId} — openapi

Updates the place configuration for the place with the id placeId

Endpoint

Method: PATCH

Path: /v2/places/{placeId}

Servers:

Parameters

NameLocationRequiredDescription
placeIdpathtrueThe place id for the place to be updated.
 
[
  {
    "in": "path",
    "name": "placeId",
    "description": "The place id for the place to be updated.",
    "required": true,
    "schema": {
      "type": "integer",
      "format": "int64"
    }
  }
]

Request Body

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceConfigurationModelV2"
      }
    },
    "text/json": {
      "schema": {
        "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceConfigurationModelV2"
      }
    }
  },
  "required": true
}

Responses

StatusDescription
200OK
4010: Authorization has been denied for this request.
403Authenticated user is not authorized to manage this place. 0: Token Validation Failed
404placeId Place not found.
 
{
  "200": {
    "description": "OK",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceModelV2"
        }
      },
      "text/json": {
        "schema": {
          "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceModelV2"
        }
      }
    }
  },
  "401": {
    "description": "0: Authorization has been denied for this request."
  },
  "403": {
    "description": "Authenticated user is not authorized to manage this place.\r\n0: Token Validation Failed"
  },
  "404": {
    "description": "placeId Place not found."
  }
}

Authentication

{
  "security": [
    {
      "roblox-legacy-cookie": []
    }
  ],
  "securitySchemes": {
    "roblox-api-key": {
      "type": "apiKey",
      "description": "A configurable key that allows granular access to Roblox resources. See https://create.roblox.com/docs/cloud/auth/api-keys for more information.",
      "name": "x-api-key",
      "in": "header"
    },
    "roblox-legacy-cookie": {
      "type": "apiKey",
      "description": "A browser cookie that represents the identity of a Roblox user. DO NOT SHARE THIS. Sharing this will allow someone to log in as you and to steal your Robux and items. We do not recommend using cookies to call endpoints. When possible, use API keys with the x-api-key header or OAuth 2.0 instead for authentication.",
      "in": "cookie",
      "name": ".ROBLOSECURITY"
    },
    "roblox-oauth2": {
      "type": "oauth2",
      "description": "Build or authorize apps to access Roblox resources. See https://create.roblox.com/docs/cloud/auth/oauth2-overview for more information.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://apis.roblox.com/oauth/v1/authorize",
          "tokenUrl": "https://apis.roblox.com/oauth/v1/token",
          "refreshUrl": "https://apis.roblox.com/oauth/v1/token",
          "scopes": {}
        }
      }
    }
  }
}

Complete Operation Definition

{
  "tags": [
    "Places"
  ],
  "summary": "Updates the place configuration for the place with the id placeId",
  "parameters": [
    {
      "in": "path",
      "name": "placeId",
      "description": "The place id for the place to be updated.",
      "required": true,
      "schema": {
        "type": "integer",
        "format": "int64"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceConfigurationModelV2"
        }
      },
      "text/json": {
        "schema": {
          "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceConfigurationModelV2"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceModelV2"
          }
        },
        "text/json": {
          "schema": {
            "$ref": "#/components/schemas/Roblox.Api.Develop.Models.PlaceModelV2"
          }
        }
      }
    },
    "401": {
      "description": "0: Authorization has been denied for this request."
    },
    "403": {
      "description": "Authenticated user is not authorized to manage this place.\r\n0: Token Validation Failed"
    },
    "404": {
      "description": "placeId Place not found."
    }
  },
  "servers": [
    {
      "url": "https://develop.roblox.com"
    }
  ],
  "x-roblox-stability": "EXPERIMENTAL",
  "x-roblox-engine-usability": {
    "apiKeyWithHttpService": false
  },
  "security": [
    {
      "roblox-legacy-cookie": []
    }
  ],
  "externalDocs": {
    "url": "https://create.roblox.com/docs/cloud/reference/features/places#develop_patch_v2_places__placeId_"
  }
}