latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-11333695.0 KB

9762a43a4598

Sessions

Get session by ID

Returns full session details including all messages. Only the session owner (same user + org) can access it.

get/api/sessions/{sessionId}

Path parameters

sessionIdstring required

Session ID (base64 URL-safe 32-byte token)

Headers

X-Grafana-Org-Idstring

Grafana organization ID for multi-tenant isolation. Defaults to '1' if not provided.

Response

Session details

idstring required

Session ID (base64 URL-safe 32-byte token)

titlestring required

Session title

summarystring

Session summary

createdAtstring date-time required
updatedAtstring date-time required
messageCountinteger required

Total number of messages

activeRunIdstring

ID of currently active agent run (if any)

model'base' | 'large'

LLM app model abstraction locked to this session, if selected

runCountinteger

Number of completed agent runs (turns) in this session

totalIterationsinteger

Sum of agent-loop iterations (LLM round-trips) across all runs

toolCallCountinteger

Sum of tool calls executed across all runs

promptTokensinteger

Sum of LLM prompt tokens across all runs

completionTokensinteger

Sum of LLM completion tokens across all runs

totalTokensinteger

Sum of LLM prompt + completion tokens across all runs