.. _auto_rename_template:

*RENAME TEMPLATE*
=================

Renames an existing response template to a new user-supplied name. Use this worker when a template's label needs to be updated in place without recreating it. Returns the ID of the renamed template for downstream reference.

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

Tagged: ``physicaltest``, ``rename``, ``response_template``, ``template``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - New Name
     - new_name
     - scalar
     - —
     - ✓
     - The desired new display name for the template; must be a non-empty string — no default, always required.
   * - Template
     - template_id
     - remote_lookup
     - —
     - 
     - Remote-lookup selector for the target response template (resolved against /api/user/responsetemplates); leave unset only if the template ID is injected programmatically by an upstream worker.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Template Id
     - template_id
     - integer
     - Integer primary key of the successfully renamed response template; pass to downstream workers that reference the template by ID.

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

- cae.postprocessing.response
- 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>rename_template</code>. Schema hash: <code>857e3ec8a371</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>