Get conversation messages

GET 
/ai/conversations/:conversation_id/messages

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

Path Parameters

conversation_id stringrequired

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object[]

required

Array [

role stringrequired

Possible values: [user, assistant, tool]

The role of the message sender.

text stringrequired

The message content. Can be null for tool calls.

tool_calls

object[]

Optional tool calls made by the assistant.

Array [

id stringrequired

Unique identifier for the tool call.

type stringrequired

Possible values: [function]

Type of the tool call.

function

object

required

name stringrequired

Name of the function to call.

arguments stringrequired

JSON-formatted arguments to pass to the function.

]

Optional tool calls made by the assistant.

created_at date-time

The datetime the message was created on the conversation. This does not necesarily correspond to the time the message was sent. The best field to use to determine the time the end user experienced the message is sent_at.

sent_at date-time

The datetime the message was sent to the end user.

]

meta

object

required

total_pages integerrequired

total_results integerrequired

page_number integerrequired

page_size integerrequired

{
  "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": 0,
    "total_results": 0,
    "page_number": 0,
    "page_size": 0
  }
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/ai/conversations/:conversation_id/messages' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 422

---

{
  "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": 0,
    "total_results": 0,
    "page_number": 0,
    "page_size": 0
  }
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}