Skip to main content
GET
/
ext
/
conversation
/
{id}
Retrieve Conversation details by ID
curl --request GET \
  --url https://api.trugen.ai/v1/ext/conversation/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "6457541c-6251-40ed-a672-52d166c2c565",
  "agent_id": "6d142a7c-a6ef-4616-90bb-0124fc83bce7",
  "agent_name": "Test Agent",
  "avatar_id": "665a1170",
  "user_id": "test@test.com",
  "user_name": "Test User",
  "context": "{\"text\":\"\"}",
  "status": "ENDED",
  "is_recorded": false,
  "recording_url": "",
  "transcript": [
    {
      "timestamp": "2025-12-18T17:54:20.412417Z",
      "role": "assistant",
      "content": "Hello, how can I help you?",
      "conversation_id": "6457541c-6251-40ed-a672-52d166c2c565",
      "message_timestamp": 2
    }
  ],
  "created_at": "2025-12-18T17:54:02.153319Z",
  "updated_at": "2025-12-18T17:59:29.720601Z"
}

Authorizations

x-api-key
string
header
required

Path Parameters

id
string<uuid>
required

Unique identifier for the conversation

Response

Conversation details retrieved successfully

id
string<uuid>

Unique identifier for the conversation

Example:

"6457541c-6251-40ed-a672-52d166c2c565"

agent_id
string<uuid>

Agent identifier

Example:

"6d142a7c-a6ef-4616-90bb-0124fc83bce7"

agent_name
string

Name of the agent

Example:

"Test Agent"

avatar_id
string

Avatar identifier used for the conversation

Example:

"665a1170"

user_id
string

End user identifier

Example:

"test@test.com"

user_name
string

End user name

Example:

"Test User"

context
string

Serialized conversational context

Example:

"{\"text\":\"\"}"

status
enum<string>

Session status

Available options:
STARTED,
IN_PROGRESS,
ENDED
Example:

"ENDED"

is_recorded
boolean

Whether the session was recorded

Example:

false

recording_url
string

Recording playback URL

Example:

""

transcript
object[]

Conversation transcript

created_at
string<date-time>

Session creation timestamp

Example:

"2025-12-18T17:54:02.153319Z"

updated_at
string<date-time>

Last update timestamp

Example:

"2025-12-18T17:59:29.720601Z"