# Update Task

PATCH /{taskId}

#### Description

Updates an existing task with new values, modifying its attributes such as title, description, status, assignee, or due dates.

Endpoint: PATCH /{taskId}
Version: 1.0
Security: oauth2

## Path parameters:

  - `taskId` (string, required)
    Unique ID of the task to update.

## Request fields (application/json):

  - `title` (string)
    The title of the task.
    Example: "Submit the latest employee agreements"

  - `description` (string)
    The description of the task.
    Example: "The latest employee agreements are needed for the upcoming audit."

  - `assigneeId` (string)
    The unique identifier of the user assigned to the task.
    Example: "ad21d858-c271-4c6d-8780-fecf6b16e534"

  - `targetId` (string)
    The unique identifier of the object that is the target of the task.
    Example: "23b802db-bad2-4f7a-b8d1-ac1177909992"

  - `targetType` (string)
    The object type of the target of the task.
    Example: "control"

  - `taskStatusId` (string)
    The unique identifier of the task status for the task.
    Example: "e2303b2b-5ee4-4354-92de-dfacd1d33f09"

  - `priority` (string)
    The priority level.
    Enum: "highest", "high", "medium", "low", "lowest"

  - `dueDate` (string)
    The due date of the task (ISO-8601 format).
    Example: "2020-12-17T20:00:00Z"

  - `groupId` (string)
    The unique identifier of the group assigned to the task.

  - `clearGroupId` (boolean)
    Whether to clear the existing group identifier. GroupId must be empty.

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier of the task.
    Example: "ba50096d-bbfa-47af-94a7-092b0984cf35"

  - `orgId` (string)
    The unique identifier of the organization the task belongs to.
    Example: "4c05da3f-f076-461c-8105-80a07a42ab7f"

  - `title` (string)
    The title of the task.
    Example: "Submit the latest employee agreements"

  - `description` (string)
    The description of the task.
    Example: "The latest employee agreements are needed for the upcoming audit."

  - `assigneeId` (string)
    The unique identifier of the user assigned to the task.
    Example: "ad21d858-c271-4c6d-8780-fecf6b16e534"

  - `targetId` (string)
    The unique identifier of the object that is the target of the task.
    Example: "23b802db-bad2-4f7a-b8d1-ac1177909992"

  - `targetType` (string)
    The object type of the target of the task.
    Example: "control"

  - `taskStatusId` (string)
    The unique identifier of the task status for the task.
    Example: "e2303b2b-5ee4-4354-92de-dfacd1d33f09"

  - `priority` (string)
    The priority level.
    Enum: "highest", "high", "medium", "low", "lowest"

  - `dueDate` (string)
    The due date of the task (ISO-8601 format).
    Example: "2020-12-17T20:00:00Z"

  - `createdOn` (string)
    The date and time the task was created (ISO-8601 format).
    Example: "2020-12-17T20:00:00Z"

  - `updatedOn` (string)
    The date and time the task was last updated (ISO-8601 format).
    Example: "2020-12-17T20:00:00Z"

  - `groupId` (string)
    The unique identifier of the group assigned to the task.
    Example: "193ceec7-4911-11ef-8f90-8688bf62af58"