Assistant Chat

POST 
/ai/assistants/:assistant_id/chat

This endpoint allows a client to send a chat message to a specific AI Assistant. The assistant processes the message and returns a relevant reply based on the current conversation context.

Path Parameters

assistant_id Assistant Idrequired

application/json

Body

required

content Content (string)required

The message content sent by the client to the assistant

name Name (string)

The optional display name of the user sending the message

conversation_id Conversation Id (string)required

A unique identifier for the conversation thread, used to maintain context

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

content Content (string)required

The assistant's generated response based on the input message and context.

{
  "content": "Why did the cat sit on the computer? Because it wanted to keep an eye on the mouse!"
}

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/assistants/:assistant_id/chat' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "content": "Tell me a joke about cats",
  "name": "Charlie",
  "conversation_id": "42b20469-1215-4a9a-8964-c36f66b406f4"
}'

Response samples

• 200
• 422

---

{
  "content": "Why did the cat sit on the computer? Because it wanted to keep an eye on the mouse!"
}

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