Sessions metering (fast)

Overview

The sessions_metering_fast function provides a performance-optimized way to retrieve session metering data. This fast variant uses materialized views for improved query performance on large datasets. Use this endpoint to:

• Get quick session metering for billing dashboards
• Track session consumption at scale
• Generate fast usage reports for accounting

Quick start

query SessionsMeteringFast(
  $accountId: uuid!
  $deskIds: _uuid
  $brainIds: _uuid
  $startDate: timestamp
  $endDate: timestamp
) {
  rows: sessions_metering_fast(
    args: {
      account_id: $accountId
      desk_ids: $deskIds
      brain_parent_ids: $brainIds
      start_time: $startDate
      end_time: $endDate
    }
  ) {
    meaningful_sessions
    non_meaningful_sessions
    total_sessions
  }
}

Variables:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Parameters

Parameter	Type	Description
accountId	uuid!	Account identifier (required)
deskIds	_uuid	Filter by desk IDs
brainIds	_uuid	Filter by AI agent IDs
startDate	timestamp	Start date (format: yyyy-mm-dd)
endDate	timestamp	End date (format: yyyy-mm-dd)

Response fields

Field	Type	Description
meaningful_sessions	Int	Sessions with meaningful conversations
non_meaningful_sessions	Int	Sessions without meaningful conversations
total_sessions	Int	Total conversation sessions

Common use cases

Try it

Loading GraphQL Playground...

Monthly metering

Get monthly session metering:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Filter by desk

Get session metering for specific desks:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "deskIds": "{d2be0283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Filter by AI agent

Get session metering for specific AI agents:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "brainIds": "{a2wv9283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Example response

{
  "data": {
    "rows": [
      {
        "meaningful_sessions": 8250,
        "non_meaningful_sessions": 2180,
        "total_sessions": 10430
      }
    ]
  }
}