Zoho Cliq API

The Zoho Cliq REST API v3 enables developers to connect Cliq with other applications and services, automate tasks, and enhance team communication capabilities. It covers chats, messages, threads, bots, slash commands, message actions, functions, datastores, and extensions.

Documentation

Specifications

OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/chats.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/messages.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/threads.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/scheduledmessages.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/reminders.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/pinmessages.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/mypins.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/stars.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/messageformat.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/mentions.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/buttons.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/messagecards.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/bots.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/slashcommands.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/messageactions.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/functions.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/datastores.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/extensions.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/dndsettings.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/mobilesettings.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/userpreferences.yml
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/keyboardshortcuts.yml

Schemas & Data

Other Resources

OpenAPI Specification

chats.yml Raw ↑
openapi: 3.0.0
info:
  title: Chats
  description: |
    The Chats API enables effective conversation management, offering complete control over chat interactions, making it suitable for various messaging and collaboration scenarios.<br><br>
    The v3 version of the Chats API is designed to provide full lifecycle control over chat interactions, enabling developers to create scalable, feature-rich communication experiences.
    <br><br><b>Key Capabilities</b><br>
    With the latest v3 version of the Chats API, you can:
    <ul>
      <li><b>Search Chats:</b> Efficiently query and retrieve chats based on parameters such as participants, metadata, or chat state.</li>
      <li><b>Chat Management:</b> Create new chats, retrieve existing ones (including direct chats or specific conversations), and fork chats from existing discussions.</li>
      <li><b>Member Management:</b> Add or remove participants and access the list of members within a chat.</li>
      <li><b>Chat Operations:</b> Update chat states, send typing indicators, and perform bulk updates across multiple chats.</li>
    </ul>
  contact: {}
  version: 1.0.0
externalDocs:
  description: Find out more about Zoho Cliq APIs V2
  url: https://www.zoho.com/cliq/help/restapi/v2/
servers:
  - url: https://cliq.zoho.com/api/v3
    description: Zoho Cliq US DC
tags:
  - name: chats
    description: Chats Module
paths:
  /chats:
    get:
      summary: Retrieve all direct chats
      operationId: Retrieve all direct chats
      description: |
        Use this API to get details of all direct chats.
        <br><br> 
        <p>
          <b>Threshold limit</b>: 30 requests per min per user<br>
          Number of API calls allowed within a minute.<br><br>
          <b>Lock period</b>: 10 minutes<br>Wait time before consecutive API requests.<br>
        </p>
      parameters:
        - name: name
          in: query
          required: false
          schema:
            type: string
          description: |
            Search for chats with names that partially match the provided value.<br>
            For example, searching with "pro" may return chats named "Project Alpha" and "Product Launch".
        - name: recipient
          in: query
          required: false
          schema:
            type: string
          description: |
            Filter chats containing recipient.<br>
            Provide the recipient <code>USER_ID</code> to return chats that include that user as a participant.<br>
            To learn how to retrieve this ID, see <a href="/cliq/help/restapi/v3/glossary/#USER_ID">USER_ID</a> in the Glossary page.<br>
            For example, searching with <code>70027934</code> returns chats that include that user ID.
        - name: muted
          in: query
          required: false
          schema:
            type: boolean
          description: |
            Set this parameter to true to retrieve the list of chats which are muted by the user.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int64
            maxLength: 100
          description: |
            The number of chats that has to be retrieved.<br>
            <b>Maximum limit</b> : 100
        - name: modified_before
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: |
            Gets the list of chats where the last message is sent before the mentioned time.
            <br>
            The time should be in <b>epoch milliseconds</b> format.<br>For example, <code>1711929600000</code>.
        - name: modified_after
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: |
            Gets the list of chats where the last message is sent after the mentioned time.
            <br>
            The time should be in <b>epoch milliseconds</b> format.<br>For example, <code>1711929600000</code>.
        - name: drafts
          in: query
          required: false
          schema:
            type: boolean
          description: |
            Set this parameter to true to retrieve the list of chats which have unsent messages (drafts).
        - name: pinned
          in: query
          required: false
          schema:
            type: boolean
          description: |
            Set this parameter to true to retrieve the list of chats which are pinned by the user.
        - name: closed
          in: query
          required: false
          schema:
            type: boolean
          description: |
            Set this parameter to true to retrieve the list of chats which are closed by the user.
        - name: joined
          in: query
          required: false
          schema:
            type: boolean
          description: |
            Set this parameter to true to retrieve the list of chats which are joined by the user.
        - name: chat_ids
          in: query
          required: false
          schema:
            type: string
          description: |
            Comma-separated list of chat IDs to filter the chats.<br>
            To learn how to retrieve these IDs, see <a href="/cliq/help/restapi/v3/glossary/#CHAT_ID">CHAT_ID</a> in the Glossary page.<br>
        - name: parent_chid
          in: query
          required: false
          schema:
            type: string
          description: |
            Filter chats that are threads of a specific parent chat. Provide the parent chat's <code>CHAT_ID</code> to return all threads under that chat.<br>
            To learn how to retrieve this ID, see <a href="/cliq/help/restapi/v3/glossary/#CHAT_ID">CHAT_ID</a> in the Glossary page.<br>
        - name: type
          in: query
          required: false
          schema:
            type: string
            enum:
              - guests
              - threads
              - channel
              - bot
              - dm
              - muted
          description: |
            Filter chats by type.<br>
            <b>Allowed values</b>:<br>
            <ul>
              <li><code>threads</code> - Chats that are threads of a parent chat.</li>
              <li><code>channel</code> - Channel conversations.</li>
              <li><code>bot</code> - Conversations with bots.</li>
              <li><code>dm</code> - Direct messages between users.</li>
              <li><code>muted</code> - Chats that are muted by the user.</li>
            </ul>
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                success:
                  summary: List of direct chats
                  value:
                    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
                        creator:
                          id: '70027934'
                          name: Tim Harrison
                        last_message_info:
                          message_id: '1773813859592_51531973059'
                          sender: '70027934'
                          time: '2025-04-10T14:30:00.000Z'
                          content:
                            text: See you at the standup!
                          type: text
                      - chat_id: '2890538000000067890'
                        name: Bob Carter
                        chat_type: direct_message
                        participant_count: 2
                        created_time: '2024-09-15T11:00:00.000Z'
                        last_modified_time: '2025-04-09T09:45:00.000Z'
                        pinned: true
                        removed: false
                        creator:
                          id: '70027934'
                          name: Tim Harrison
              schema:
                type: object
                properties:
                  chats:
                    type: array
                    items:
                      $ref: '#/components/schemas/v3-chat'
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The request cannot be performed. Usually because of malformed parameter or missing parameter.
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Request was rejected because of invalid AuthToken.
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The user does not have enough permission or possibly not an user of the respective organization to access the resource.
        '404':
          description: Invalid URL.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The URL you've sent is wrong. It's possible that the resource you've requested has been moved to another URL.
        '405':
          description: Method Not Allowed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The requested resource does not support the HTTP method used. For example, requesting List of all customers API with PUT as the HTTP method.
        '406':
          description: Not Acceptable.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The response has been received but the requested response type is not supported by the browser.
        '429':
          description: Too many requests.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Too many requests within a certain time frame.
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Cliq server encountered an error which prevents it from fulfilling the request.
      security:
        - Cliq_Auth:
            - ZohoCliq.Chats.READ
      tags:
        - chats
    post:
      summary: Create chat
      operationId: createChatV3
      description: |
        Create a new direct conversation or a group chat.
        <br><br>
        <p>
          <b>Threshold limit</b>: 30 requests per min<br>
          Number of API calls allowed within a minute.<br>
        </p>
        <details style="margin:16px 0 8px 0; border:1px solid rgba(148,163,184,0.5); border-radius:8px; font-family:inherit;" ontoggle="this.querySelector('.err-toggle-hint').textContent=this.open?'Click to collapse':'Click to expand'">
          <summary style="cursor:pointer; padding:11px 16px; font-weight:600; background:rgba(148,163,184,0.1); list-style:none; display:flex; align-items:center; gap:8px; user-select:none; border-radius:8px;">
            <span style="display:inline-flex; align-items:center; justify-content:center; width:20px; height:20px; background:rgba(239,68,68,0.15); border-radius:50%; font-size:12px; font-weight:700; color:#ef4444; flex-shrink:0;">!</span>
            Possible Error Codes
            <span class="err-toggle-hint" style="margin-left:auto; font-weight:400; opacity:0.45; font-size:0.8em; letter-spacing:0.01em;">Click to expand</span>
          </summary>
          <div style="padding:14px 16px 16px 16px;">
            <div style="border-radius:6px; border:1px solid rgba(148,163,184,0.35);">
              <table style="border-collapse:collapse; width:100%; font-family:inherit; font-size:0.9em;">
                <thead>
                  <tr>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); border-right:1px solid rgba(148,163,184,0.35); font-weight:600; width:45%;">Error Code</th>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); font-weight:600; width:55%;">Description</th>
                  </tr>
                </thead>
                <tbody>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">121_deptmem_message</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Permission to chat with department members is restricted by admin.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">121_orgmem_message</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Permission to chat with organization members is restricted by admin.</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">chat_continue_nonorg_nonmutual_contact_failed</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">The user is no longer part of your contacts or organization.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">121_extmem_message</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Permission to chat with external users is restricted by admin.</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">chat_not_available_with_this_inactive_user_and_cannot_create_newchat</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">No chat history with this inactive user; cannot create a new chat.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">invalid_inputs</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Missing or invalid fields (e.g. chat_type not provided or unsupported).</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">no_valid_users_available_to_create_chat</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">All specified users are inactive or not in your contacts.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">insufficient_members_to_create_group_chat</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Not enough valid members to create a group chat (minimum 3 including creator).</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">chat_operation_failed</span></td>
                    <td style="padding:10px 18px;">Unexpected server error while creating the chat.</td>
                  </tr>
                </tbody>
              </table>
            </div>
            <div style="background:rgba(245,158,11,0.08); border:1px solid rgba(245,158,11,0.4); border-left:4px solid #f59e0b; padding:12px 16px; border-radius:0 6px 6px 0; margin-top:14px; overflow:hidden;">
              <b style="color:#d97706; font-size:0.88em; display:block; margin-bottom:6px;">Error Response Format</b>
              <p style="margin:0 0 8px 0; font-size:0.85em; opacity:0.75;">When an error occurs, the API returns a JSON response in this format:</p>
              <code style="display:block; background:rgba(245,158,11,0.1); border:1px solid rgba(245,158,11,0.3); padding:8px 12px; border-radius:4px; font-size:0.75em; word-break:break-all;">{"message": "A human-readable description of the error.", "code": "error_code"}</code>
              <p style="margin:8px 0 0 0; font-size:0.85em; opacity:0.75;">where <code style="background:rgba(245,158,11,0.1); padding:1px 5px; border-radius:3px;">code</code> is the error identifier (as listed above) and <code style="background:rgba(245,158,11,0.1); padding:1px 5px; border-radius:3px;">message</code> is a human-readable explanation of what went wrong.</p>
            </div>
          </div>
        </details>
      requestBody:
        required: true
        content:
          application/json:
            examples:
              direct_chat:
                summary: Direct Chat
                value:
                  chat_type: direct_message
                  user_id: '70027934'
              group_chat:
                summary: Group Chat
                value:
                  chat_type: group_chat
                  user_ids:
                    - '70027934'
                    - '106324287'
                    - '70317945'
                    - '72589892'
                  title: Q2 Product Review - Design, Engineering & QA
            schema:
              $ref: '#/components/schemas/v3-create-chat-request'
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                direct_chat:
                  summary: Direct Chat response
                  value:
                    url: /v3/chats
                    type: chat
                    data:
                      user_membership:
                        pinned: false
                        removed: false
                      chat_type: direct_message
                      name: Ryan West
                      creator:
                        name: Ryan West
                        id: '855727963'
                      participant_count: 2
                      created_time: '2024-11-06T22:39:30-08:00'
                      last_modified_time: '2026-05-06T23:37:30-07:00'
                      chat_id: '2198144177691461096'
                group_chat:
                  summary: Group Chat response
                  value:
                    url: /v3/chats
                    type: chat
                    data:
                      name: Q2 Product Review - Design, Engineering & QA
                      chat_id: '1456816193674892935'
                      chat_type: group_chat
                      participant_count: 5
                      created_time: '2025-06-15T10:30:00+05:30'
                      last_modified_time: '2025-06-15T10:30:00+05:30'
                      user_membership:
                        pinned: false
                        removed: false
                      creator:
                        id: '70027934'
                        name: Tim Harrison
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/v3-chat'
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The request cannot be performed. Usually because of malformed parameter or missing parameter.
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Request was rejected because of invalid AuthToken.
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The user does not have enough permission or possibly not an user of the respective organization to access the resource.
        '429':
          description: Too many requests.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Too many requests within a certain time frame.
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Cliq server encountered an error which prevents it from fulfilling the request.
      security:
        - Cliq_Auth:
            - ZohoCliq.Chats.CREATE
      tags:
        - chats
    put:
      summary: Mark Multiple Chats as Read or Clear Unread Count
      operationId: bulkUpdateChatsV3
      description: |
        Manage the read state of multiple chats in a single request.<br> 
        Two bulk actions are supported, controlled by the <code>operation</code> field in the request body:
        <ul>
          <li><code>read_status_update</code>- 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.</li>
          <li><code>clear_unread</code> - Clears the unread message count or status to zero for the specified chats. If a specified chat has no unread entries, it is silently skipped.</li>
        </ul>
        <p>
          <b>Threshold limits</b>: 60 requests per min<br>
          Number of API calls allowed within a minute.<br><br>
          <b>Lock periods</b>: 5 minutes<br>Wait time before consecutive API requests.<br>
        </p>
        <details style="margin:16px 0 8px 0; border:1px solid rgba(148,163,184,0.5); border-radius:8px; font-family:inherit;" ontoggle="this.querySelector('.err-toggle-hint').textContent=this.open?'Click to collapse':'Click to expand'">
          <summary style="cursor:pointer; padding:11px 16px; font-weight:600; background:rgba(148,163,184,0.1); list-style:none; display:flex; align-items:center; gap:8px; user-select:none; border-radius:8px;">
            <span style="display:inline-flex; align-items:center; justify-content:center; width:20px; height:20px; background:rgba(239,68,68,0.15); border-radius:50%; font-size:12px; font-weight:700; color:#ef4444; flex-shrink:0;">!</span>
            Possible Error Codes
            <span class="err-toggle-hint" style="margin-left:auto; font-weight:400; opacity:0.45; font-size:0.8em; letter-spacing:0.01em;">Click to expand</span>
          </summary>
          <div style="padding:14px 16px 16px 16px;">
            <p style="margin:0px 0 8px 0; font-weight:600; font-size:0.9em; opacity:0.75;">Possible Error Codes - Mark Chats as Read (<code>read_status_update</code>)</p>
            <div style="border-radius:6px; border:1px solid rgba(148,163,184,0.35);">
              <table style="border-collapse:collapse; width:100%; font-family:inherit; font-size:0.9em;">
                <thead>
                  <tr>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); border-right:1px solid rgba(148,163,184,0.35); font-weight:600; width:45%;">Error Code</th>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); font-weight:600; width:55%;">Description</th>
                  </tr>
                </thead>
                <tbody>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">param_missing</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">The param 'operation' is missing.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">param_missing</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">The param 'read_status' is missing.</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">param_missing</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">The param 'chats' is missing.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">param_missing</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">The param 'chat_id' is missing.</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">invalid.inputs.submitted</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">Incorrect values submitted.</td>
                  </tr>
                  <tr style="background:rgba(148,163,184,0.05);">
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2); border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">chat_access_denied</span></td>
                    <td style="padding:10px 18px; border-bottom:1px solid rgba(148,163,184,0.2);">You must be a participant in this chat to perform this action.</td>
                  </tr>
                  <tr>
                    <td style="padding:10px 18px; border-right:1px solid rgba(148,163,184,0.25); vertical-align:middle;"><span style="display:inline-block; background:rgba(239,68,68,0.12); color:#ef4444; padding:3px 10px; border-radius:4px; font-family:monospace; font-size:0.82em; line-height:1.6; word-break:break-all;">chat_operation_failed</span></td>
                    <td style="padding:10px 18px;">Unable to perform the action. Please retry.</td>
                  </tr>
                </tbody>
              </table>
            </div>
            <p style="margin:14px 0 8px 0; font-weight:600; font-size:0.9em; opacity:0.75;">Possible Error Codes - Clear Unread Count (<code>clear_unread</code>)</p>
            <div style="border-radius:6px; border:1px solid rgba(148,163,184,0.35);">
              <table style="border-collapse:collapse; width:100%; font-family:inherit; font-size:0.9em;">
                <thead>
                  <tr>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); border-right:1px solid rgba(148,163,184,0.35); font-weight:600; width:45%;">Error Code</th>
                    <th style="padding:10px 18px; text-align:center; background:rgba(148,163,184,0.15); border-bottom:1px solid rgba(148,163,184,0.35); font-weight:600; width:55%;">Description</th>
      

# --- truncated at 32 KB (186 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho-cliq/refs/heads/main/openapi/chats.yml