PUT - Change Task Description

Purpose

This API is used to change the description of a particular task.

OAuth Scope

Use the scope

ZohoMail.tasks.ALL (or) ZohoMail.tasks.UPDATE

to generate the Authtoken.

ALL - Full access to tasks.

UPDATE - Update a particular task's description.

Request URL

Method: PUT

Group Task:

https://mail.zoho.com/api/tasks/groups/{zgid}/{taskId}

or

Personal Task:

https://mail.zoho.com/api/tasks/me/{taskId}

Path Parameters

  • zgid* long
    • Specifies the unique identifier used for groups in an organization.
    • This parameter can be retrieved from the Get all groups API.
  • taskId* long

Request Body ( JSON Object)

  • description* string
    • Provide the new description which you want to give the task.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

CopiedGroup Task:

curl "https://mail.zoho.com/api/tasks/groups/5******048/48184******91002" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"\
-d '{
 "description": "ChangedDescription"
 }'

Personal Task:

curl "https://mail.zoho.com/api/tasks/me/4818******00091002" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"\
-d '{
 "description": "ChangedDescription"
 }'