Skip to main content
Creates multiple Roblox instances in batch. Each item is created independently with its own path and className.

Endpoint

mass_create_objects

Parameters

items
array
required
Array of objects to create. Each item contains:

Response

results
array
Array of results, one for each item in the input. Each result contains:

Examples

Create Multiple Folders

{
  "items": [
    {
      "path": "game.ReplicatedStorage",
      "className": "Folder"
    },
    {
      "path": "game.ServerStorage",
      "className": "Folder"
    },
    {
      "path": "game.ReplicatedStorage.Folder",
      "className": "Folder"
    }
  ]
}
Response:
{
  "results": [
    {
      "ok": true,
      "path": "ReplicatedStorage.Folder",
      "name": "Folder"
    },
    {
      "ok": true,
      "path": "ServerStorage.Folder",
      "name": "Folder"
    },
    {
      "ok": true,
      "path": "ReplicatedStorage.Folder.Folder",
      "name": "Folder"
    }
  ]
}

Create Mixed Object Types

{
  "items": [
    {
      "path": "game.Workspace",
      "className": "Part"
    },
    {
      "path": "game.Workspace",
      "className": "Model"
    },
    {
      "path": "game.Workspace.Model",
      "className": "Part"
    }
  ]
}
Response:
{
  "results": [
    {
      "ok": true,
      "path": "Workspace.Part",
      "name": "Part"
    },
    {
      "ok": true,
      "path": "Workspace.Model",
      "name": "Model"
    },
    {
      "ok": true,
      "path": "Workspace.Model.Part",
      "name": "Part"
    }
  ]
}

Handling Partial Failures

{
  "items": [
    {
      "path": "game.Workspace",
      "className": "Part"
    },
    {
      "path": "game.InvalidPath",
      "className": "Part"
    },
    {
      "path": "game.Workspace",
      "className": "Folder"
    }
  ]
}
Response:
{
  "results": [
    {
      "ok": true,
      "path": "Workspace.Part",
      "name": "Part"
    },
    {
      "error": "Invalid path: game.InvalidPath"
    },
    {
      "ok": true,
      "path": "Workspace.Folder",
      "name": "Folder"
    }
  ]
}

Notes

  • Each object is created independently; one failure does not stop others from being created
  • Results are returned in the same order as the input items
  • For creating objects with properties, use mass_create_objects_with_properties
  • This is more efficient than calling create_object multiple times

Build docs developers (and LLMs) love