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.

POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items — cloud.docs

Create Memory Store Sorted Map Item

Creates the specified map item if it doesn't exist.

Endpoint

Method: POST

Path: /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

Servers:

Parameters

NameLocationRequiredDescription
universe_idpathtrueThe universe ID.
sorted_map_idpathtrueThe sorted-map ID.
idqueryfalseThe ID to use for the memory store sorted map item, which will become the final component of the memory store sorted map item's resource path. This value should be a 1-127 character string that supports alphanumeric and special characters. This id is case sensitive. The id must be url encoded if it contains any url breaking special characters.
[
  {
    "name": "universe_id",
    "in": "path",
    "description": "The universe ID.",
    "required": true,
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "sorted_map_id",
    "in": "path",
    "description": "The sorted-map ID.",
    "required": true,
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "id",
    "in": "query",
    "description": "The ID to use for the memory store sorted map item, which will become the\nfinal component of the memory store sorted map item's resource path.\n\nThis value should be a 1-127 character string that supports alphanumeric\nand special characters. This id is case sensitive. The id must be url\nencoded if it contains any url breaking special characters.",
    "schema": {
      "type": "string"
    },
    "examples": {
      "id": {
        "description": "a 1-127 character string that supports alphanumeric and special characters. This id is case sensitive. The id must be url encoded if it contains any url breaking special characters.",
        "value": "Hello!"
      }
    }
  }
]

Request Body

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MemoryStoreSortedMapItem"
      }
    }
  },
  "required": true
}

Responses

StatusDescription
200OK
{
  "200": {
    "description": "OK",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/MemoryStoreSortedMapItem"
        }
      }
    }
  }
}

Authentication

{
  "security": [],
  "securitySchemes": {}
}

Complete Operation Definition

{
  "tags": [
    "Cloud"
  ],
  "summary": "Create Memory Store Sorted Map Item",
  "description": "Creates the specified map item if it doesn't exist.",
  "operationId": "Cloud_CreateMemoryStoreSortedMapItem",
  "parameters": [
    {
      "name": "universe_id",
      "in": "path",
      "description": "The universe ID.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "sorted_map_id",
      "in": "path",
      "description": "The sorted-map ID.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "id",
      "in": "query",
      "description": "The ID to use for the memory store sorted map item, which will become the\nfinal component of the memory store sorted map item's resource path.\n\nThis value should be a 1-127 character string that supports alphanumeric\nand special characters. This id is case sensitive. The id must be url\nencoded if it contains any url breaking special characters.",
      "schema": {
        "type": "string"
      },
      "examples": {
        "id": {
          "description": "a 1-127 character string that supports alphanumeric and special characters. This id is case sensitive. The id must be url encoded if it contains any url breaking special characters.",
          "value": "Hello!"
        }
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/MemoryStoreSortedMapItem"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/MemoryStoreSortedMapItem"
          }
        }
      }
    }
  },
  "x-visibility": "STABLE",
  "x-roblox-engine-usability": {
    "apiKeyWithHttpService": false
  },
  "x-roblox-scopes": [
    {
      "name": "memory-store.sorted-map:write"
    }
  ],
  "x-roblox-docs": {
    "category": "Data and memory stores",
    "methodProperties": {
      "scopes": [
        "memory-store.sorted-map:write"
      ]
    },
    "resource": {
      "$ref": "#/components/schemas/MemoryStoreSortedMapItem",
      "name": "MemoryStoreSortedMapItem"
    }
  }
}