Delete Timesheets API

This API is used to delete timesheets.

Request URL:

https://people.zoho.com/people/api/timetracker/deletetimesheet?timesheetId=<timesheetId>​

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.timetracker.ALL
OR
ZOHOPEOPLE.timetracker.DELETE

Possible Operation Types:

ALL - Complete access to data
DELETE - Only to delete data

Request parameter:

ParameterValues AllowedDefault ValueDescription
*timesheetId<Timesheet Ids><Mandatory>Specify the timesheet Ids (separated by commas). Maximum number of Ids allowed is 1000.

Error Codes and Messages :

Error CodeError Message
9000Permission denied
9005Time Tracker tab is disabled
9009Payment 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": [
                <Array of deleted timesheet Ids>
            ],
            "skippedInfo": [ (NOTE: This key will be available only if any one of the timesheets is not deleted)
                {
                    "timesheetId": [
                        <Array of timesheet Ids which are not deleted>
                    ],
                    "code": <Error Code>,
                    "message": <Error Message>
                },.....
            ]
        },
        "message": "Data deleted successfully",
        "uri": "/api/timetracker/deletetimesheet",
        "status": 0
    }
}

Error Response Format

{
    "response": {
        "message": "Error in deleting data",
        "uri": "/api/timetracker/deletetimesheet",
        "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/deletetimesheet?timesheetId=469505000000272361,469505000000272374,469505000000176009,469505000000271189,469505000000176019,469505000000271129

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

JsonXML
Copied{
    "response": {
        "result": {
            "timesheetId": [
                "469505000000272361",
                "469505000000272374"
            ],
            "skippedInfo": [
                {
                    "timesheetId": [
                        "469505000000176009",
                        "469505000000271189"
                    ],
                    "code": 9000,
                    "message": "Permission Denied"
                },
                {
                    "timesheetId": [
                        "469505000000176019",
                        "469505000000271129"
                    ],
                    "code": 9009,
                    "message": "Payment has already been processed for all time logs/timesheets until 12-Apr-2019. Hence, you cannot perform this action."
                }
            ]
        },
        "message": "Data deleted successfully",
        "uri": "/api/timetracker/deletetimesheet",
        "status": 0
    }
}
Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/deletetimesheet">
    <status>0</status>
    <message>Data deleted successfully</message>
    <result>
        <timesheetId>["469505000000272361","469505000000272374"]</timesheetId>
        <skippedInfo>[{"timesheetId":["469505000000176009","469505000000271189"],"code":9000,"message":"Permission Denied"},{"timesheetId":["469505000000176019","469505000000271129"],"code":9009,"message":"Payment has already been processed for all time logs/timesheets until 12-Apr-2019. Hence, you cannot perform this action."}]</skippedInfo>
    </result>
</response>