List conversation messages
The messages of one conversation, oldest first by default, paginated without a total count — walk forward while meta.has_next is true.
Attachments and content_attributes are not exposed in this version — only the fields on the Message schema. A private note comes back like any other message, with private: true; filter it out client-side if you don’t want it. A hidden admin’s message reports sender.id: null with a masked name, and sender itself is null on an activity message (status/assignment changes and the like).
Authorizations
The id_token from POST /auth/v1/signin, sent as Authorization: Bearer <id_token>. Not the access_token — that one does not carry the identity Cloud Chat authorizes on.
Headers
Your Cloud Chat instance ID — an integer, fixed for your company, told at onboarding. The API overview explains how instances work, how to find yours, and the errors a wrong or missing value produces.
1
Path Parameters
Your Cloud Chat account. It has to be an account your token grants membership on, and it has to live on the instance in the cloudchat-instance header — the two travel together. Account numbers are only unique within an instance, so the same number is a different company on another instance. Usually a mismatched pair fails closed with a 401, because your user does not exist on the other instance — but if your identity happens to exist on both, the call succeeds against the other company's data, silently. Read it and you are looking at the wrong help center; write it and you have stored into the wrong account. Send the two values that were given to you together, and never try a number to see what answers.
1
The conversation's display_id — the number shown in the dashboard URL and delivered in webhooks. It is never the internal database id.
1042
Query Parameters
Keep only messages of this type. An unrecognized value is a 400, not silently ignored.
incoming, outgoing, activity, template Ordering by id. An unrecognized value is not an error — it falls back to oldest.
oldest, newest 1-based page number. Anything below 1 — including a non-numeric value — is read as 1.
x >= 11
Results per page. Clamped, never rejected: above 100 you get 100, below 1 you get the default 25.
1 <= x <= 10025
Response
A page of messages. data is empty when the conversation has none matching — an empty page is not a 404.