v1

latestOpenAPI 3.0.3MIT2026-07-17323590.7 KB

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