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
- 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
- Specifies the unique identifier assigned to each task.
- This parameter can be retrieved from the Get All Tasks in a Group API.
* - 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"
}
]
}
}