# Create a new task

Endpoint: POST /api/v1/tasks
Version: 0.0.1
Security: user_session, form_session, component_session, component_token, api_token

## Query parameters:

  - `allow_duplicate` (string)
    Enum: "true", "false", "True", "False"

## Request fields (application/json):

  - `form_id` (string, required)
    Form Identifier (lineage uid)

  - `employee_id` (string, required)
    Employee Identifier

  - `employer_id` (any)

  - `client_id` (any)

  - `job_id` (any)

  - `placement_id` (any)

  - `expired_at` (any)

  - `due_at` (any)

  - `deletion_scheduled_at` (any)

  - `deletion_allowed_at` (any)

## Response 201 fields (application/json):

  - `id` (string, required)
    Task Identifier

  - `form_id` (string, required)
    Form Identifier (lineage uid)

  - `form_custom_attributes` (object, required)

  - `name` (string, required)
    The name of the form

  - `employee_id` (string, required)
    Employee Identifier

  - `employer_id` (any, required)

  - `client_id` (any, required)

  - `job_id` (any, required)

  - `status` (string, required)
    Enum: "requires_action", "completed", "expired"

  - `next_action` (object, required)

  - `next_action.type` (any, required)

  - `expired_at` (any, required)

  - `deletion_scheduled_at` (any, required)

  - `deletion_allowed_at` (any, required)

  - `due_at` (any, required)

  - `completed_at` (any, required)
    This field is set when the task status changes to completed.

  - `progress` (object, required)

  - `progress.percent` (number, required)

  - `progress.numerator` (number, required)

  - `progress.denominator` (number, required)

  - `subtasks` (array, required)

  - `subtasks.id` (string, required)

  - `subtasks.form_page_id` (string, required)

  - `subtasks.assignee_type` (string, required)
    Enum: "employee", "employer"

  - `subtasks.form_section` (any, required)

  - `subtasks.progress` (object, required)

  - `subtasks.progress.percent` (number, required)

  - `subtasks.progress.numerator` (number, required)

  - `subtasks.progress.denominator` (number, required)

  - `tags` (array, required)

  - `tags.name` (string, required)

  - `created_at` (string, required)
    a string to be decoded into a DateTime.Utc

  - `updated_at` (string, required)
    a string to be decoded into a DateTime.Utc

  - `_tag` (string, required)
    Enum: "Task"

## Response 401 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Unauthorized"

## Response 403 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "Forbidden"

## Response 404 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "ResourceNotFoundError"

## Response 409 fields (application/json):

  - `message` (string, required)

  - `_tag` (string, required)
    Enum: "DuplicateTaskError"