.. _auto_user_finder:

*USER FINDER*
=============

Searches the platform user directory and returns a filtered list of matching users. Use this worker whenever a workflow needs to look up or resolve user accounts by attribute (name, role, email, etc.).

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

Tagged: ``filters``, ``platform_users``, ``user_directory``, ``user_finder``, ``user_search``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Filters
     - filters
     - filters
     - —
     - ✓
     - Dynamic filter criteria for querying the user directory (e.g. name, email, role); populated via /api/app/get_filters?type=users — required to narrow the search and must be configured before execution.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Users
     - users
     - dataset
     - Dataset of platform user records matching the applied filters, typed as 'users'; consumed downstream wherever user identity or assignment is needed.

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

- platform.integration

.. raw:: html

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