Deleting Clients From Zoho People | API

Delete Clients API

This API is used to delete the list of clients

Request URL:

https://people.zoho.com/people/api/timetracker/deleteclient?clientId=<clientId>

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.timetracker.ALL
OR
ZOHOPEOPLE.timetracker.READ

Possible Operation Types:

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

Request parameter:

Parameter	Values Allowed	Default Value	Description
*clientId	<Client Ids>	<Mandatory>	Specify the client Ids (separated by commas). Note: Maximum number of Ids allowed is 1000.

Error Codes and Messages :

Error Code	Error Message
7019	Missing parameter(s) in the request
7038	Permission denied

Note: This API is permitted only for Admin.

Success Response Format

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

Error Response Format

{
"response": {
"message": "Error occurred",
"uri": "/api/timetracker/deleteclient",
"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/deleteclient?clientId=469505000000271259,469505000000271261,469505000000271263

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

Json XML

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

Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/deleteclient">
    <status>0</status>
    <message>Client(s) deleted successfully</message>
</response>