.. _auto_workflow_create_from_file:

*CREATES A WORKFLOW FROM FILE*
==============================

Creates a new d3VIEW workflow by importing a workflow definition file, assigning it a name, tags, and description, and optionally associating it with a project. Use this worker to programmatically register or migrate workflow templates from file-based sources into the platform.

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

Tagged: ``create``, ``file``, ``import``, ``registration``, ``template``, ``user``, ``workflow``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Workflow File
     - workflow_file
     - file
     - —
     - ✓
     - The workflow definition file (e.g., a JSON or XML export) that describes the workflow structure to be imported; must be a valid platform-compatible workflow format.
   * - Name
     - name
     - text
     - —
     - ✓
     - Human-readable display name assigned to the newly created workflow; must be unique and non-empty.
   * - Tags
     - tags
     - text
     - —
     - ✓
     - Comma-separated free-text tags used to categorize and search for the workflow within the platform (e.g., 'crash, doe, automation').
   * - Description
     - description
     - textarea
     - —
     - ✓
     - Multi-line prose description of the workflow's purpose, scope, and usage notes; shown in the platform's workflow registry detail view.
   * - Project ID
     - project_id
     - remote_lookup
     - —
     - 
     - Optional platform Project ID to associate the workflow with a specific project; leave null (default) to create the workflow without a project association.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Workflow
     - workflow_id
     - integer
     - Integer ID of the newly created workflow record in the platform, which can be passed to downstream workers that reference or trigger workflows.

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