.. _auto_simulation_rename_file:

*RENAME SIMULATION FILE*
========================

Renames a file attached to a simulation record, updating its display name in the platform. Use this worker whenever a workflow needs to programmatically rename a simulation attachment without manually editing it through the UI.

When to use
-----------

Tagged: ``attachment``, ``file``, ``rename``, ``simulation``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation Id
     - simulation_id
     - text
     - —
     - 
     - Integer ID of the parent simulation whose file should be renamed; leave blank if the simulation is resolved upstream in the workflow.
   * - Choose File
     - att_id
     - remote_lookup
     - —
     - 
     - File attachment to rename, selected from the list of files belonging to the chosen simulation; depends on simulation_id being populated first.
   * - New File Name
     - new_name
     - text
     - —
     - ✓
     - Target filename string (including extension) to assign to the selected attachment; required and must be non-empty.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Integer ID of the simulation that owns the renamed file, passed through for downstream chaining.
   * - Att Id
     - att_id
     - integer
     - Integer ID of the attachment record that was renamed, useful for downstream file-operation workers.
   * - Old Name
     - old_name
     - text
     - Original filename of the attachment before the rename operation, useful for audit logging or rollback.
   * - New Name
     - new_name
     - text
     - Confirmed new filename applied to the attachment after the rename operation completes successfully.

Disciplines
-----------

- data.io.file

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>simulation_rename_file</code>. Schema hash: <code>badf6f7311b5</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>