Get a conversation

Retrieve a specific AI conversation by its ID.

GET /ai/conversations/{conversation_id}

JavaScript

JavaScript

import Telnyx from 'telnyx';

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

const conversation = await client.ai.conversations.retrieve('conversation_id');

console.log(conversation.data);

200

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

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

The ID of the conversation to retrieve

Response

200

application/json

Successful Response

data · object

Show child attributes