Errors
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
The Zoho Cliq REST API uses standard HTTP status codes to communicate the success or failure of API requests. Understanding these status codes is essential for building robust integrations that can gracefully handle errors and provide meaningful feedback to users.
Status codes in the 2xx range indicate successful operations, codes in the 4xx range signal client-side errors (such as invalid requests or authentication failures), and codes in the 5xx range represent server-side errors.
Additionally, each endpoint may return endpoint-specific error codes, which are listed under the respective endpoint's description in a tabular format.
| Status Code | Description |
|---|---|
| 200 | OKThe request was successfully completed. The response body contains the requested resource data. |
| 201 | CreatedThe request succeeded and one or more resources have been created (e.g., new channel, message, or bot). |
| 204 | No ContentThe request was successful but there is no content to return (common for DELETE operations). |
| 400 | Bad RequestThe request cannot be processed due to malformed syntax, invalid parameters, or missing required fields. Verify your request payload and parameters. |
| 401 | UnauthorizedAuthentication failed or was not provided. This typically occurs when the OAuth token is invalid, expired, or missing from the Authorization header. |
| 403 | ForbiddenThe authenticated user lacks sufficient permissions to access the requested resource. Verify that your OAuth scopes include the necessary permissions for this operation. |
| 404 | Not FoundThe requested resource does not exist or the URL is incorrect. Check the resource ID and endpoint path for accuracy. |
| 405 | Method Not AllowedThe HTTP method used is not supported for this endpoint. For example, using PUT when only GET and POST are allowed. |
| 406 | Not AcceptableThe server cannot produce a response matching the acceptable values defined in the request headers. |
| 409 | ConflictThe request conflicts with the current state of the resource (e.g., attempting to create a duplicate resource). |
| 429 | Too Many RequestsRate limit exceeded. You've sent too many requests within a specific time window. Implement exponential backoff and retry logic. |
| 500 | Internal Server ErrorThe Zoho Cliq server encountered an unexpected error. If this persists, contact support@zohocliq.com with your request details. |
| 502 | Bad GatewayThe server received an invalid response from an upstream server. This is usually temporary; retry with exponential backoff. |
| 503 | Service UnavailableThe server is temporarily unable to handle the request due to maintenance or overload. Retry after a delay. |
| 504 | Gateway TimeoutThe server did not receive a timely response from an upstream server. Consider reducing request complexity or retrying. |
$ curl -X GET "https://cliq.zoho.com/api/v3/chats" \
-H "Authorization: Zoho-oauthtoken 1000.xxxxxxxxxxxxxxxxxxxxx"
{
"chats": [
{
"chat_id": "2890538000000012345",
"name": "Alice Johnson",
"chat_type": "direct_message",
"participant_count": 2,
"created_time": "2024-06-01T09:00:00.000Z",
"last_modified_time": "2025-04-10T14:30:00.000Z",
"pinned": false,
"removed": false
}
]
}
{
"message": "The request cannot be performed. Usually because of malformed parameter or missing parameter."
}
{
"message": "Request was rejected because of invalid AuthToken."
}
{
"message": "The user does not have enough permission or possibly not an user of the respective organization to access the resource."
}
{
"message": "The URL you've sent is wrong. It's possible that the resource you've requested has been moved to another URL."
}
{
"message": "Too many requests within a certain time frame."
}
{
"message": "Cliq server encountered an error which prevents it from fulfilling the request."
}