.. _auto_templates_finder:

*RETRIEVES TEMPLATES BASED ON FILTERS*
======================================

Queries the platform template registry and returns a filtered list of response templates. Use this worker to discover and retrieve templates by keyword, bookmark status, date range, and sort order for downstream workflow steps.

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

Tagged: ``filter``, ``finder``, ``projects``, ``response_templates``, ``search``, ``templates``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Search
     - search
     - text
     - —
     - 
     - Free-text keyword string used to filter templates by name or content; leave blank to return all templates matching other filter criteria.
   * - Bookmarked
     - bookmarked
     - select
     - —
     - 
     - Filter templates by bookmark status; select 'Yes' to return only bookmarked templates, 'No' for un-bookmarked ones, or leave unset to include both.
   * - Start Date
     - start_date
     - datetime-local
     - —
     - 
     - Lower bound (inclusive) of the template creation/modification date range in local datetime format (YYYY-MM-DDTHH:MM); leave blank to apply no lower date constraint.
   * - End Date
     - end_date
     - datetime-local
     - —
     - 
     - Upper bound (inclusive) of the template creation/modification date range in local datetime format (YYYY-MM-DDTHH:MM); leave blank to apply no upper date constraint.
   * - Limit records
     - limit
     - list
     - 25
     - 
     - Maximum number of template records to return; defaults to 25 — increase (up to 1000) or set to -1 for no limit when a full result set is required.
   * - Sort By
     - order_by
     - list
     - srs.id:desc
     - 
     - Sort order for the returned templates; defaults to 'ID: Newer first' — choose from name (A-Z / Z-A), ID (newer/older first), or status (A-Z / Z-A).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Templates
     - templates
     - dataset
     - Dataset of response template records (datatype: responsetemplates) matching the applied filters, each containing template ID, name, status, and associated metadata.

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

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