Get Conversation Data Graph
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
| Parameter | Required | Description |
|---|
| conversationId | Yes | Conversation identifier. |
| Parameter | Required | Description |
|---|
| owner_id | Yes | End-user’s Individual ID. |
| agent_id | No | Agent identifier (also accepted as header). |
| 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. |
| Header | Required | Description |
|---|
| Authorization | Yes | Bearer JWT token. |
| agent_id | Yes | Agent identifier. |
| 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. |
| 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. |
Status: 200 OK
| 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. |