Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.
PATCH /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry} — datastores-api/ordered-v1
Updates an entry value and returns the updated entry.
Endpoint
Method: PATCH
Path: /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}
Servers:
https://apis.roblox.com/ordered-data-stores
Parameters
| Name | Location | Required | Description |
|---|---|---|---|
| universeId | path | true | The identifier of the experience with ordered data stores that you want to access. You can find your experience's universe ID on Creator Hub. |
| orderedDataStore | path | true | The name of the ordered data store. |
| scope | path | true | The name of the data store scope. See Scopes. |
| entry | path | true | The entry ID. |
| allow_missing | query | false | The flag to allow the creation of an entry if the entry doesn't exist. See Allow missing flags. |
[
{
"name": "universeId",
"in": "path",
"description": "The identifier of the experience with ordered data stores that you want to access. You can find your experience's universe ID on Creator Hub.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "orderedDataStore",
"in": "path",
"description": "The name of the ordered data store.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "scope",
"in": "path",
"description": "The name of the data store scope. See [Scopes](/cloud/guides/data-stores/request-handling.md#scopes).",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "entry",
"in": "path",
"description": "The entry ID.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "allow_missing",
"in": "query",
"description": "The flag to allow the creation of an entry if the entry doesn't exist. See [Allow missing flags](/cloud/guides/data-stores/request-handling.md.md#allow-missing-flags).",
"schema": {
"type": "boolean"
}
}
]Request Body
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateEntryRequest"
}
}
},
"required": true
}Responses
| Status | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request: invalid orderedDataStore, scope or entry name or encoding. |
| 403 | Forbidden: studio access to APIs is not allowed, incorrect API key or scope. |
| 404 | Not found. |
| 409 | Aborted. |
| 429 | Too Many Requests. |
{
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Entry"
}
}
}
},
"400": {
"description": "Bad Request: invalid orderedDataStore, scope or entry name or encoding."
},
"403": {
"description": "Forbidden: studio access to APIs is not allowed, incorrect API key or scope."
},
"404": {
"description": "Not found."
},
"409": {
"description": "Aborted."
},
"429": {
"description": "Too Many Requests."
}
}Authentication
{
"security": [
{
"roblox-api-key": [
"universe.ordered-data-store.scope.entry:write"
]
}
],
"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.",
"in": "header",
"name": "x-api-key"
}
}
}Related Schemas
Complete Operation Definition
{
"tags": [
"OrderedDataStores"
],
"description": "Updates an entry value and returns the updated entry.",
"operationId": "OrderedDataStores_UpdateEntry",
"x-roblox-cloud-api-operation-name": "Update",
"x-roblox-stability": "BETA",
"parameters": [
{
"name": "universeId",
"in": "path",
"description": "The identifier of the experience with ordered data stores that you want to access. You can find your experience's universe ID on Creator Hub.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "orderedDataStore",
"in": "path",
"description": "The name of the ordered data store.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "scope",
"in": "path",
"description": "The name of the data store scope. See [Scopes](/cloud/guides/data-stores/request-handling.md#scopes).",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "entry",
"in": "path",
"description": "The entry ID.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "allow_missing",
"in": "query",
"description": "The flag to allow the creation of an entry if the entry doesn't exist. See [Allow missing flags](/cloud/guides/data-stores/request-handling.md.md#allow-missing-flags).",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateEntryRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Entry"
}
}
}
},
"400": {
"description": "Bad Request: invalid orderedDataStore, scope or entry name or encoding."
},
"403": {
"description": "Forbidden: studio access to APIs is not allowed, incorrect API key or scope."
},
"404": {
"description": "Not found."
},
"409": {
"description": "Aborted."
},
"429": {
"description": "Too Many Requests."
}
},
"security": [
{
"roblox-api-key": [
"universe.ordered-data-store.scope.entry:write"
]
}
],
"x-roblox-scopes": [
{
"name": "universe.ordered-data-store.scope.entry:write"
}
],
"x-roblox-cloud-api-operation-code-samples": [
{
"language": "curl",
"script": "curl --location --request PATCH 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \\\n--header 'x-api-key: <insert-api-key>' \\\n--header 'Content-Type: application/json' \\\n--data '{ \n \"value\": <long> \n}'\n"
}
],
"x-roblox-rate-limits": {
"description": "See [Throttling](/cloud/guides/data-stores/throttling.md)."
},
"x-roblox-recommended-alternatives": [
{
"url": "https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}",
"httpMethod": "PATCH"
}
]
}