Zoho Cliq · Example Payload
Stars
MessagingTeam CollaborationChatBotsWebhooksSlash CommandsCommunication
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
{
"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"
}
}
}
}