# Update a task

Required scopes: task-management:write

Endpoint: PATCH /tasks/{task}
Version: v1
Security: http, oauth2

## Path parameters:

  - `task` (string, required)

## Query parameters:

  - `find_by` (string)
    The field to search by
    Enum: "id", "uri", "external_id"

  - `origin` (string)
    Used if find_by=external_id  by default it will use the integration slug

## Request fields (application/json):

  - `title` (string)

  - `description` (string)
    In HTML
use " /> to mention user

  - `estimated_hours` (number,null)

  - `due_date` (string,null)

  - `is_public` (boolean,null)

  - `watchers` (array)
    If present - overwrites the watch list

  - `add_watchers` (array)
    Adds user to watchlist

  - `status` (string)
    | |
|---|
| Backlog   |
| New  In Todo |
| WIP  In progress |
| Completed   |
| Approved   |
| Closed  Task was archived |
    Enum: "Backlog", "New", "WIP", "Completed", "Approved", "Closed"

  - `parent_task_id` (string,null)

  - `assignee_id` (string,null)

  - `epic_id` (string,null)

  - `phase_id` (string,null)

  - `milestone_id` (string,null)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.