Get conversation messages

Retrieve messages for a specific conversation, including tool calls made by the assistant.

GET /ai/conversations/{conversation_id}/messages

JavaScript

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const messageListResponse of client.ai.conversations.messages.list('conversation_id')) {
  console.log(messageListResponse.role);
}

200

{
  "data": [
    {
      "role": "user",
      "text": "<string>",
      "tool_calls": [
        {
          "id": "<string>",
          "type": "function",
          "function": {
            "name": "<string>",
            "arguments": "<string>"
          }
        }
      ],
      "created_at": "2025-04-15T13:07:28.764Z",
      "sent_at": "2025-04-15T13:07:28.764Z"
    }
  ],
  "meta": {
    "total_pages": 123,
    "total_results": 123,
    "page_number": 123,
    "page_size": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conversation_id · string · required

Query Parameters

page[size] · integer · default: 20

The number of messages to return per page.

Required range: 1 <= x <= 100

page[number] · integer · default: 1

The page number to retrieve.

Required range: x >= 1

Response

200

application/json

Successful Response

data · Data · object[] · required

Show child attributes

meta · Meta · object · required

Show child attributes