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

9762a43a4598

Sessions

Create session

Creates a new chat session. If this is the first session for the user/org, it is automatically set as the current session. Max 50 sessions per user/org; oldest sessions are auto-evicted when limit is reached.

post/api/sessions

Headers

X-Grafana-Org-Idstring

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

Request body

titlestring

Session title (auto-generated from first message if not provided)

Response

Session created

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