Deleting existing jobs using API

Delete Jobs API

This API is used to delete jobs.

Request URL:

https://people.zoho.com/people/api/timetracker/deletejob?jobId=<jobId>

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:

Parameter	Values Allowed	Default Value	Description
*jobId	<jobIds>	<Mandatory>	Specify the job Id (separated by commas). Maximum number of Ids allowed is 100.

Error Codes:

Error Code	Error Message
8000	No <parameter name> parameter specified
8001	Wrong value for <parameter name> parameter
8004	Job cannot be deleted since timer is running

Success Response Format

{
"response": {
"message": "Job(s) deleted successfully",
"uri": "/api/timetracker/deletejob",
"status": 0
}
}

Error Response Format

{
"response": {
"message": <Message>, (NOTE: Refer the table below)
"uri": "/api/timetracker/deletejob",
"errors": {
"code": <Error Code>,
"message": <Error Message>
},
"status": 1
}
}

Messages:

Messages

Error in deleting job(s)

One or more specified jobs are not deleted

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/deletejob?jobId=469505000000223813

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

Copied{
    "response": {
        "message": "Job(s) deleted successfully",
        "uri": "/api/timetracker/deletejob",
        "status": 0
    }
}