Understanding your usage patterns is essential for managing costs, optimizing resource allocation, and ensuring you stay within your plan limits. Usage statistics provide real-time insights into how you're using the platform, helping you make informed decisions about scaling, budgeting, and resource management.

The platform tracks multiple usage dimensions including token consumption from AI model interactions, conversation and message volumes, and counts of database resources like datasets, records, skillsets, and files. All metrics reset at the beginning of each billing period, providing a clear view of current-period consumption.

Fetching Current Usage

Retrieve comprehensive usage statistics for the current billing period to monitor consumption across all platform features and resources. The endpoint provides a complete snapshot of your usage in a single request.

GET /api/v1/usage/fetch
http

Response Breakdown

The usage response includes several key metrics:

Token Usage: Total number of tokens consumed by AI model interactions during the current billing period. Tokens represent the computational currency for language model operations including chat completions, content generation, and other AI-powered features. Higher token counts indicate more extensive AI usage.

Conversations: Number of conversation instances created. Each conversation represents a distinct interaction session with bots or agents. This metric helps track user engagement and conversation volumes across your applications.

Messages: Total message count across all conversations. This includes both user inputs and bot responses, providing insight into interaction depth and engagement levels. High message counts relative to conversation counts indicate longer, more detailed interactions.

Database Resources: Counts of various database entities:

• Datasets: Number of knowledge base collections created
• Records: Total number of records across all datasets
• Skillsets: Number of ability collections defined
• Abilities: Total number of custom abilities created
• Files: Number of files uploaded and stored
• Users: Number of sub-users or team members created

Usage Monitoring Best Practices

Regular usage monitoring helps you:

• Track Consumption Trends: Identify usage patterns and growth over time
• Optimize Costs: Understand which features drive costs and optimize accordingly
• Prevent Overages: Monitor approaching limits before hitting billing thresholds
• Capacity Planning: Make informed decisions about plan upgrades or scaling
• Resource Optimization: Identify unused or underutilized resources

Consider integrating usage statistics into your application dashboards or monitoring systems to maintain continuous visibility into platform consumption. Automated alerts based on usage thresholds can help prevent unexpected overages.

Note: Usage metrics are calculated in real-time but may include slight delays due to caching optimizations. For high-precision billing calculations, refer to your detailed billing statements which provide complete accuracy.