Retrieves the full data graph for the specified conversation, including all ingested entries, participant state, and related artifacts.
URI: /api/v1/agentic/conversations/{conversationId}
HTTP Method: GET
Authentication: Bearer JWT
Path Parameters
| Parameter |
Required |
Description |
| conversationId |
Yes |
Conversation identifier. |
Query Parameters
| Parameter |
Required |
Description |
| owner_id |
Yes |
End-user's Individual ID. |
| session_id |
No |
Narrow retrieval to a specific session. |
| participant_id |
No |
Filter by participant ID. |
| owner_type |
No |
Type of profile (optional on this endpoint). |
| scope |
No |
Filter entry types. Values: messages, traces, or all. |
| page_token |
No |
Pagination token for retrieving next page. |
Request Headers
| Header |
Required |
Description |
| Authorization |
Yes |
Bearer JWT token. |
| agent_id |
Yes |
Agent identifier. |
Response Body Schema
| Field |
Type |
Nullable |
Description |
| conversationId |
String |
No |
Conversation identifier. |
| name |
String |
Yes |
Conversation name. |
| status |
String |
No |
Conversation status. |
| startTime |
String (ISO 8601) |
No |
Conversation start time. |
| endTime |
String (ISO 8601) |
Yes |
Conversation end time. |
| conversationOwnerId |
String |
No |
Owner identifier. |
| sessions |
Array |
No |
List of sessions in this conversation. |
| sessions[].sessionId |
String |
No |
Session identifier. |
| sessions[].status |
String |
No |
Session status. |
| sessions[].startTime |
String (ISO 8601) |
No |
Session start time. |
| sessions[].endTime |
String (ISO 8601) |
Yes |
Session end time. |
| sessions[].entries |
Array |
No |
List of entries in this session. |
| metadata |
Object |
Yes |
Conversation metadata. |
| nextPageToken |
String |
Yes |
Pagination token. Present if more results exist. |
Entry Fields
| Field |
Type |
Nullable |
Description |
| id |
String |
No |
Entry identifier. |
| interactionId |
String |
No |
Groups related entries (for example, a turn). |
| participantId |
String |
No |
Who generated this entry. |
| content |
String |
Yes |
Message or event content. |
| type |
String |
Yes |
Entry type. |
| timestamp |
String (ISO 8601) |
No |
Timestamp of the entry. |
| category |
String |
No |
Entry category. Values: Message, Trace, or Entry. |
| variable |
Map |
No |
Free-form key-value variables. |
Example Response
Status: 200 OK
{
"conversationId": "conv-123",
"name": "Support chat — order #4471",
"status": "COMPLETED",
"startTime": "2026-06-18T14:22:00Z",
"endTime": "2026-06-18T14:58:00Z",
"conversationOwnerId": "indiv-001",
"sessions": [
{
"sessionId": "sess-A",
"status": "COMPLETED",
"startTime": "2026-06-18T14:22:00Z",
"endTime": "2026-06-18T14:35:00Z",
"entries": [
{
"id": "entry-1",
"interactionId": "turn-1",
"participantId": "user-001",
"content": "Where is my order?",
"type": "user_message",
"timestamp": "2026-06-18T14:22:05Z",
"category": "Message",
"variable": { "lang": "en" }
}
]
}
],
"metadata": { "channel": "web" },
"nextPageToken": "eyJvZmZzZXQiOjEwMH0="
}
Error Codes
| Status Code |
Description |
| 400 |
Bad Request. Invalid query parameters. |
| 401 |
Unauthorized. Invalid or missing JWT token. |
| 404 |
Not Found. Conversation does not exist. |
| 500 |
Internal Server Error. |
