{
"opencollection": "1.0.0",
"info": {
"name": "Bots chats API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "chats",
"type": "folder"
},
"items": [
{
"info": {
"name": "Retrieve all direct chats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://cliq.zoho.com/api/v3/chats",
"params": [
{
"name": "name",
"value": "",
"type": "query",
"description": "Search for chats with names that partially match the provided value.
\nFor example, searching with \"pro\" may return chats named \"Project Alpha\" and \"Product Launch\".\n"
},
{
"name": "recipient",
"value": "",
"type": "query",
"description": "Filter chats containing recipient.
\nProvide the recipient USER_ID to return chats that include that user as a participant.
\nTo learn how to retrieve this ID, see USER_ID in the Glossary page.
\nFor example, searching with 70027934 returns chats that include that user ID.\n"
},
{
"name": "muted",
"value": "",
"type": "query",
"description": "Set this parameter to true to retrieve the list of chats which are muted by the user.\n"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "The number of chats that has to be retrieved.
\nMaximum limit : 100\n"
},
{
"name": "modified_before",
"value": "",
"type": "query",
"description": "Gets the list of chats where the last message is sent before the mentioned time.\n
\nThe time should be in epoch milliseconds format.
For example, 1711929600000.\n"
},
{
"name": "modified_after",
"value": "",
"type": "query",
"description": "Gets the list of chats where the last message is sent after the mentioned time.\n
\nThe time should be in epoch milliseconds format.
For example, 1711929600000.\n"
},
{
"name": "drafts",
"value": "",
"type": "query",
"description": "Set this parameter to true to retrieve the list of chats which have unsent messages (drafts).\n"
},
{
"name": "pinned",
"value": "",
"type": "query",
"description": "Set this parameter to true to retrieve the list of chats which are pinned by the user.\n"
},
{
"name": "closed",
"value": "",
"type": "query",
"description": "Set this parameter to true to retrieve the list of chats which are closed by the user.\n"
},
{
"name": "joined",
"value": "",
"type": "query",
"description": "Set this parameter to true to retrieve the list of chats which are joined by the user.\n"
},
{
"name": "chat_ids",
"value": "",
"type": "query",
"description": "Comma-separated list of chat IDs to filter the chats.
\nTo learn how to retrieve these IDs, see CHAT_ID in the Glossary page.
\n"
},
{
"name": "parent_chid",
"value": "",
"type": "query",
"description": "Filter chats that are threads of a specific parent chat. Provide the parent chat's CHAT_ID to return all threads under that chat.
\nTo learn how to retrieve this ID, see CHAT_ID in the Glossary page.
\n"
},
{
"name": "type",
"value": "",
"type": "query",
"description": "Filter chats by type.
\nAllowed values:
\n
threads - Chats that are threads of a parent chat.channel - Channel conversations.bot - Conversations with bots.dm - Direct messages between users.muted - Chats that are muted by the user.\n Threshold limit: 30 requests per min per user
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n
\n Threshold limit: 30 requests per min
\n Number of API calls allowed within a minute.
\n
operation field in the request body:\nread_status_update- Manage the read status of multiple chats in a single request. This is particularly useful for keeping your chat list organized and up-to-date, especially when you have a large number of conversations.clear_unread - Clears the unread message count or status to zero "
},
{
"info": {
"name": "Search chats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://cliq.zoho.com/api/v3/chats/search",
"params": [
{
"name": "title",
"value": "",
"type": "query",
"description": "Search for chats that include this keyword in their names. The search should be case-insensitive and allow for partial matches.1711929600000) or ISO 8601 format (for example, 2024-04-01T00:00:00Z).modified_before and modified_after in a request for predictable filtering.\nNote: When both modified_before and modified_after are provided, modified_after must be earlier than modified_before.\n"
},
{
"name": "modified_after",
"value": "",
"type": "query",
"description": "Search and return only chats last modified after this time.1711929600000) or ISO 8601 format (for example, 2024-04-01T00:00:00Z).modified_before and modified_after in a request for predictable filtering.\nNote: When both modified_before and modified_after are provided, modified_after must be earlier than modified_before.\n"
},
{
"name": "recipient",
"value": "",
"type": "query",
"description": "Filter by recipient user ID. Returns chats where this user is a participant. For direct messages, this will be the other participant; for group chats, this can be any member.\n"
},
{
"name": "chat_type",
"value": "",
"type": "query",
"description": "Filter by chat type.\nAllowed values:direct_message, group_chat, channel, thread. You can specify multiple types separated by commas (e.g. direct_message,group_chat) to include multiple chat types in the results.\n"
},
{
"name": "parent_chat_id",
"value": "",
"type": "query",
"description": "Restrict results to threads belonging to this parent chat. Only applicable when filtering for thread-type chats.\n"
},
{
"name": "sort_by",
"value": "",
"type": "query",
"description": "Sort results by usage or recent activity.usage: Sort by usage frequency, with the most frequently accessed chats appearing first.recent: Sort by recent activity, with the most recently active chats appearing first. This is the default sorting method.\n Threshold limit: 50 requests per min per user
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n
https://cliq.zoho.com/api/v3/chats/{CHAT_ID}?fields=title,chat_type,participant_count,permissions\n"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "Comma-separated list of additional data to include in the response.last_message_info: Includes details of the last message in the chat, such as message ID, sender, timestamp, content preview, and message type.include=last_message_info to include it in the response.https://cliq.zoho.com/api/v3/chats/{CHAT_ID}?include=last_message_info\n"
}
],
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Retrieve details of a specific chat by its unique identifier. You can specify optional fields to include in the response for more efficient data retrieval.\n\n Threshold limit: 60 requests per min per user
\n Number of API calls allowed within a minute.
\n Lock period: 5 minutes
Wait time before consecutive API requests.
\n
update_title: Updates the visible title of the chat. Pass the new title in the title field.update_history_status : Controls whether chat history is retained. Set history_status to enabled or disabled.\n Threshold limits: \n Threshold limit: 60 requests per min \n Threshold limit: 60 requests per min \n Threshold limit: 60 requests per min \n Threshold limit: 20 requests per min per user \n Threshold limit: 20 requests per min per user \n Threshold limit: 20 requests per min per user \n Threshold limit: "
},
{
"info": {
"name": "Send Typing Indicator",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://cliq.zoho.com/api/v3/chats/:CHAT_ID/activities",
"params": [
{
"name": "CHAT_ID",
"value": "CHAT_ID",
"type": "path",
"description": "The unique identifier of the chat. To learn how to retrieve this ID, see CHAT_ID in the Glossary page."
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Sends a typing indicator activity to a chat, signaling that the user is currently typing a message.\n \n Threshold limit: 100 requests per min per user \n Threshold limit: 20 requests per min per user \n Threshold limit: 20 requests per min per user \n Threshold limit: 20 requests per min per user \n Threshold limit: 20 requests per min per user
\n
\nNote: CHAT_ID1 is a documentation alias for CHAT_ID, used to separate the \"Update Chat Read or Unread Status\" operation for better readability while sharing the same /chats/{CHAT_ID} endpoint.\n"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Marks a single chat as read or unread for the calling user.
\nSupported operations:
\n\n
\nmark_as_read: Marks the chat as read up to a specific message. Pass the last_message_id of the chat till to be read.mark_as_unread: Marks the chat as unread from a specific message. Pass the target message_id.
\n
\n Number of API calls allowed "
},
{
"info": {
"name": "Clear Local Chat History",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://cliq.zoho.com/api/v3/chats/:CHAT_ID2",
"params": [
{
"name": "CHAT_ID2",
"value": "CHAT_ID",
"type": "path",
"description": "The unique identifier of the chat. To learn how to retrieve this ID, see CHAT_ID in the Glossary page.\n
\nNote: CHAT_ID2 is a documentation alias for CHAT_ID, used to separate the \"Clear Local Chat History\" operation for better readability while sharing the same /chats/{CHAT_ID} endpoint.\n"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Clears the local message history of a chat for the current user. The chat itself and all members remain intact; only the locally visible message history is cleared.\nOnly supported for direct messages and group chats.\n
\n
\n Number of API calls allowed within a minute.
\n
\nNote: CHAT_ID3 is a documentation alias for CHAT_ID, used to separate the \"Close a chat\" operation for better readability while sharing the same /chats/{CHAT_ID} endpoint.\n"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Closes a chat by removing it from the recent chats list of the user. The chat will still be accessible through search and other means, all members remain intact and only the visibility in recent chats is affected.\n
\n
\n Number of API calls allowed within a minute.
\n
\nAllowed values:\n\n
\n
\n"
}
],
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Use this API to retrieve the list of members participating in a channel or group chat.\n
\nCommon use cases:\n\n
\nfields query parameter.
\n
\n Number of AP"
},
{
"info": {
"name": "Add members to a chat",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://cliq.zoho.com/api/v3/chats/:CHAT_ID/members",
"params": [
{
"name": "CHAT_ID",
"value": "CHAT_ID",
"type": "path",
"description": "The unique identifier of the chat. To learn how to retrieve this ID, see CHAT_ID in the Glossary page."
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Adds one or more users to an existing group chat.\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n
With this API , you can create a new chat with a selected set of messages from the original chat. This is useful when you want to start a new discussion based on a specific topic or context from an existing chat, without sharing the entire chat history.\n
\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 50 minutes
Wait time before consecutive API requests.
\n
\nThis endpoint is helpful for exiting discussions that are no longer relevant to the user.\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API requests.
\n
\nThis setting affects chat-level notifications and helps keep conversations organized without leaving them entirely.\n
\n
\n Number of API calls allowed within a minute.
\n Lo"
},
{
"info": {
"name": "Unmute a chat",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://cliq.zoho.com/api/v3/chats/:CHAT_ID/unmute",
"params": [
{
"name": "CHAT_ID",
"value": "CHAT_ID",
"type": "path",
"description": "The unique identifier of the chat that needs to be unmuted. To learn how to retrieve this ID, see CHAT_ID in the Glossary page."
}
],
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Use this API to restore notifications for any given previously muted chat.\nOnce unmuted, the user starts receiving chat updates again according to their notification settings.\n
\nUse this when a group chat or channel becomes active or relevant again and timely visibility of messages is required.\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 10 minutes
Wait time before consecutive API r"
},
{
"info": {
"name": "Mentioning available users in a Channel",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://cliq.zoho.com/api/v3/chats/:CHAT_ID4/messages",
"params": [
{
"name": "CHAT_ID4",
"value": "CHAT_ID",
"type": "path",
"description": "Unique identifier of the chat where the message needs to be sent. To learn how to retrieve this ID, see CHAT_ID in the Glossary page.
\nNote: CHAT_ID4 is a documentation alias for CHAT_ID, used to document the \"Mentioning available users in a Channel\" use case separately while sharing the same /chats/{CHAT_ID}/messages endpoint, since the path is unchanged and only the message content pattern differs.\n"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "To mention all users who are currently available in a channel, use the syntax {@available}.
\nThis will notify only the participants whose status is set to Available at the time the message is posted.\n"
},
{
"info": {
"name": "Retrieve thread details",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://cliq.zoho.com/api/v3/threads/:THREAD_CHAT_ID",
"params": [
{
"name": "THREAD_CHAT_ID",
"value": "THREAD_CHAT_ID",
"type": "path",
"description": "The unique identifier of the thread chat."
}
],
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Fetches details of a thread using its thread chat ID. Returns information such as the thread title, follower count, whether the requesting user is a follower, the parent chat, and the thread's open/closed state.\n
\n
\n Number of API calls allowed within a minute.
\n Lock period: 5 minutes
Wait time before consecutive API requests.
\n