Get aggregate totals for a session

Returns aggregate request count, token usage, cost, and duration for a single session.

GET /api/logs/sessions/{session_id}/summary

Error

A valid request URL is required to generate request examples

200

{
  "session_id": "<string>",
  "count": 123,
  "total_cost": 123,
  "total_tokens": 123,
  "started_at": "<string>",
  "latest_at": "<string>",
  "duration_ms": 123
}

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Path Parameters

session_id · string · required

Parent request ID identifying the session

Response

200

application/json

Session summary retrieved successfully

Aggregate totals for a single parent-request session

session_id · string

count · integer<int64>

total_cost · number

total_tokens · integer<int64>

started_at · string

Timestamp of the first log in the session (RFC3339 nanos)

latest_at · string

Timestamp of the most recent log in the session (RFC3339 nanos)

duration_ms · integer<int64>