reload_document
Close and reopen an open FreeCAD document to load external .FCStd changes made outside the GUI, updating stale in-memory geometry from disk.
Instructions
Close and re-open a document to pick up external file changes.
Use this AFTER the document's .FCStd file has been modified by
something outside of FreeCAD's GUI process — for example, a
headless `freecadcmd` script that edited and saved the file. The
open GUI document is otherwise unaware of on-disk changes; this
tool closes the stale in-memory copy and reopens the file from
disk so the GUI shows current geometry.
Args:
doc_name: The name of the open document to reload. Must match
the name shown by ``list_documents``.
Returns:
A message confirming the document was reloaded, or describing
the failure (document not loaded, no associated file, etc).
FreeCAD names the reopened document after the file stem, which
can differ from ``doc_name`` ("HandleConcept3D" saved as
handle-concept-3d.FCStd reopens as handle_concept_3d); the reply
names the document you should use from then on.
Examples:
```json
{
"doc_name": "chassis"
}
```
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc_name | Yes |