# Delete a task

Endpoint: DELETE /api/v1/tasks/{id}
Version: 0.0.1
Security: bearerAuth

## Path parameters:

  - `id` (string, required)

## Response 200 fields (application/json):

  - `id` (string, required)

  - `form_id` (string, required)

  - `form_custom_attributes` (object, required)
    Custom attribute values

  - `name` (string, required)
    Name of the form.

  - `employee_id` (string, required)

  - `employer_id` (string,null, required)

  - `client_id` (string,null, required)

  - `job_id` (string,null, required)

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

  - `next_action` (object, required)

  - `next_action.type` (string,null, required)
    Enum: "employer_action", "employee_action", "system_action"

  - `expired_at` (string,null, required)
    Expiration time is re-evaluated at the time of task completion. If your integration reads the field value before a task is completed, please note that the value may change when the task is completed.

  - `deletion_scheduled_at` (string,null, required)
    When this field is set, the task will be automatically deleted at the specified time.

  - `deletion_allowed_at` (string,null, required)
    When this field is set, the task cannot be deleted until the specified time.

  - `due_at` (string,null, required)

  - `progress` (object, required)

  - `progress.percent` (number, required)

  - `progress.numerator` (number, required)

  - `progress.denominator` (number, required)

  - `subtasks` (array, required)

  - `subtasks.form_page_id` (string, required)

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

  - `tags` (array, required)

  - `tags.name` (string, required)

  - `created_at` (string, required)

  - `updated_at` (string, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Enum: "Not authorized"

## Response 404 fields (application/json):

  - `message` (string, required)
    Enum: "Task not found"