Zoho Projects API for Developers
This API gets deprecated on September 30th, 2014. Our new REST API V 2.0 reference is here.

Timesheet API

How to Get Log Time ?

Method Name :

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

API Description :

Given the authtoken, projectId returns the user timelog on successful authentication.

Parameters to be passed :

authtoken, projId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/logs?authtoken=[AuthToken]">
Project Id<input type="text" name="projId" value=""/>
View by<input type="text" name="view" value=""/> (today|thisweek|thismonth|lastweek|lastmonth|yesterday) New
<input type="submit" value="Get User Timelog">
</form>

Output XML

<response>
   <uri>/api/private/xml/logs</uri>
   <result>
   <TimeLogDetails>
   <TimeLogDetail>
   <lognotes>Set budget template</lognotes>
   <logdate> yyyy-mm-dd HH:MM </logdate>
   <taskbilling>Non Billable</taskbilling>
   <loginname>John</loginname>
   <loghours>1.15</loghours>
   <login_uid>Mjh+pwI9Q5M=</login_uid>
   <task>Budget Review</task>
   <tlog_id>LRMRg7/jxbN7EVSI1Oco/A==</tlog_id>
   </TimeLogDetail>
   </TimeLogDetails>

   <TimeLogDetails>
   <TimeLogDetail>
   <lognotes>Seminar on cash flow reports</lognotes>
   <logdate> yyyy-mm-dd HH:MM</logdate>
   <taskbilling>Billable</taskbilling>
   <loginname>John</loginname>
   <loghours>3.20</loghours>
   <login_uid>Mjh+pwI9Q5M=</login_uid>
   <task>Seminar on cash flow reports</task>
   <tlog_id>LRMRg7/jxbNSMLnbTyax4Q==</tlog_id>
   </TimeLogDetail>
   </TimeLogDetails>
   </result>
</response>

Output JSON

{"response ":{"uri":"/api/private/json/logs","result":{"TimeLogDetails":[{"TimeLogDetail":{"lognotes":"Set Budget Templates",
"logdate":"yyyy-mm-dd HH:MM","taskbilling":"Non Billable","loginname":"John","loghours":"1.15",
"login_uid":"Mjh+pwI9Q5M=","task":"Budget Review","tlog_id":"LRMRg7/jxbN7EVSI1Oco/A=="}},
{"TimeLogDetail":{"lognotes":"Seminar on cash flow reports","logdate":"yyyy-mm-dd HH:MM","taskbilling":"Billable",
"loginname":"John","loghours":"3.20","login_uid":"Mjh+pwI9Q5M=",
"task":"Seminar on cash flow reports","tlog_id":"LRMRg7/jxbNSMLnbTyax4Q=="}}]}}}

How to Add Log Time ?

Method Name :

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

API Description :

Given the authtoken, projectId, logdate, taskid, hrs and notes logs the time on successful authentication.

Parameters to be passed :

authtoken, projectId, logdate, taskid, hours and notes

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/log/add?authtoken=[AuthToken]">
ProjectId<input type="text" name="projId" value=""/>
Log Date<input type="text" name="logdate" value="">(mm-dd-yyyy)
Log Taskid<input type="text" name="logtask" value="">
Log Hours<input type="text" name="loghours" value=""> (ex:0:23, 0:45)
Log Notes<input type="text" name="lognotes" value="">
Bill Status<input type="text" name="billsts" value="Billable">(or Non Billable)
<input type="submit" value="Add User Timelog">
</form>

Output XML

<response>
   <uri>/api/private/xml/log/add</uri>
   <result>
   <TimeLogDetails>
   <TimeLogDetail>
   <lognotes>Send this week's customer reports</lognotes>
   <logdate> yyyy-mm-dd HH:MM</logdate>
   <taskbilling>Billable</taskbilling>
   <task_id>LRMRg7/jxbPq/AIZspzgqw==</task_id>
   <loginname>John</loginname>
   <loghours>0.23</loghours>
   <login_uid>Mjh+pwI9Q5M=</login_uid>
   <tlog_id>LRMRg7/jxbMCKRPiBoHX7A==</tlog_id>
   </TimeLogDetail>
   </TimeLogDetails>
   </result>
</response>

Output JSON

{"response ":{"uri":"/api/private/json/log/add","result":{"TimeLogDetails":[{"TimeLogDetail":
{"lognotes":"Send this week's customer reports","logdate":"yyyy-mm-dd HH:MM","taskbilling":"Billable",
"task_id":"LRMRg7/jxbPq/AIZspzgqw==","loginname":"john","loghours":"0.23",
"login_uid":"Mjh+pwI9Q5M=","tlog_id":"LRMRg7/jxbM0SUo7XdevyA=="}}]}}}

How to Update Log Time ?

Method Name :

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

API Description :

Given the authtoken, projectId, logdate, taskid, hours, notes and logid on successful authentication.

Parameters to be passed :

authtoken, projId, logid, logtask, loghours and lognotes, billsts

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/log/update?authtoken=[AuthToken]">
ProjectId<input type="text" name="projId" value=""/>
Log Taskid<input type="text" name="logtask" value="">
Log Hours<input type="text" name="loghours" value="">(ex: 0:25, 0:45)
Log Notes<input type="text" name="lognotes" value="">
Log Id<input type="text" name="logid" value="">
Bill Status<input type="text" name="billsts" value="Billable">(or Non Billable)
<input type="submit" value="update user Timelog">
</form>

Output XML

<response>
   <uri>/api/private/xml/log/update</uri>
   <result>
   <TimeLogDetails>
   <TimeLogDetail>
   <lognotes>Send this week's customer reports to all as soon as possible</lognotes>
   <logdate> yyyy-mm-dd HH:MM</logdate>
   <taskbilling>Billable</taskbilling>
   <task_id>LRMRg7/jxbPq/AIZspzgqw==</task_id>
   <loginname>John</loginname>
   <loghours>0.35</loghours>
   <login_uid>Mjh+pwI9Q5M=</login_uid>
   <tlog_id>LRMRg7/jxbN79BZeIPxOYQ==</tlog_id>
   </TimeLogDetail>
   </TimeLogDetails>
   </result>
</response>

Output JSON

{"response ":{"uri":"/api/private/json/log/update","result":{"TimeLogDetails":[{"TimeLogDetail":{"lognotes":
"Send this week's customer reports to all as soon as possible","logdate":"yyyy-mm-dd HH:MM",
"taskbilling":"Billable","task_id":"LRMRg7/jxbPq/AIZspzgqw==","loginname":"John","loghours":"0.35",
"login_uid":"Mjh+pwI9Q5M=","tlog_id":"LRMRg7/jxbN79BZeIPxOYQ=="}}]}}}

How to Delete Log Time ?

Method Name :

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

API Description :

Given the authtoken, logId deletes the loghrs on successful authentication.

Parameters to be passed :

authtoken, logid, projId

Sample Call

<form method="post" action="https://projectsapi.zoho.com/portal/{PortalName}/api/private/xml/log/delete?authtoken=[AuthToken]">
ProjectId<input type="text" name="projId" value=""/>
LogId<input type="text" name="logid" value=""/>
<input type="submit" value="Delete Loghrs">
</form>

Output XML

<result>Deleted successfully</result>

Output JSON

{"result":"Deleted Successfully"}

Top