Zoho Projects API for Developers

Tasklists API for Developers

How to Add a Tasklist ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/add

API Description :

Given authtoken creates a new tasklist on successful authentication.

Parameters to be passed :

authtoken, tasklist name, milestoneid, projectid and flag

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/add?authtoken=[AuthToken]">
Project Id<input type="text" name="projId" value="">
Milestone Id<input type="text" name="mStone" value="">
TaskList Title<input type="text" name="tasklist" value="New Tasklist">
Flag<input type="text" name="flag" value="">(internal or external)
<input type="submit" value="Add TaskList">
</form>

Output XML

<response>
   <uri>/api/private/xml/tasklist/add</uri>
   <result>
   <TaskListDetails>
   <TaskListDetail>
   <todolist_id> iU2Ms49a5vrqvw0A2+Ki37g==</todolist_id>
   <todolist_title>APIrelease</todolist_title>
   <Mile_id> iU2Ms49a5vhjkw0A2+Ki37g==</Mile_id>
   <iscompleted>false</iscompleted>
   <listposttime> yyyy-mm-dd HH:MM:SS </listposttime>
   <isrolled>false</isrolled>
   <listsequence>1</listsequence>
   <tlistcriteria>allflag</tlistcriteria>
   <isgeneral>false</isgeneral>
   <islistrolled>false</islistrolled>
   <tlisttype>Work</tlisttype>
   <priority>None</priority>
   </TaskListDetail>
   </TaskListDetails>
   </result>
   </response>

Output JSON

{response:{uri:'/api/private/json/tasklist/add',result:{tasklistdetails:{tasklistdetail:{todolist_id:'iU2Ms49a5vrqvw0A2+Ki37g==',
todolist_title:'APIrelease',mile_id:'iU2Ms49a5vhjkw0A2+Ki37g==',iscompleted:'false',listposttime:'yyyy-mm-ddHH:MM:SS',isrolled:'false',
listsequence:1,tlistcriteria:'allflag',isgeneral:'false',islistrolled:'false',tlisttype:'Work',priority:'None'}}}}}

How to Get All Tasklists ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklists

API Description :

Given the authtoken, returns all the tasklists on successful authentication.

Parameters to be passed :

authtoken, projid, flag, auditIndex, range

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklists?authtoken=[AuthToken]">
<input type="hidden" name="projId" value="">
<input type="hidden" name="flag" value="">(allflag or internal or external)
<input type="hidden" name="auditIndex" value="">
<input type="hidden" name="range" value="">
<input type="submit" value="Get Project TaskLists">
</form>

Output XML

<response>
   <uri>/api/private/xml/tasklists</uri>
   <result>
   <TaskListDetails>
   <TasklistDetail>
   <todolist_id>iU2Ms49b5vrqvw0A2+Ki37g==d></todolist>
   <todolist_title>API Release Test Cases</todolist_title>
   <Mile_id> iU2Ms49a5vrrfb0A2+Ki37g==</Mile_id>
   <iscompleted>false</iscompleted>
   <listposttime> yyyy-mm-dd HH:MM:SS </listposttime>
   <isrolled>false</isrolled>
   <listsequence>2</listsequence>
   <tlistcriteria>internal</tlistcriteria>
   <isgeneral>true</isgeneral>
   <islistrolled>false</islistrolled>
   <tlisttype>Work</tlisttype>
   <priority>None</priority>
   </TasklistDetail>
   <TasklistDetail>
   <todolist_id> iU2Ms49a5vrqvw023-Ki37g== </todolist_id>
   <todolist_title>APIrelease UseCases</todolist_title>
   <Mile_id> iU2Ms49a5vrqvw0A2+Ki37g==</Mile_id>
   <iscompleted>false</iscompleted>
   <listposttime> yyyy-mm-dd HH:MM:SS</listposttime>
   <isrolled>false</isrolled>
   <listsequence>1</listsequence>
   <tlistcriteria>allflag</tlistcriteria>
   <isgeneral>false</isgeneral>
   <islistrolled>false</islistrolled>
   <tlisttype>Work</tlisttype>
   <priority>None</priority>
   </TasklistDetail>
   </TaskListDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/tasklists',result:{tasklistdetails:{tasklistdetail:{todolist_id:{value:'iU2Ms49b5vrqvw0A2+Ki37g==d',
todolist_title:'APIReleaseTestCases',mile_id:'iU2Ms49a5vrrfb0A2+Ki37g==',
iscompleted:'false',listposttime:'1255804199000',isrolled:'false',
listsequence:2,tlistcriteria:'internal',isgeneral:'true',islistrolled:'false',tlisttype:'Work',priority:'None',
tasklistdetail:{todolist_id:'iU2Ms49a5vrqvw023-Ki37g==',todolist_title:'APIreleaseUseCases',mile_id:'iU2Ms49a5vrqvw0A2+Ki37g==',
iscompleted:'false',listposttime:'yyyy-mm-dd HH:MM:SS',isrolled:'false',listsequence:1,tlistcriteria:'allflag',
isgeneral:'false',islistrolled:'false',tlisttype:'Work',priority:'None'}}}}}}}

How to Edit a Tasklist ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/update

API Description :

Given the authtoken and the Tasklistid edits the tasklist on successful authentication.

Parameters to be passed :

authtoken, tasklistid, tasklist, related milestoneid, projectid, flag, status

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/update?authtoken=[AuthToken]">
Task List Title<input type="text" name="tasklist" value="updated thro API">
Milestone Id<input type="text" name="mStone" value="">
Project Id<input type="text" name="projId" value="">
Flag<input type="text" name="flag" value="">(internal or external)
TaskList Id<input type="text" name="taskid" value="">
Status<input type="text" name="status" value="completed">(active or completed)
<input type="submit" value="Edit TaskList">
</form>

Output XML

<response>
   <uri>/api/private/xml/tasklist/update</uri>
   <result>
   <TaskListDetails>
   <TasklistDetail>
   <todolist_id> iU2Ms49adfgevw0A2+Ki37g== </todolist_id>
   <todolist_title>updated thro API</todolist_title>
   <Mile_id> iU2Ms49a5vrddw0A2+Ki37g==</Mile_id>
   <iscompleted>true</iscompleted>
   <listposttime>yyyy-mm-dd HH:MM:SS</listposttime>
   <isrolled>false</isrolled>
   <listsequence>1</listsequence>
   <tlistcriteria>allflag</tlistcriteria>
   <isgeneral>false</isgeneral>
   <islistrolled>false</islistrolled>
   <tlisttype>Work</tlisttype>
   <priority>None</priority>
   </TasklistDetail>
   </TaskListDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/tasklist/update',result:{tasklistdetails:{tasklistdetail:{todolist_id:'iU2Ms49adfgevw0A2+Ki37g==',
todolist_title:'updatedthroAPI',mile_id:'iU2Ms49a5vrddw0A2+Ki37g==',iscompleted:'true',listposttime:yyyy-mm-dd HH:MM:SS,
isrolled:'false',listsequence:1,tlistcriteria:'allflag',isgeneral:'false',islistrolled:'false',tlisttype:'Work',priority:'None'}}}}}

How to Delete a Tasklist ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/delete

API Description :

Given authtoken and the tasklistId, will delete the tasklist on successful authentication.

Parameters to be passed :

authtoken, taskid, projId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasklist/delete?authtoken=[AuthToken]">
TaskListId to delete <input type="text" name="taskid" value="iU2Ms49adfgevw0A2+Ki37g==">
ProjId<input type="text" value="" name="projId">
<input type="submit" value="Delete TaskList">
</form>

Output XML

<result>Deleted Successfully</result>

Output JSON

{result:'Deleted Successfully'}

How to Get All Tasks ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasks

API Description :

Given the authtoken, returns all tasks on successful authentication.

Parameters to be passed :

authtoken, projId, flag, uname, mstatus, dispType

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/tasks?authtoken=[AuthToken]">
Project Id:<input type="hidden" name="projId" value="">
Flag:<input type="hidden" name="flag" value="allflag">
User:<input type="text" name="uname" value="">(all or AnyUser or userid)
Milestone status<input type="text" name="mstatus" value="notcompleted">(or completed)
Display Type<input type="text" name="dispType" value="upcoming">(or delayed or misc)
<input type="submit" value="Get Project Tasks">
</form>

Output XML

<response>
   <uri>/api/private/xml/tasks</uri>
   <result>
   <TaskDetails>
   <TaskDetail>
   <todolistitem_id>4DnPGEgICKlPMgQaLmHNmg==</todolistitem_id>
   <todolistitem_title>Adding API Task</todolistitem_title>
   <Tasklist_id>4DnPGEgICKn7MQxO481y8w==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>Medium</priority>
   <pcompletion>20</pcompletion>
   <todolistitem_Startdate>yyyy-mm-dd HH:MM</todolistitem_Startdate>
   <todolistitem_Enddate>yyyy-mm-dd HH:MM</todolistitem_Enddate>
   <todolistitem_duration>3</todolistitem_duration>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>

   <TaskDetail>
   <todolistitem_id>4DnPGEgICKkE8IVf4aUwzg==</todolistitem_id>
   <todolistitem_title>Task updated </todolistitem_title>
   <Tasklist_id>4DnPGEgICKn7MQxO481y8w==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>High</priority>
   <pcompletion>20</pcompletion>
   <todolistitem_Startdate>yyyy-mm-dd HH:MM</todolistitem_Startdate>
   <todolistitem_Enddate>yyyy-mm-dd HH:MM</todolistitem_Enddate>
   <todolistitem_duration>2</todolistitem_duration>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>

   <TaskDetail>
   <todolistitem_id>4DnPGEgICKnDjAZ2cmz6dQ==</todolistitem_id>
   <todolistitem_title>Releasing API</todolistitem_title>
   <Tasklist_id>4DnPGEgICKmQYHh6dx9NpQ==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>None</priority>
   <pcompletion>0</pcompletion>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>

   <TaskDetail>
   <todolistitem_id>4DnPGEgICKn/SNSlOwGMug==</todolistitem_id>
   <todolistitem_title>All Milestones list</todolistitem_title>
   <Tasklist_id>4DnPGEgICKng5jJNeTVJEQ==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>None</priority>
   <pcompletion>0</pcompletion>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>

   <TaskDetail>
   <todolistitem_id>4DnPGEgICKll4fEWFTUWDg==</todolistitem_id>
   <todolistitem_title>task API </todolistitem_title>
   <Tasklist_id>4DnPGEgICKn49UIu8BKo8g==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>None</priority>
   <pcompletion>20</pcompletion>
   <todolistitem_Startdate>yyyy-mm-dd HH:MM</todolistitem_Startdate>
   <todolistitem_Enddate>yyyy-mm-dd HH:MM</todolistitem_Enddate>
   <todolistitem_duration>1</todolistitem_duration>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/tasks',result:{taskdetails:{value:'−n',taskdetail:[{todolistitem_id:'4DnPGEgICKlPMgQaLmHNmg==',
todolistitem_title:'AddingAPITask',tasklist_id:'4DnPGEgICKn7MQxO481y8w==',iscompleted:'false',priority:'Medium',
pcompletion:20,todolistitem_startdate:yyyy-mm-dd HH:MM,todolistitem_enddate:yyyy-mm-dd HH:MM,todolistitem_duration:3,
todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='},{todolistitem_id:'4DnPGEgICKkE8IVf4aUwzg==',
todolistitem_title:'Taskupdated',tasklist_id:'4DnPGEgICKn7MQxO481y8w==',
iscompleted:'false',priority:'High',pcompletion:20,todolistitem_startdate:yyyy-mm-dd HH:MM:SS,todolistitem_enddate:yyyy-mm-dd HH:MM,todolistitem_duration:2,todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='},
{todolistitem_id:'4DnPGEgICKnDjAZ2cmz6dQ==',todolistitem_title:'ReleasingAPI',
tasklist_id:'4DnPGEgICKmQYHh6dx9NpQ==', iscompleted:'false',priority:'None',pcompletion:0,
todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='},
{todolistitem_id:'4DnPGEgICKn/SNSlOwGMug==',
todolistitem_title:'AllMilestoneslist',tasklist_id:'4DnPGEgICKng5jJNeTVJEQ==',
iscompleted:'false',priority:'None',pcompletion:0,
todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='},
{todolistitem_id:'4DnPGEgICKll4fEWFTUWDg==',todolistitem_title:'taskAPI',tasklist_id:'4DnPGEgICKn49UIu8BKo8g==',
iscompleted:'false',priority:'None',pcompletion:20,
todolistitem_startdate:yyyy-mm-dd HH:MM:SS,todolistitem_enddate:yyyy-mm-dd HH:MM,
todolistitem_duration:1,todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='}]}}}}

How to Get Task Details ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/content

API Description :

Given authtoken, and the taskid returns the task details on successful authentication.

Parameters to be passed :

authtoken, taskid

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/content?authtoken=[AuthToken]">
<input type="text" value="" name="projId">
<input type="text" value="" name="taskid">
<input type="submit" value="Get Task Content">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/content</uri>
   <result>
   <TaskDetails>
   <TaskDetail>
   <todolistitem_id>4DnPGEgICKn/SNSlOwGMug==</todolistitem_id>
   <todolistitem_title>Releasing API</todolistitem_title>
   <Tasklist_id>4DnPGEgICKng5jJNeTVJEQ==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>None</priority>
   <pcompletion>90%</pcompletion>
   <todolistitem_owner>Kannan.S</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>
   </TaskDetails>
   </result>
   </response>

Output JSON

{response:{uri:'/api/private/json/task/content',result:{taskdetails:{taskdetail:{todolistitem_id:'4DnPGEgICKn/SNSlOwGMug==',
todolistitem_title:'ReleasingAPI',tasklist_id:'4DnPGEgICKng5jJNeTVJEQ==',
iscompleted:'false',priority:'None',pcompletion:'90%',
todolistitem_owner:'Kannan.S',todolistitem_owner_zuid:'164C+ovuxfI='}}}}}

How to Add Task ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/add

API Description :

Given the authtoken and task details creates a new task and returns the same on successful authentication.

Parameters to be passed :

authtoken, projId, owner, listid, todotask, taskdate, percentcomplete, duration, priority

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/add?authtoken=[AuthToken]"> Project Id<input type="text" name="projId" value="">
Owner<input type="text" name="personresponsible" value="">(loginid/userid)
TaskListId<input type="text" name="listId" value="">
Task Name<input type="text" name="todotask" value="">
Task Date<input type="text" name="taskdate" value="">(date format MM-dd-yyyy)
Percent complete<input type="text" name="pcomplete" value="">
Duration<input type="text" name="duration" value="">
Priority<input type="text" name="priority" value="">(None/Low/High/Medium)
<input type="submit" value="Add New Task">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/add</uri>
   <result>
   <TaskDetails>
   <TaskDetail>
   <todolistitem_id>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_id>
   <todolistitem_title>Adding New Task</todolistitem_title>
   <Tasklist_id>4DnPGEgICKlo4SsiF1YI5A==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>Medium</priority>
   <pcompletion>20</pcompletion>
   <todolistitem_Startdate>yyyy-mm-dd HH:MM:SS</todolistitem_Startdate>
   <todolistitem_Enddate>yyyy-mm-dd HH:MM:SS</todolistitem_Enddate>
   <todolistitem_duration>1</todolistitem_duration>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/add',result:{taskdetails:{taskdetail:{todolistitem_id:'4DnPGEgICKkPM/2pHV67yQ==',
todolistitem_title:'AddingNewTask',tasklist_id:'4DnPGEgICKlo4SsiF1YI5A==',iscompleted:'false',
priority:'Medium',pcompletion:20,todolistitem_startdate:yyyy-mm-dd HH:MM,todolistitem_enddate:yyyy-mm-dd HH:MM,
todolistitem_duration:1,todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='}}}}}

How to Delete Task ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/delete

API Description :

Given authtoken and taskid, removes the particular task on successful authentication.

Parameters to be passed :

authtoken, taskid, projid, tasktitle

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/delete?authtoken=[AuthToken]">
Task Id<input type="text" value="" name="taskid">
ProjId<input type="text" value="" name="projId">
<input type="submit" value="Delete Task">
</form>

Output XML

<result>Deleted Successfully</result>

Output JSON

{result:'Deleted Successfully'}

How to Update a Task ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/update

API Description :

Given authtoken and one of the taskids the task will be updated on successful authentication.

Parameters to be passed :

authtoken, taskId, projid, owner, taskname, taskdate, duration, priority

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/update?authtoken=[AuthToken]">
Project Id<input type="text" name="projId" value="">
Owner<input type="text" name="personresponsible" value="">(loginid/userid)
Task Name<input type="text" name="todotask" value="">
Task Date<input type="text" name="taskdate" value="">(date format MM-dd-yyyy)
Task Id<input type="text" name="taskid" value=""> Percent complete<input type="text" name="pcomplete" value="">
Duration<input type="text" name="duration" value="">
Priority<input type="text" name="priority" value="">(None,Low,Medium,High)
<input type="submit" value="Update Task">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/update</uri>
   <result>
   <TaskDetails>
   <TaskDetail>
   <todolistitem_id>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_id>
   <todolistitem_title>Updated Task</todolistitem_title>
   <Tasklist_id>4DnPGEgICKlo4SsiF1YI5A==</Tasklist_id>>
   <iscompleted>false</iscompleted>
   <priority>Medium</priority>
   <pcompletion>20</pcompletion>
   <todolistitem_Startdate>yyyy-mm-dd HH:MM</todolistitem_Startdate>
   <todolistitem_Enddate>yyyy-mm-dd HH:MM</todolistitem_Enddate>
   <todolistitem_duration>1</todolistitem_duration>
   <todolistitem_owner>suchitra</todolistitem_owner>
   <todolistitem_owner_zuid>164C+ovuxfI=</todolistitem_owner_zuid>
   </TaskDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/update',result:{taskdetails:{taskdetail:{todolistitem_id:'4DnPGEgICKkPM/2pHV67yQ==',
todolistitem_title:'UpdatedTask',tasklist_id:'4DnPGEgICKlo4SsiF1YI5A==',iscompleted:'false',priority:'Medium',
pcompletion:20,todolistitem_startdate:yyyy-mm-ddHH:MM,todolistitem_enddate:yyyy-mm-dd HH:MM,
todolistitem_duration:1,todolistitem_owner:'suchitra',todolistitem_owner_zuid:'164C+ovuxfI='}}}}}

How to Add Notes ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/addnotes

API Description :

Given authtoken, notes and taskid the task will be updated on successful authentication.

Parameters to be passed :

authtoken, notes, taskId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/addnotes?authtoken=[AuthToken]">
Task Id<input type="text" name="taskid" value="">
Task Notes <textarea name="alinknotes" rows="4" cols="16"></textarea>
<input type="submit" value="Add Notes">
</form>

Output XML

<response uri="/api/private/xml/task/addnotes">
   <result>
   <TaskDetails>
   <TaskDetail>
   <todolistitem_id> iU2Ms49a5vjklvw0A2+Ki37g==</todolistitem_id>
   <todolistitem_title>Task1</todolistitem_title>
   <Tasklist_id> iU2Ms49a5vrwer0A2+Ki37g==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>None</priority>
   <TaskNotesDetail>
   <todolistitem_tasknoteid> iU2Ms23h5vrqvw0A2+Ki37g==</todolistitem_tasknoteid>
   <todolistitem_tasknotes>Notes added in Task. </todolistitem_tasknotes>
   <todolistitem_taskid> iU2Ms49a5vrqvw0wer+Ki37g==</todolistitem_taskid>
   <todolistitem_notecreatedtime> yyyy-mm-dd HH:MM</todolistitem_notecreatedtime>
   <todolistitem_noteaddedby>Ufgejwe</todolistitem_noteaddedby>
   <todolistitem_noteupdatedby>Ufgejwe</todolistitem_noteupdatedby>
   </TaskNotesDetail>
   </TaskDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/addnotes',result:{taskdetails:{taskdetail:{todolistitem_id:'iU2Ms49a5vjklvw0A2+Ki37g==',
todolistitem_title:'Task1',tasklist_id:'iU2Ms49a5vrwer0A2+Ki37g==',iscompleted:'false',priority:'None',
tasknotesdetail:{todolistitem_tasknoteid:'iU2Ms23h5vrqvw0A2+Ki37g==',todolistitem_tasknotes:'NotesaddedinTask.',
todolistitem_taskid:'iU2Ms49a5vrqvw0wer+Ki37g==',todolistitem_notecreatedtime:'yyyy-mm-dd HH:MM',
todolistitem_noteaddedby:'Ufgejwe',todolistitem_noteupdatedby:'Ufgejwe'}}}}}}

How to Associate a Document ?

Method Name :

https://projectsapi.zoho.com/portal/[PortalName]/api/private/xml/task/addtskdocs

API Description :

Given authtoken, docid and taskid the task will be associated with a document on successful authentication.

Parameters to be passed :

authtoken, taskid, docid

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/[PortalName]/api/private/xml/task/addtskdocs?authtoken=[AuthToken]"> Task Id<input type="text" name="taskid" value="">
Document Id<input type="text" name="docid" value="">
<input type="submit" value="Add Docs">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/addtskdocs</uri>
   <result>
   <TaskDetails>
   <TaskDocDetail>
   <todolistitem_taskdocid>4DnPGEgICKkH0fFKhPzIeQ==</todolistitem_taskdocid>
   <todolistitem_taskid>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_taskid>
   </TaskDocDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/addtskdocs',result:{taskdetails:{taskdocdetail:{todolistitem_taskdocid:'4DnPGEgICKkH0fFKhPzIeQ==',todolistitem_taskid:'4DnPGEgICKkPM/2pHV67yQ=='}}}}}

How to Associate a Message/Forum Post ?

Method Name :

https://projectsapi.zoho.com/portal/[PortalName]/api/private/xml/task/addtskfrm

API Description :

Given authtoken, docid and taskid. The task will be associated with a document on successful authentication.

Parameters to be passed :

authtoken, forum, taskId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/[PortalName]/api/private/xml/task/addtskfrm?authtoken=[AuthToken]">
Task Id<input type="text" name="taskid" value="">
MessageId<input type="text" name="forumid" value="">
<input type="submit" value="Add Docs">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/addtskfrm</uri>
   <result>
   <TaskDetails>
   <TaskForumsDetail>
   <todolistitem_taskmessageid>4DnPGEgICKm7QJvRIls/jA==</todolistitem_taskmessageid>
   <todolistitem_taskid>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_taskid>
   </TaskForumsDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/addtskfrm',result:{taskdetails:{value:'−n',taskforumsdetail:{todolistitem_taskmessageid:'4DnPGEgICKm7QJvRIls/jA==',
todolistitem_taskid:'4DnPGEgICKkPM/2pHV67yQ=='}}}}}

How to Fetch Documents Associated with a Task ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/gettskdocs

API Description :

Given the authtoken and taskid, the task will be associated with a document on successful authentication.

Parameters to be passed :

authtoken, notes, taskId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/gettskdocs?authtoken=[AuthToken]">
Task Id<input type="text" name="taskid" value="">
<input type="submit" value="Get Task Docs" name="submit">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/gettskdocs</uri>
   <result>
   <TaskDetails>
   <TaskDocDetail>
   <todolistitem_taskdocid>4DnPGEgICKkH0fFKhPzIeQ==</todolistitem_taskdocid>
   <todolistitem_taskid>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_taskid>
   </TaskDocDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/gettskdocs',result:{taskdetails:{value:'−n',taskdocdetail:{todolistitem_taskdocid:'4DnPGEgICKkH0fFKhPzIeQ==',
todolistitem_taskid:'4DnPGEgICKkPM/2pHV67yQ=='}}}}}

How to Fetch Messages Associated with a Task ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/gettskfrm

API Description :

Given the authtoken and taskid returns the associated forums on successful authentication.

Parameters to be passed :

authtoken, notes, taskId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/gettskfrm?authtoken=[AuthToken]">
Task Id<input type="text" name="taskid" value="">
<input type="submit" value="Get Task Messages">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/gettskfrm</uri>
   <result>
   <TaskDetails>
   <TaskForumsDetail>
   <todolistitem_taskmessageid>4DnPGEgICKm7QJvRIls/jA==</todolistitem_taskmessageid>
   <todolistitem_taskid>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_taskid>
   </TaskForumsDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/gettskfrm',result:{taskdetails:{taskforumsdetail:{todolistitem_taskmessageid:'4DnPGEgICKm7QJvRIls/jA==',
todolistitem_taskid:'4DnPGEgICKkPM/2pHV67yQ=='}}}}}

How to Delete Notes ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/delnotes

API Description :

Given the authtoken, notesid the notes will be deleted on successful authentication.

Parameters to be passed :

authtoken, noteId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/delnotes?authtoken=[AuthToken]">
NotesId<input type="text" name="noteid" value="">
<input type="submit" value="Delete Notes">
</form>

Output XML

<result>Deleted Successfully</result>

Output JSON

{result:'Deleted Successfully'}

How to Fetch Notes ?

Method Name :

https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/getnotes

API Description :

Given the authtoken, taskid gets the notes associated with the task on successful authentication.

Parameters to be passed :

authtoken, taskid

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/task/getnotes?authtoken=[AuthToken]">
Task Id<input type="text" name="taskid" value="">
<input type="submit" value="Get Notes">
</form>

Output XML

<response>
   <uri>/api/private/xml/task/getnotes</uri>
   <result>
   <TaskDetails>

   <TaskDetail>
   <todolistitem_id>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_id>
   <todolistitem_title>Add New Task</todolistitem_title>
   <Tasklist_id>4DnPGEgICKlo4SsiF1YI5A==</Tasklist_id>
   <iscompleted>false</iscompleted>
   <priority>Medium</priority>
   <pcompletion>20</pcompletion>

   <TaskNotesDetail>
   <todolistitem_tasknoteid>4DnPGEgICKkRADG5O7KB6w==</todolistitem_tasknoteid>
   <todolistitem_tasknotes>notes for task.It can be used as a release</todolistitem_tasknotes>
   <todolistitem_taskid>4DnPGEgICKkPM/2pHV67yQ==</todolistitem_taskid>
   <todolistitem_notecreatedtime>yyyy-mm-dd HH:MM</todolistitem_notecreatedtime>
   <todolistitem_noteaddedby>164C+ovuxfI=</todolistitem_noteaddedby>
   <todolistitem_noteupdatedby>164C+ovuxfI=</todolistitem_noteupdatedby>
   </TaskNotesDetail>
   </TaskDetail>
   </TaskDetails>
   </result>
</response>

Output JSON

{response:{uri:'/api/private/json/task/gettskfrm',result:{taskdetails:{taskforumsdetail:{todolistitem_taskmessageid:'4DnPGEgICKm7QJvRIls/jA==',
todolistitem_taskid:'4DnPGEgICKkPM/2pHV67yQ=='}}}}}

Top

Features
Resources
Popular links
Recent Blog Posts
Spread the Word

© 2013, ZOHO Corp. All rights reserved,
Project Management Software, 4900 Hopyard Rd, Suite 310, Pleasanton, CA 94588, USA Support: +1 888-900-9646 | Sales: +1 888-204-3539