.. _auto_workflows_finder:

*SEARCHES FOR WORKFLOWS FROM THE DATABASE*
==========================================

Searches the workflows repository based on criteria and filters and returns a dataset of workflows matching the search. Use this worker to discover and list workflows by keyword, ownership, project, date range, sharing context, status, or type.

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

Tagged: ``filter``, ``finder``, ``ownership``, ``project``, ``repository``, ``status``, ``workflow_search``.

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 applied against workflow name and description fields; leave blank to return all workflows matching other active filters.
   * - Ownership
     - ownership
     - list
     - —
     - 
     - Filters workflows by ownership relationship — choose one or more of: 'By me' (owned), 'Shared With me', or 'Shared By me'; leave unset to include all ownership types.
   * - By Project
     - project_id
     - remote_lookup
     - —
     - 
     - Restricts results to workflows belonging to the selected project(s); resolved via remote project lookup — leave unset to search across all projects.
   * - Start Date
     - start_date
     - datetime-local
     - —
     - 
     - ISO-8601 datetime lower bound (inclusive) on workflow creation date; only workflows created on or after this timestamp are returned — leave blank for no lower date limit.
   * - End Date
     - end_date
     - datetime-local
     - —
     - 
     - ISO-8601 datetime upper bound (inclusive) on workflow creation date; only workflows created on or before this timestamp are returned — leave blank for no upper date limit.
   * - Shared By User
     - shared_by
     - text
     - —
     - 
     - Username string; restricts results to workflows that were shared by this specific user — leave blank to ignore the sharing-source filter.
   * - Shared With User
     - shared_with
     - text
     - —
     - 
     - Username string; restricts results to workflows that were shared with this specific user — leave blank to ignore the sharing-target filter.
   * - Status
     - status
     - text
     - —
     - 
     - Comma-separated status value(s) (e.g., 'active,archived') used to filter workflows by their current lifecycle status — leave blank to return all statuses.
   * - Type of Workflow
     - type
     - list
     - —
     - 
     - 
   * - Bookmarked
     - bookmarked
     - select
     - —
     - 
     - Previously bookmarked Workflows will be included in the list
   * - Limit records
     - limit
     - list
     - 25
     - 
     - Number of workflows matching this number will be returned

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Workflows
     - workflows
     - dataset
     - Tabular dataset (datatype: workflows) where each row represents a workflow record matching all supplied filter criteria, including metadata such as name, description, status, ownership, and project.

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