Skip to content

cayu.sessions.UsageRollupQuery

Part of cayu.sessions.base. Read the Python API overview and install the required extra.

from cayu.sessions import UsageRollupQuery

Bounded event-time usage query with explicit current-session filtering.

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
start_at datetime required
end_at datetime required
sessions SessionAggregateFilter Field(default_factory=SessionAggregateFilter)
group_limit StrictInt Field(default=20, ge=1, le=100)
session_group_limit StrictInt | None Field(default=None, ge=1, le=100)
include_pricing_inputs StrictBool False
pricing_input_limit StrictInt Field(default=1000, ge=1, le=5000)
UsageRollupQuery.normalize_window_timestamp(value: datetime, info) -> datetime
UsageRollupQuery.validate_window() -> UsageRollupQuery

Release source · Runtime guarantees · Capability guides