.. _auto_file_finder:

*ATTACHMENT FINDER*
===================

Searches the platform attachment store using user-defined filters and returns a dataset of matching files. Use this worker to locate and retrieve attachments for downstream processing or reporting steps.

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

Tagged: ``attachment``, ``file_search``, ``finder``, ``responses``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Filters
     - filters
     - filters
     - —
     - ✓
     - One or more platform attachment filters (populated from /api/app/get_filters?type=attachment) that narrow the search by attributes such as name, type, or associated record; at least one filter is required.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Files
     - files
     - dataset
     - Dataset of file records matching the applied filters; each row represents one attachment with its metadata (e.g. filename, path, MIME type) for use in downstream workers.

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