Zoho Cliq · Example Payload

Stars

MessagingTeam CollaborationChatBotsWebhookSlash CommandsCommunications

Stars is an example object payload from Zoho Cliq, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

star_a_messagelist_starred_messagesunstar_a_message

Example Payload

Raw ↑
{
  "star_a_message": {
    "path": "/stars",
    "method": "post",
    "examples": {
      "request": {
        "star_a_message": {
          "summary": "Star a message",
          "value": {
            "chat_id": "CT_1894736520184930172_847291635",
            "message_id": "1746000123456789001",
            "star_type": "important"
          }
        },
        "update_star_type": {
          "summary": "Update star type of an already-starred message",
          "value": {
            "chat_id": "CT_1894736520184930172_847291635",
            "message_id": "1746000123456789001",
            "star_type": "follow_up"
          }
        }
      },
      "response_200": {
        "star_a_message": {
          "summary": "Message starred for the first time",
          "value": {
            "type": "text",
            "id": "1746000123456789001",
            "time": "2026-04-30T10:00:00Z",
            "sender": {
              "id": "1234567890",
              "name": "Alice Johnson"
            },
            "content": {
              "text": "Please review the Q2 report before Friday."
            },
            "is_pinned": false,
            "star_information": {
              "star_type": "important",
              "starred_message_time": "2026-04-30T10:15:30Z"
            },
            "chat_information": {
              "chat_id": "CT_1894736520184930172_847291635",
              "chat_type": "chat",
              "title": "Alice Johnson",
              "joined": true
            }
          }
        },
        "update_star_type": {
          "summary": "Star type updated - old_star_type shows the previous type",
          "value": {
            "type": "text",
            "id": "1746000123456789001",
            "time": "2026-04-30T10:00:00Z",
            "sender": {
              "id": "1234567890",
              "name": "Alice Johnson"
            },
            "content": {
              "text": "Please review the Q2 report before Friday."
            },
            "is_pinned": false,
            "star_information": {
              "star_type": "follow_up",
              "starred_message_time": "2026-04-30T10:15:30Z",
              "old_star_type": "important"
            },
            "chat_information": {
              "chat_id": "CT_1894736520184930172_847291635",
              "chat_type": "chat",
              "title": "Alice Johnson",
              "joined": true
            }
          }
        }
      },
      "response_400": {
        "code": 1012,
        "message": "input_invalid"
      },
      "response_404": {
        "chat_not_found": {
          "value": {
            "code": 11016,
            "message": "chat_not_found"
          },
          "summary": "Chat does not exist or user cannot access it"
        }
      },
      "response_500": {
        "code": 1011,
        "message": "operation_failed"
      }
    }
  },
  "list_starred_messages": {
    "path": "/stars",
    "method": "get",
    "examples": {
      "response_200": {
        "starred_messages": {
          "summary": "List of starred messages with next_token",
          "value": {
            "star_messages": [
              {
                "type": "text",
                "id": "1746000123456789001",
                "time": "2026-04-30T10:00:00Z",
                "sender": {
                  "id": "1234567890",
                  "name": "Alice Johnson"
                },
                "content": {
                  "text": "Please review the Q2 report before Friday."
                },
                "is_pinned": false,
                "star_information": {
                  "star_type": "important",
                  "starred_message_time": "2026-04-30T10:15:30Z"
                },
                "chat_information": {
                  "chat_id": "chid_abcdef123456",
                  "chat_type": "chat",
                  "title": "Alice Johnson",
                  "joined": true
                }
              },
              {
                "type": "file",
                "id": "1746000987654321002",
                "time": "2026-04-30T09:40:00Z",
                "sender": {
                  "id": "9876543210",
                  "name": "Bob Smith"
                },
                "content": {
                  "file_name": "Q2_Report_Final.pdf",
                  "file_size": 204800,
                  "file_url": "https://cliq.zoho.com/file/download?id=enc_file_id_xyz"
                },
                "is_pinned": false,
                "star_information": {
                  "star_type": "to_do",
                  "starred_message_time": "2026-04-30T09:45:00Z"
                },
                "chat_information": {
                  "chat_id": "chid_channel_org_001",
                  "chat_type": "channel",
                  "title": "Engineering Announcements",
                  "display_name": "Engineering Announcements",
                  "joined": true
                }
              }
            ],
            "next_token": "eyJsYXN0U3RhcnJlZFRpbWUiOiIxNzQ1OTkwMDAwMDAwIiwibGltaXQiOjJ9"
          }
        }
      },
      "response_403": {
        "code": 430002,
        "message": "chat_access_denied"
      }
    }
  },
  "unstar_a_message": {
    "path": "/stars/{MESSAGE_ID}",
    "method": "delete",
    "examples": {
      "response_400": {
        "code": 1012,
        "message": "input_invalid"
      },
      "response_404": {
        "code": 8004,
        "message": "star_not_found"
      },
      "response_500": {
        "code": 1011,
        "message": "operation_failed"
      }
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/stars"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.