To run a Dynamo script, configure the following options in the command dialog.

• Script file :

  Script file :

  The full path to the Dynamo script (.dyn) file you want to run. You can use the browse button to select a file from disk.

  The full path to the Dynamo script (.dyn) file you want to run. You can use the browse button to select a file from disk.

• Input values :

  Input values :

  (Optional) A list of named input values. Each input should match the node identifiers (IDs) in your Dynamo graph. Values are assigned to corresponding input nodes before execution.

  (Optional) A list of named input values. Each input should match the node identifiers (IDs) in your Dynamo graph. Values are assigned to corresponding input nodes before execution.

When executed, the command launches Dynamo in headless automation mode (UI-less), loads the specified graph, applies provided input values, and runs the script to completion. The output or any errors are displayed in a result dialog.

• Headless execution :

  Headless execution :

  Dynamo runs invisibly in the background. If the Dynamo UI is already open, the command will prompt you to close it before proceeding.

  Dynamo runs invisibly in the background. If the Dynamo UI is already open, the command will prompt you to close it before proceeding.

• Input assignment :

  Input assignment :

  Inputs are mapped to nodes by their ID (as assigned in Dynamo). Ensure your Dynamo script exposes inputs with recognizable IDs to allow automated assignment.

  Inputs are mapped to nodes by their ID (as assigned in Dynamo). Ensure your Dynamo script exposes inputs with recognizable IDs to allow automated assignment.

• Output display :

  Output display :

  The command collects output from nodes marked as Is Output in the Dynamo workspace and displays the result after execution.

  The command collects output from nodes marked as Is Output in the Dynamo workspace and displays the result after execution.

1. Prepare or select your .dyn file in Dynamo (ensure inputs/outputs are properly configured).
2. In Revit, launch the command and specify the script file path.
3. Optionally provide input values for parameters required by your Dynamo graph.
4. Click OK to execute. The script runs in the background, and the result is shown in a dialog box.

If the script fails, any error messages from Dynamo are displayed to help diagnose issues. Common problems include missing input IDs, invalid values, or issues in the graph logic.

• Common errors :

  Common errors :

  • Dynamo UI is already open: Please close it before running this command.
  • Missing or incorrect input ID: Check that input names match those used in your Dynamo graph.
  • Script file not found: Ensure the path to the .dyn file is correct and accessible.
  • Node errors in Dynamo: Review your graph for red nodes or warnings before automation.

  • Dynamo UI is already open: Please close it before running this command.
  • Missing or incorrect input ID: Check that input names match those used in your Dynamo graph.
  • Script file not found: Ensure the path to the .dyn file is correct and accessible.
  • Node errors in Dynamo: Review your graph for red nodes or warnings before automation.

This command requires Autodesk Revit 2023 or newer and works with Dynamo graphs compatible with the installed version of Dynamo for Revit.