Modify Time Logs API

This API is used to edit a specific time log.

Request URL:

https://people.zoho.com/people/api/timetracker/edittimelog?timeLogId=<timeLogId>&user= <user>&workDate =<workDate>&jobId =<jobId>&hours=<hours>&fromTime=<fromTime>&toTime=<toTime>&billingStatus =<billingStatus>&description =<description>&workItem=<workItem>​

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.timetracker.ALL
OR
ZOHOPEOPLE.timetracker.UPDATE 

Possible Operation Types:

ALL - Complete access to data
UPDATE - Only to update data

Request parameter:

ParametersValues AllowedDefault ValueDescription
*timeLogId<timeLogId><Mandatory>Specify the timelog Id whose details needs to be modified
user< ERECNO | Email-ID | Employee-ID ><Mandatory>Specify the user
jobId<jobId >-Specify the job Id if needed to be modified.
workDate<date in yyyy-MM-dd/company dateformat>-Specify the workdate if needed to be modified.
dateFormat<dateformat>yyyy-MM-ddSpecify the date format. If not specified, yyyy-MM-dd format will be taken
billingStatus<billable|non-billable>-Specify the billable status if needed
hours<hours in decimal/time format>-Decimal-2.5 or Time format-2:30
fromTime<time in timeformat>-Time format-2:30PM or 14:30
toTime<time in timeformat>-Time format-2:30PM or 14:30
workItem<workitem>-Specify the workitem
description<description>-Specify the description

Error Codes & Messages:

Error CodeError Message
8000No parameter specified
8002Wrong format for parameter
8001Wrong value for parameter
7038Permission denied
8008Cannot log time during Weekend/Holidays/Leave

 

Messages
Error in modifying data
Manual Log is disabled in Settings. Contact your Administrator.
Cannot log time for a Future Date
Cannot log time for a Past Date 
You can log time only for the past 7 days
Unable to add/modify time log. Logged hours should not exceed 24 hours per day.
Logged-in user alone can start timer
Error in adding/modifying Timelog.Logged Hours is greater than maximum billable hours allowed per day
Cannot log time beyond attendance hours
Error in adding/modifying Timelog.Logged Hours is greater than Estimated hours

Success Response Format

{
    "response": {
        "result": [
            {
                "timeLogId": <timelogId>
            }
        ],
        "message": "Timelog entry modified Successfully",
        "uri": "/api/timetracker/edittimelog",
        "status": 0
    }
}

Error Response Format

{
  "response": {
    "message": < message >,
   "uri": "/api/timetracker/edittimelog",
    "errors": [
      {
        "code": < error_code >,
        "message": < error_message >
      }],
    "status": 1
  }

Threshold Limit: 20 requests | Lock period: 5 minutes

Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.

Sample Request

JsonXML
Copiedhttps://people.zoho.com/people/api/timetracker/edittimelog?timeLogId=177402000000814321&workItem=designing&user=49268800000013&billingStatus=Billable&hours=10

Copiedhttps://people.zoho.com/people/api/timetracker/edittimelog?timeLogId=<timeLogId>&user= <user>&workDate =<workDate>&jobId =<jobId>&hours=<hours>&fromTime=<fromTime>&toTime=<toTime>&billingStatus =<billingStatus>&description =<description>&workItem=<workItem>

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

JsonXML
Copied{
    "response": {
        "result": [
            {
                "timeLogId": "469505000000265027"
            }
        ],
        "message": "Timelog entry modified Successfully",
        "uri": "/api/timetracker/edittimelog",
        "status": 0
    }
}
Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/edittimelog">
   <status>0</status>
   <message>Timelog entry modified Successfully</message>
   <result>
      <timeLogId>469505000000265027</timeLogId>
   </result>
</response>