---
title: "Updates a Task"
method: PUT
path: "/Tasks"
tags: ["Tasks"]
---

# Updates a Task

`PUT /Tasks`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Tasks`
- Auth: none declared. Required headers: `Authorization`

If you have trouble updating a Task, try accessing the Task via the GET request to inspect its fields and sub-elements. A common source of            problems with write/update requests occurs when users either omit required fields, or insert invalid data into a field (for example, by referring a            CATEGORY_ID or LINK_ID which does not exist.

## Headers

- `Authorization` string, required

## Request body

- object
  - `TASK_ID` integer, required
  - `TITLE` string, string, required
  - `CATEGORY_ID` integer
  - `DUE_DATE` string, date-time
  - `COMPLETED` boolean, required
  - `DETAILS` string, string
  - `STATUS` string, string
  - `PRIORITY` integer
  - `PERCENT_COMPLETE` integer
  - `START_DATE` string, date-time
  - `MILESTONE_ID` integer
  - `RESPONSIBLE_USER_ID` integer
  - `OWNER_USER_ID` integer, required
  - `EMAIL_ID` integer
  - `PROJECT_ID` integer
  - `REMINDER_DATE_UTC` string, date-time
  - `OWNER_VISIBLE` boolean
  - `PARENT_TASK_ID` integer
  - `RECURRENCE` string, string
  - `OPPORTUNITY_ID` integer
  - `ASSIGNED_TEAM_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Response `201`

Request succeeded.

- object
  - `TASK_ID` integer, required
  - `TITLE` string, string, required
  - `CATEGORY_ID` integer
  - `DUE_DATE` string, date-time
  - `COMPLETED_DATE_UTC` string, date-time
  - `COMPLETED` boolean, required
  - `DETAILS` string, string
  - `STATUS` string, string
  - `PRIORITY` integer
  - `PERCENT_COMPLETE` integer
  - `START_DATE` string, date-time
  - `MILESTONE_ID` integer
  - `RESPONSIBLE_USER_ID` integer
  - `OWNER_USER_ID` integer, required
  - `DATE_CREATED_UTC` string, date-time, required
  - `DATE_UPDATED_UTC` string, date-time, required
  - `EMAIL_ID` integer
  - `PROJECT_ID` integer
  - `REMINDER_DATE_UTC` string, date-time
  - `REMINDER_SENT` boolean
  - `OWNER_VISIBLE` boolean
  - `STAGE_ID` integer
  - `ASSIGNED_BY_USER_ID` integer
  - `PARENT_TASK_ID` integer
  - `RECURRENCE` string, string
  - `OPPORTUNITY_ID` integer
  - `ASSIGNED_TEAM_ID` integer
  - `ASSIGNED_DATE_UTC` string, date-time
  - `CREATED_USER_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object
  - `LINKS` APILinkDto[]
    - `LINK_ID` integer
    - `OBJECT_NAME` string
    - `OBJECT_ID` integer
    - `LINK_OBJECT_NAME` string
    - `LINK_OBJECT_ID` integer
    - `ROLE` string
    - `DETAILS` string
    - `RELATIONSHIP_ID` integer
    - `IS_FORWARD` boolean

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `402`: Record limit reached.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)