COconsensys
Sessions

Create session

Changed on

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

Request

  • Base URL
    /api/plugins/consensys-asko11y-app/resources (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    • API key in cookie grafana_session
    • or HTTP bearer

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

Changes

  • 9762a43a4598Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • c2ffd094cb5dRevision changes
    • info

      added the optional property to the response with the status