List messages
const url = 'https://optlo.com/api/v1/conversations/example/messages?limit=50&kind=message';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://optlo.com/api/v1/conversations/example/messages?limit=50&kind=message' \ --header 'Authorization: Bearer <token>'Messages sort by descending sequence. Visibility is applied before pagination. Greeting-only conversations, retracted messages, empty messages, and assistant replies that are still generating are excluded.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Unique identifier for the conversation.
Query Parameters
Section titled “Query Parameters”Maximum number of resources to return on one page.
Opaque cursor from the preceding page. Bound to workspace, resource and filters; survives key rotation.
Message requires messages:read; note requires notes:read. Omission requires messages:read and includes notes only with notes:read.
Response
Section titled “Response”Success
Show child attributes
Resources on this page.
A customer-visible message or internal note.
Show child attributes
Unique identifier for the message or note.
ID of the conversation containing this message.
Whether this is a customer-visible message or an internal note.
Markdown text of the message or note. Literal characters typed by users are backslash-escaped.
Participant who sent the message.
Show child attributes
Unique identifier for the sender.
Type of participant who sent the message.
Time the message was created.
Pass this cursor to retrieve the next page. Null when no further page is available. When polling events in ascending order, retain the cursor even on empty pages.
Example
{ "data": [ { "id": "msg_h7m4k2r9p6x8n3q5v1z0bcdf", "conversationId": "conv_B8kN4pR6xZ2_kR7mP3xB9nQ2vL5z", "kind": "message", "content": "Hi Sam, your workspace is ready. Can I help you get started?", "sender": { "id": "acc_tQ8nL4zR6mB2xP7k", "role": "operator" }, "createdAt": "2026-10-13T09:10:00.000Z" } ], "nextCursor": null}