GET - Get All Subtasks Under a Task

Purpose

This API is used to retrieve all the subtasks added within a particular task, providing details such as its ID, title, description, due date, owner, assignee, priority, status, project name, and ID under which it falls, etc.

OAuth Scope

Use the scope

ZohoMail.tasks.ALL (or) ZohoMail.tasks.READ

to generate the Authtoken.

ALL - Full access to tasks.

READ - Retrieve all the subtasks under a task.

Request URL

Method: GET

Group Task:

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

or

Personal Task:

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

Path Parameters

  • zgidlong
    • Specifies the unique identifier used for groups in an organization.
    • This parameter can be retrieved from the Get all groups API.
  • taskIdlong

 

* - 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/<53658048>/<4**091002>/subtasks" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Personal Task:

curl "https://mail.zoho.com/api/tasks/me/<4*****0091002>/subtasks" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Sample Response

CopiedGroup Tasks:
{
    "status": {
        "code": 200,
        "description": "success"
    },
    "data": {
        "tasks": [
            {
                "owner": {
                    "name": "Rebecca",
                    "id": 54136518
                },
                "modifiedTime": "2018-03-28T12:49:59+05:30",
                "attachments": [],
                "parentTask": {
                    "owner": {
                        "name": "Rebecca",
                        "id": 54136518
                    },
                    "modifiedTime": "2018-03-28T12:49:53+05:30",
                    "attachments": [],
                    "reminder": {
                        "dateTime": "2018-03-28T15:00:00+05:30",
                        "emailReminder": false,
                        "popupReminder": true
                    },
                    "dueDate": "28/03/2018",
                    "description": "",
                    "project": {
                        "name": "General",
                        "id": "48184000000006002"
                    },
                    "title": "Blogs",
                    "priority": "Normal",
                    "tags": [],
                    "createdAt": "2018-03-27T20:54:59+05:30",
                    "followers": [],
                    "namespaceId": "54224987",
                    "id": "48184000000091001",
                    "assignee": null,
                    "status": "In Progress"
                },
                "description": "",
                "project": {
                    "name": "General",
                    "id": "48184000000006002"
                },
                "title": "Testimonials",
                "priority": "Normal",
                "tags": [],
                "createdAt": "2018-03-28T12:49:59+05:30",
                "followers": [],
                "namespaceId": "54224987",
                "id": "48184000000092001",
                "assignee": null,
                "status": "In Progress"
            }
        ]
    }
}