Zoho Projects API for Developers

Tasklists API

All Tasklists
GET  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/
Create Tasklist
POST  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/
Update Tasklist
POST  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/[TASKLISTID]/
Delete Tasklist
DELETE /portal/[PORTALID]/projects/[PROJECTID]/tasklists/[TASKLISTID]/

All Tasklists

GET  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/

Gets all the tasklists in the given project.

Request Parameters

index int Index number of the tasklist.
range int Range of the tasklists.
flag* String Tasklists of the flag must be internal or external.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"tasklists": [{
"id": 170876000000270053,
"name": "ERP Phase III",
"milestone": {
"id": 170876000000366021,
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/"
},
"status": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/status/"
}
},
"name": "Accounts Receivables",
"owner_name": "Jasmine Frank",
"owner_id": "2060559",
"flag": "internal",
"start_date": "04-01-2014 12:00 AM",
"start_date_long": 1396319400000,
"end_date": "04-30-2014 12:00 AM",
"end_date_long": 1398825000000,
"status": "notcompleted"
},
"completed": false,
"created_time": "09-18-2012 10:40 AM",
"created_time_long": 1347973813551,
"rolled": false,
"sequence": 1,
"view_type": "internal",
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000000270053/"
},
"task": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000000270053/tasks/"
}
}
}]
}

Create Tasklist

POST  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/

Creates the tasklist.

Request Parameters

milestone_id Long ID of the milestone.
name* String Name of of the tasklist.
flag* String Tasklist flag must be internal or external.

Sample Response

Status: 201 Created
Content Type: application/json;charset=utf-8
{
"tasklists": [{
"id": 170876000001849029,
"name": "Ledger Redesign",
"milestone": {
"id": 170876000000366021,
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/"
},
"status": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/status/"
}
},
"name": "Accounts Receivables",
"owner_name": "Jasmine Frank",
"owner_id": "2060559",
"flag": "internal",
"start_date": "04-01-2014 12:00 AM",
"start_date_long": 1396319400000,
"end_date": "04-30-2014 12:00 AM",
"end_date_long": 1398825000000,
"status": "notcompleted"
},
"completed": false,
"created_time": "05-26-2014 12:28 PM",
"created_time_long": 1401116281721,
"rolled": false,
"sequence": 133,
"view_type": "internal",
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000001849029/"
},
"task": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000001849029/tasks/"
}
}
}]
}

Update Tasklist

POST  /portal/[PORTALID]/projects/[PROJECTID]/tasklists/[TASKLISTID]/

Updates the tasklist.

Request Parameters

milestone_id* Long ID of the milestone.
name* String Name of the tasklist.
flag* String Tasklist flag must be internal or external.
status* String Tasklist status must be active or completed.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"tasklists": [{
"id": 170876000001849029,
"name": "Ledger Redesign",
"milestone": {
"id": 170876000000366021,
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/"
},
"status": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/milestones/170876000000366021/status/"
}
},
"name": "Accounts Receivables",
"owner_name": "Jasmine Frank",
"owner_id": "2060559",
"flag": "internal",
"start_date": "04-01-2014 12:00 AM",
"start_date_long": 1396319400000,
"end_date": "04-30-2014 12:00 AM",
"end_date_long": 1398825000000,
"status": "notcompleted"
},
"completed": true,
"created_time": "05-26-2014 12:33 PM",
"created_time_long": 1401116597181,
"rolled": false,
"sequence": 1,
"view_type": "internal",
"link": {
"self": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000001849029/"
},
"task": {
"url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
170876000000147021/tasklists/170876000001849029/tasks/"
}
}
}]
}

Delete Tasklist

DELETE /portal/[PORTALID]/projects/[PROJECTID]/tasklists/[TASKLISTID]/

Deletes the tasklist.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"response": "Tasklist Deleted Successfully"
}

Top