Ara
Download

Search or run a command

Jump to a section or open an Ara link.

Command · material

material.rename

Rename a value while retaining its graph identity and layout.
scope edit:scenenot idempotentnon-destructive

Params

Typed as MaterialRenameParams. Fields marked * are required.

from*

string
Existing authored name.
required

to*

string
New unique authored name.
required

restoreId

option<string>
Diagnostic-only recovery identity after a plain-text delete/create rename.
default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "material.rename",
  "args": {
    "from": "paint",
    "to": "basePaint"
  }
}

CLI

ara do material.rename --args '{"from":"paint","to":"basePaint"}' --why "…"