Get session history

GET

https://your-agent-backend.example.com/api/v1/sessions/:session_id/history

GET

/api/v1/sessions/:session_id/history

1 curl https://your-agent-backend.example.com/api/v1/sessions/session_id/history \
2      -H "Authorization: Bearer <token>"

1 {
2   "session": {
3     "id": "string",
4     "user_id": "string",
5     "status": "string",
6     "channel": "string",
7     "client_info": {},
8     "active_intents": [
9       "string"
10     ],
11     "sentiment_scores": [
12       1.1
13     ],
14     "escalation_risk": 1.1,
15     "created_at": "2024-01-15T09:30:00Z",
16     "updated_at": "2024-01-15T09:30:00Z",
17     "current_topic": "string",
18     "last_activity_at": "2024-01-15T09:30:00Z",
19     "ended_at": "2024-01-15T09:30:00Z"
20   },
21   "turns": [
22     {
23       "id": "string",
24       "session_id": "string",
25       "turn_number": 1,
26       "role": "string",
27       "content": "string",
28       "content_type": "string",
29       "entities": {},
30       "agents_used": [
31         "string"
32       ],
33       "was_interrupted": true,
34       "created_at": "2024-01-15T09:30:00Z",
35       "audio_duration_ms": 1,
36       "transcription_confidence": 1.1,
37       "intent": "string",
38       "intent_confidence": 1.1,
39       "sentiment": 1.1,
40       "processing_time_ms": 1
41     }
42   ],
43   "total_turns": 1
44 }

Load a session and the conversation turns associated with it.

Authentication

AuthorizationBearer

Send the agent framework auth token as Authorization: Bearer <token>.

Path parameters

session_idstringRequired

Query parameters

limitintegerOptionalDefaults to 50

Response

Session history returned successfully.

sessionobject

turnslist of objects

total_turnsinteger

Errors

401

Unauthorized Error

404

Not Found Error