Modify Timesheet API

This API is used to modify timesheets.

Request URL:

https://people.zoho.com/people/api/timetracker/modifytimesheet?timesheetId=<timesheetId>&timesheetName=<timesheetName>&description=<description>&sendforApproval=<sendforApproval>&removeAttachment=<removeAttachment>

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 modify data

Request parameter:

Parameter	Values Allowed	Default Value	Description
*timesheetId	<Timesheet Id>	<Mandatory>	Specify the timesheet Id
timesheetName	<Timesheet name>	-	Specify the timesheet name
description	<Description>	-	Specify the description
sendforApproval	true \| false	false	To submit the timesheet for approval
removeAttachment	true \| false	false	To remove the attachment attached to the timesheet

Note:To attach a file to the timesheet, set the content type of the request as "multipart/form-data" and attach the file in the request body with the key name as "attachment".

Error Codes and Messages :

Error Code	Error Message
9000	Permission denied
9002	No <parameter name> parameter specified
9003	Wrong value given for <parameter name> parameter
9005	Time Tracker tab is disabled
9009	Payment has already been processed for all time logs/timesheets until <pay period processing date>. Hence, you cannot perform this action

Success Response Format

{
"response": {
"result": {
"timesheetId": <Timesheet Id>
},
"message": <Message>,
"uri": "/api/timetracker/modifytimesheet",
"status": 0
}
}

Error Response Format

{
"response": {
"message": "Error in updating data",
"uri": "/api/timetracker/modifytimesheet",
"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

Copiedhttps://people.zoho.com/people/api/timetracker/modifytimesheet?timesheetId=469505000000271189&
timesheetName=Daily Timesheet&description=Worked on System Analysis&sendforApproval=true

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

Json XML

Copied{
    "response": {
        "result": {
            "timesheetId": "469505000000271189"
        },
        "message": "Data updated successfully",
        "uri": "/api/timetracker/modifytimesheet",
        "status": 0
    }
}

Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/modifytimesheet">
    <status>0</status>
    <message>Data updated successfully</message>
    <result>
        <timesheetId>469505000000271189</timesheetId>
    </result>
</response>