Struct MessagesUsageParams 

#[non_exhaustive]
pub struct MessagesUsageParams {

    pub starting_at: String,
    pub ending_at: Option<String>,
    pub bucket_width: Option<BucketWidth>,
    pub account_ids: Vec<String>,
    pub api_key_ids: Vec<String>,
    pub service_account_ids: Vec<String>,
    pub workspace_ids: Vec<String>,
    pub models: Vec<String>,
    pub context_window: Vec<ContextWindow>,
    pub service_tiers: Vec<ServiceTier>,
    pub inference_geos: Vec<InferenceGeo>,
    pub speeds: Vec<Speed>,
    pub group_by: Vec<MessagesGroupBy>,
    pub limit: Option<u32>,
    pub page: Option<String>,
}

Available on crate feature admin only.

Filters for UsageReport::messages.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

starting_at: String

RFC3339 start (inclusive). Required.

ending_at: Option<String>

RFC3339 end (exclusive).

bucket_width: Option<BucketWidth>

Bucket width.

account_ids: Vec<String>

Restrict to specific account IDs.

api_key_ids: Vec<String>

Restrict to specific API key IDs.

service_account_ids: Vec<String>

Restrict to specific service-account IDs.

workspace_ids: Vec<String>

Restrict to specific workspace IDs.

models: Vec<String>

Restrict to specific models.

context_window: Vec<ContextWindow>

Restrict to specific context windows.

service_tiers: Vec<ServiceTier>

Restrict to specific service tiers.

inference_geos: Vec<InferenceGeo>

Restrict to specific inference geos.

speeds: Vec<Speed>

Restrict to specific speeds (research preview, requires fast-mode-2026-02-01 beta).

group_by: Vec<MessagesGroupBy>

Group rows by these dimensions.

limit: Option<u32>

Maximum buckets per page.

page: Option<String>

Pagination cursor.

Implementations

impl MessagesUsageParams

pub fn starting_at(starting_at: impl Into<String>) -> Self

Build a new params with the required starting_at field.

Trait Implementations

impl Clone for MessagesUsageParams

fn clone(&self) -> MessagesUsageParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MessagesUsageParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MessagesUsageParams

fn default() -> MessagesUsageParams

Returns the “default value” for a type.