.. _auto_simulation_file_editor:

*EDIT CONTENTS OF AN SIMULATION FILES*
======================================

Replaces the content of an existing simulation file attachment with a new uploaded file. Use this worker within a workflow whenever a simulation's input deck or supporting file needs to be updated in-place without creating a new simulation record.

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

Tagged: ``attachment``, ``file_editor``, ``replace``, ``simulation``, ``simulation_file``, ``upload``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Integer ID of the target simulation (resolved via remote lookup); selects which simulation's attachment list is queried — required, no default.
   * - Choose Attachment
     - att_id
     - remote_lookup
     - —
     - ✓
     - Integer ID of the specific attachment to replace, filtered to attachments belonging to the chosen simulation; resolved via remote lookup against /api/user/attachments — required, no default.
   * - Updated Attachment
     - new_file
     - file
     - —
     - ✓
     - The replacement file to upload; its contents will overwrite the existing attachment identified by att_id — required, must be a valid file upload.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation
     - simulation_id
     - integer
     - Integer ID of the simulation whose attachment was updated; passed downstream to link subsequent workers to the same simulation.
   * - Attachment
     - attachment_id
     - integer
     - Integer ID of the attachment that was replaced; useful for audit trails or downstream steps that need to reference the updated file.

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

- data.io.file
- platform.workflow

.. 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_file_editor</code>. Schema hash: <code>5a9ca2f56882</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>