Ara
Download

Search or run a command

Jump to a section or open an Ara link.

Command · doc

doc.create

Create a canonical empty scene, prefab or other registered document.
scope edit:scenenot idempotentnon-destructive

Params

Typed as DocCreateParams. Fields marked * are required.

path*

string
Project-relative output path, with the document kind's extension.
required

kind

option<string>
Registered kind, or the material template (.graph); inferred from the path when omitted.
default null

id

option<string>
Stable asset ID or batch symbol; generated when omitted.
default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "doc.create",
  "args": {
    "path": "levels/arena.scene",
    "id": "sc_arena001"
  }
}

CLI

ara do doc.create --args '{"path":"levels/arena.scene","id":"sc_arena001"}' --why "…"