Changing Project Status using API

Change Project Status API

This API is used to change the status of a project.

Request URL:

https://people.zoho.com/people/api/timetracker/changeprojectstatus?projectId=<projectId>&status=<status>

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.timetracker.ALL
OR
ZOHOPEOPLE.timetracker.UPDATE

Possible Operation Types:

ALL - Complete access to data
READ - Only to read data

Request parameter:

Parameters	Values Allowed	Default Value	Description
*projectId	<projectId>	<Mandatory>	Specify the project ID for which you would like to change the status
*status	<In-progress \| Inprogress \|completed>	<Mandatory>	Specify the status to be marked

Error Codes & Messages:

Error Code	Error Message
8000	No <parameter_name> specified
8001	Wrong value for <parameter_name>
9005	Time tracker tab is disabled

Success Response Format

{
"response": {
"result": [
{
"projectId": < projectId >
}
],
"message": "Project status changed successfully",
"uri": "/api/timetracker/changeprojectstatus",
"status": 0
}
}

Error Response Format

{
"response": {
"message": "Project Status cannot be changed",
"uri": "/api/timetracker/changeprojectstatus",
"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/changeprojectstatus?projectId=617735000000229087&status=completed

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

Json XML

Copied{
    "response": {
        "result": [
            {
                "projectId": "617735000000229087"
            }
        ],
        "message": "Project status changed successfully",
        "uri": "/api/timetracker/changeprojectstatus",
        "status": 0
    }
}

Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/changeprojectstatus">
<status>0</status>
<message>Project status changed successfully</message>
<result>
<projectId>617735000000229087</projectId>
</result>
</response>