Create Message

POST 
/ai/conversations/:conversation_id/messages

Add a new message to the conversation. Used to insert a new messages to a conversation manually ( without using chat endpoint )

Path Parameters

conversation_id uuidrequired

The ID of the conversation

application/json

Body

required

role Role (string)required
content Content (string)
name Name (string)

tool_choice

object

anyOf

• MOD1
• MOD2

string

object

tool_calls object[]
tool_call_id Tool Call Id (string)
sent_at date-time

metadata

Metadata

property name*

object

anyOf

• MOD1
• MOD2
• MOD3
• MOD4

string

integer

boolean

Array [

anyOf

• MOD1
• MOD2
• MOD3

string

integer

boolean

]

200: Successful Response

application/json

• Schema

Schema

any

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 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "role": "string",
  "content": "string",
  "name": "string",
  "tool_choice": "string",
  "tool_calls": [
    {}
  ],
  "tool_call_id": "string",
  "sent_at": "2024-07-29T15:51:28.071Z"
}'

Response samples

• 422

---

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