Ellipsis APIReferenceSessions

Get Agent Session Turns

Return the session's conversation structure — its turns and inbox messages — for durable (keyed) sessions; empty lists for single-shot sessions. The session's per-conversation state (idle | running | closed) rides on the session object itself (session_state).

GET
/v1/sessions/{session_id}/turns

Return the session's conversation structure — its turns and inbox messages — for durable (keyed) sessions; empty lists for single-shot sessions.

The session's per-conversation state (idle | running | closed) rides on the session object itself (session_state).

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

session_id*Session Id

Header Parameters

user-agent?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/sessions/string/turns"
{  "messages": [    {      "agent_session_id": "string",      "author": "string",      "body": "string",      "closes_session": false,      "created_at": "2019-08-24T14:15:22Z",      "delivered_at": "2019-08-24T14:15:22Z",      "delivered_turn_id": "string",      "feed_seq": 0,      "id": "string",      "idempotency_key": "string",      "platform_ts": "string",      "sender_attribution_id": "string",      "sender_attribution_type": "github_user",      "status": "pending",      "webhook_id": "string",      "webhook_type": "github.issue"    }  ],  "turns": [    {      "agent_session_id": "string",      "completed_at": "2019-08-24T14:15:22Z",      "cost_fee": 0,      "cost_sandbox_cpu": 0,      "cost_sandbox_memory": 0,      "cost_tokens": 0,      "created_at": "2019-08-24T14:15:22Z",      "exit_status": "completed",      "id": "string",      "react_action": "string",      "sandbox_id": "string",      "session_execution_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "scheduled",      "status_reason": "string",      "tokens_cache_creation": 0,      "tokens_cache_read": 0,      "tokens_input": 0,      "tokens_model": "string",      "tokens_output": 0,      "tokens_total": 0,      "turn_index": 0,      "updated_at": "2019-08-24T14:15:22Z",      "webhook_id": "string",      "webhook_type": "github.issue"    }  ]}