.. _auto_task_create:

*CREATES A NEW TASK*
====================

Creates a new platform Task record and persists it to the database under the active user's account. Use this worker within a workflow whenever a trackable action item, review step, or follow-up needs to be programmatically generated and optionally linked to a project and file attachments.

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

Tagged: ``assignment``, ``platform``, ``project_management``, ``task``, ``task_create``, ``workflow_task``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Task Name
     - task_name
     - text
     - —
     - ✓
     - Short human-readable title for the task; required and used as the primary display label throughout the platform.
   * - Description
     - description
     - textarea
     - —
     - 
     - Optional free-text body describing the task's purpose, acceptance criteria, or any supplemental context.
   * - Status
     - status
     - select
     - to_do
     - ✓
     - Initial lifecycle state of the task; choose from 'to_do' (default), 'in_progress', 'paused', or 'done'.
   * - Priority
     - priority
     - select
     - high
     - ✓
     - Urgency level of the task; choose from 'low', 'medium', or 'high' (default).
   * - Due On
     - due_on
     - datetime-local
     - —
     - 
     - Optional deadline for the task as a local datetime (YYYY-MM-DDTHH:MM); leave blank if no due date is required.
   * - Assigned To
     - assigned_to
     - remote_lookup
     - —
     - 
     - Optional platform user(s) responsible for completing the task; resolved via remote user lookup — leave blank to assign to no one.
   * - Category
     - category
     - select
     - generic
     - 
     - Logical classification of the task; choose from 'generic' (default), 'simulation', 'workflow', 'database', 'file', or 'hpc'; the list is editable.
   * - Project ID
     - project_id
     - remote_lookup
     - —
     - 
     - Optional platform Project to associate this task with; resolved via remote project lookup — leave blank to create a standalone task.
   * - Files
     - files
     - file
     - —
     - 
     - Optional file attachment(s) to associate with the newly created task; each file is stored as a child record linked to the task.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Task ID
     - task_id
     - scalar
     - Integer primary-key ID of the newly created Task record in the platform database; use this in downstream workers to reference or update the task.

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

- platform.integration
- 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>task_create</code>. Schema hash: <code>52a762ba5595</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>