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¶
| 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¶
| 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
Auto-generated from platform schema. Worker id: task_create. Schema hash: 52a762ba5595. Hand-curated docs in workerexamples/ override this page when present.