v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Conversations

Create a conversation

Create a new AI Conversation.

post/ai/conversations

Request body

metadataobject

Metadata associated with the conversation. Set ai_disabled to true to create the conversation with AI message responses disabled.

namestring

Response

Successful Response

created_atstring date-time required

The datetime the conversation was created.

idstring uuid required

last_message_atstring date-time required

The datetime of the latest message in the conversation.

metadataobject required

Metadata associated with the conversation. Telnyx provides several pieces of metadata, but customers can also add their own. The reserved field ai_disabled (boolean) can be set to true to prevent AI-generated responses on this conversation. When ai_disabled is true, calls to the chat endpoint will return a 400 error. Set to false or remove the field to re-enable AI responses. This is useful when a human agent needs to take over the conversation mid-stream (e.g., a technician stepping in while AI was messaging a resident).

namestring

Example response

{
  "created_at": "2025-04-15T13:07:28.764Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "last_message_at": "2025-04-15T13:07:28.764Z",
  "metadata": {
    "assistant_id": "assistant-123",
    "telnyx_agent_target": "+13128675309",
    "telnyx_conversation_channel": "sms",
    "telnyx_end_user_target": "+13128675309"
  }
}