3. MCP Server Reference › 3.3 Engine › Images › engine_image_dir_rename

Renames or moves an images folder with everything inside it.

The Right

“Direct access → Development → Modify data” (AGENT_ENGINE_DEV_WRITE).

Parameters

Parameter Type What it is
path string what the folder is called now
new_path string what it will become

One call changes one thing:

The group’s own images/ is the root: it cannot be renamed or moved. The links to the folder’s files in the markup and in the styles do not change.

The Answer

{"path": "./../templates/default/images/banners",
 "new_path": "./../templates/default/images/promo", "bundled": 0}
Field What it is
path what the folder was called
new_path what it is called now
bundled how many of the files inside had a bundle description — see “Statics

Refusals

Answer When
No such folder in the images tree: … engine_map_tree lists the folders under dirs. the folder is not among the images folders
… is the images root of a template - it cannot be renamed or deleted… this is the group’s images/
… is not a folder of the images tree. the path lies outside the group’s images folder
One act at a time: … new_path changes both the parent and the name
No such folder: … engine_map_tree lists the folders of both trees under dirs. the new parent is not among the images and statics folders
A folder cannot be moved inside itself. the new parent lies inside the folder itself
Folder already exists: <name> there is already a folder with this name in the new place
new_path is the same path - nothing to change. the path does not change
The last part of new_path must be a plain name. the new name contains ..
path is required…, new_path is required… one of the paths is not named

The common refusals — “Answers and Refusals”.