Skip to main content
GET
/
chat
/
sessions
cURL
curl --request GET \
  --url https://api-prod.voltai.ai/chat/sessions/ \
  --header 'x-api-key: <api-key>'
{
  "total_sessions": 123,
  "used_sessions": 123,
  "available_sessions": 123,
  "active_user_ids": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.voltai.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use GET /chat/sessions/ to inspect how many floating sessions your organization is using. This matches the same 5-minute sliding window used for floating-seat limits on /chat/query/: after a user’s first question, that identity counts as one session until five minutes pass with no new messages. Additional questions in that window do not open extra sessions. Send your API key in the X-API-KEY header. No request body or query parameters are required.

​
Response Notes

  • total_sessions is the maximum number of floating sessions allowed for the organization. It is null when no limit is configured (unlimited).
  • used_sessions is how many distinct user_id values have at least one qualifying conversation in the last five minutes (the same rule as floating-seat counting).
  • available_sessions is the remaining capacity (total_sessions - used_sessions). It is null when unlimited.
  • active_user_ids lists those identities (the same user_id strings you send on /chat/query/).

​
Example Response

{
  "total_sessions": 10,
  "used_sessions": 3,
  "available_sessions": 7,
  "active_user_ids": [
    "usr_82af91",
    "usr_d4f012",
    "usr_7ba3ee"
  ]
}

​
Example Response (unlimited)

{
  "total_sessions": null,
  "used_sessions": 1,
  "available_sessions": null,
  "active_user_ids": [
    "usr_82af91"
  ]
}

Authorizations

​
x-api-key
string
header
required

Response

Session status

Floating-session usage for the organization. A session is active for five minutes after a user's first qualifying message; further messages in that window still count as one session per user identity.

​
total_sessions
integer | null
required

Maximum floating sessions allowed for this organization. null if unlimited.

​
used_sessions
integer
required

Number of distinct user identities with qualifying chat activity in the last five minutes.

​
available_sessions
integer | null
required

Remaining floating sessions (total_sessions - used_sessions). null if unlimited.

​
active_user_ids
string[]
required

Sorted list of user_id values that have an active floating session (recent activity in the five-minute window).