Tasks API

The Tasks API facilitates the retrieval of tasks assigned to you, tasks added to a group, and enables task addition and management, etc.

While using any API related to tasks, make use of the OAuth scope ZohoMail.tasks.

Method NameURLMethod TypeOAuth ScopePurpose
Add a new group or personal taskGroup tasks:
/api/tasks/groups/{zgid}
POSTZohoMail.tasksTo add a new group/personal task.
Personal tasks:
/api/tasks/me
Add a new project/api/tasks/groups/{zgid}/projectsPOSTTo add a new project.
Get all tasks in a group or all personal tasksGroup tasks:
/api/tasks/groups/{zgid}
GETTo get all the tasks added to a group or your personal tasks.
Personal tasks:
/api/tasks/me
Get all tasks assigned to you/api/tasksGETTo get all the tasks assigned to you.
Get all tasks created by you/api/tasksGETTo get all the tasks created by you.
Get a specific taskGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
GETTo get a particular task's details.
Personal tasks:
/api/tasks/me/{taskId}
Get all subtasks under a taskGroup tasks:
/api/tasks/groups/{zgid}/{taskId}/subtasks
GETTo get all subtasks under a specific task.
Personal tasks:
/api/tasks/me/{taskId}/subtasks
Get all projects in a group/api/tasks/groups/{zgid}/projectsGETGet all the projects created in a group.
Get all tasks in a project/api/tasks/groups/{zgid}/projects/{projectId}GETTo get all tasks under a specific project.
Get all tasks in a project with given status/api/tasks/groups/{zgid}/projects/{projectId}GETTo get all tasks in a project with the specified status.
Get all groups/api/tasks/groupsGETGet all the group details.
Get all tasks in a group with given status/api/tasks/groups/{zgid}GETTo get all tasks with the specified status.
Get member details in a group/api/tasks/groups/{zgid}/membersGETGet the details of all members in a group.
Change task titleGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the title of a task.
Personal tasks:
 /api/tasks/me/{taskId}
Change task descriptionGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the description of a task.
Personal tasks:
 /api/tasks/me/{taskId}
Change task priorityGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the priority of a task.
Personal tasks:
 /api/tasks/me/{taskId}
Change task statusGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the status of a task.
Personal tasks:
 /api/tasks/me/{taskId}
Change task projectGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the project under which a task is added.
Personal tasks:
/api/tasks/me/{taskId}
Change task assigneeGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo change the member to whom the task is assigned.
Personal tasks:
 /api/tasks/me/{taskId}
Set/ change task due dateGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo set or change the due date of a task.
Personal tasks:
 /api/tasks/me/{taskId}
Set/ change task reminderGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo set or change the reminding date for a task.
Personal tasks:
 /api/tasks/me/{taskId}
Set/ change task reminder based on due dateGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo set or change the reminding date few days prior to the due date.
Personal tasks:
 /api/tasks/me/{taskId}
Set/ change recurring taskGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
PUTTo set or change the recurrence pattern of the task.
Personal tasks:
/api/tasks/me/{taskId}
Edit a project/api/tasks/groups/{zgid}/projects/{projectId}PUTEdit the name of a project.
Delete a project/api/tasks/groups/{zgid}/projects/{projectId}DELETEDelete a project.
Delete a group/personal taskGroup tasks:
/api/tasks/groups/{zgid}/{taskId}
DELETEDelete a task from a group or a personal task.
Personal tasks:
/api/tasks/me/{taskId}