---
title: "Update Task"
method: PATCH
path: "/team-messaging/v1/tasks/{taskId}"
tags: ["Tasks"]
---

# Update Task

`PATCH /team-messaging/v1/tasks/{taskId}`

Updates the specified task by ID.

## Path parameters

- `taskId` string, required

## Request body

- TMUpdateTaskRequest
  - `subject` string — Task name/subject. Max allowed length is 250 characters.
  - `assignees` object[]
    - `id` string — Internal identifier of an assignee
  - `completenessCondition` 'Simple' | 'AllAssignees' | 'Percentage'
  - `startDate` string, date-time — Task start date in UTC time zone
  - `dueDate` string, date-time — Task due date/time in UTC time zone
  - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta'
  - `section` string — Task section to group / search by. Max allowed length is 100 characters.
  - `description` string — Task details. Max allowed length is 102400 characters (100kB)
  - `recurrence` TaskRecurrenceInfo — Task information
    - `schedule` 'None' | 'Daily' | 'Weekdays' | 'Weekly' | 'Monthly' | 'Yearly' — Recurrence settings of a task. None for non-periodic tasks
    - `endingCondition` 'None' | 'Count' | 'Date' — Ending condition of a task
    - `endingAfter` integer — Count of iterations of periodic tasks
    - `endingOn` string, date-time — End date of a periodic task in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format, UTC time zone
  - `attachments` TMAttachmentInfo[]
    - `id` string — Internal identifier of an attachment
    - `type` 'File' | 'Note' | 'Event' | 'Card' — Type of an attachment

## Response `200`

OK

- TMTaskList
  - `records` TMTaskInfo[]
    - `id` string — Internal identifier of a task
    - `creationTime` string, date-time — Task creation date/time in UTC time zone
    - `lastModifiedTime` string, date-time — Task the last modified time in UTC time zone
    - `type` 'Task' — Task type
    - `creator` object
      - `id` string — Internal identifier of a task creator
    - `chatIds` string[] — Internal identifiers of the chats where the task is posted or shared
    - `status` 'Pending' | 'InProgress' | 'Completed' — Task execution status
    - `subject` string — Task name/subject
    - `assignees` object[] — Task name/subject
      - `id` string — Internal identifier of an assignee
      - `status` 'Pending' | 'Completed' — Task execution status by assignee
    - `completenessCondition` 'Simple' | 'AllAssignees' | 'Percentage' — How the task completeness should be determined
    - `completenessPercentage` integer — Current completeness percentage of the task with the specified percentage completeness condition
    - `startDate` string, date-time — Task start date
    - `dueDate` string, date-time — Task due date/time
    - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta' — Font color of a post with the current task
    - `section` string — Task section to group / search by
    - `description` string — Task details
    - `recurrence` TaskRecurrenceInfo — Task information
      - `schedule` 'None' | 'Daily' | 'Weekdays' | 'Weekly' | 'Monthly' | 'Yearly' — Recurrence settings of a task. None for non-periodic tasks
      - `endingCondition` 'None' | 'Count' | 'Date' — Ending condition of a task
      - `endingAfter` integer — Count of iterations of periodic tasks
      - `endingOn` string, date-time — End date of a periodic task in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format, UTC time zone
    - `attachments` TaskAttachment[]
      - `id` string — File ID.
      - `type` 'File' — Possible value - File. Attachment type (currently, only File is possible)
      - `name` string — Name of the attached file (incl. extension name)
      - `contentUri` string, uri — URI
  - `navigation` TMNavigationInfo
    - `prevPageToken` string — Previous page token. To get previous page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens
    - `nextPageToken` string — Next page token. To get next page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens

## Other responses

- `400` — Invalid input parameter(-s)
- `403` — Forbidden
- `404` — Task with the specified ID does not exist

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)