Change Job Status API
This API is used to change the job status.
Request URL
https://people.zoho.com/people/api/timetracker/modifyjobstatus?jobId=<jobId>&jobStatus=<jobStatus>
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 |
| *jobId | <jobId> | <Mandatory> | Specify the job Id |
| *jobStatus | In-Progress | Completed | <Mandatory> | Specify the job status |
Error Codes and Messages :
| Error Code | Error Message |
| 8000 | No <parameter name> parameter specified |
| 8001 | Wrong value for <parameter name> parameter |
| 8006 | Timer is currently running for this job |
| 8006 | Cannot reopen the job since the project associated with this job is completed and you do not have permission to reopen the project |
Success Response Format :
{
"response": {
"message": "Job Status changed Successfully",
"uri": "/api/timetracker/modifyjobstatus",
"status": 0
}
}
Error Response Format :
{
"response": {
"message": "Error in changing job status",
"uri": "/api/timetracker/modifyjobstatus",
"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/modifyjobstatus?jobId=469505000000267495&jobStatus=In-ProgressHeader
CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxfSample Response
Copied{
"response": {
"message": "Job Status changed Successfully",
"uri": "/api/timetracker/modifyjobstatus",
"status": 0
}
}Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/modifyjobstatus">
<status>0</status>
<message>Job Status changed Successfully</message>
</response>