Upgraded usage reporting and new Usage API
We have upgraded the usage reporting experience in the Contentful web app and released a new public Usage API. These updates provide comprehensive visibility into your consumption patterns, allowing you to track trends, identify anomalies, and make data-informed decisions about your resources.
Web app usage reporting updates
These improvements apply across the Asset Bandwidth, API Calls, Functions, and AI Actions dashboards:
- Custom date selector: You can now select any custom date range of up to 31 days, going back 12 months, to analyze specific periods of activity.
- Daily usage charts: A new daily chart displays absolute usage totals for your selected 31 day window, making it easier to pinpoint exact days with traffic spikes.
- 12 month trend charts: A new macro level chart displays usage aggregated by calendar month, helping you understand long term seasonal trends and plan capacity.
- Uncapped space breakdowns: The API Calls dashboard no longer limits the space breakdown to the top five spaces. You can view all active spaces and sort them by specific API types (CDA, CMA, CPA, or GraphQL).
New usage API and endpoint deprecation
Developers can now programmatically access the exact same granular usage data that powers the web app dashboards.
New endpoints: Use the /metric endpoint to pull time series data for any usage metric, and the /usages-detailed endpoint to pull granular, per asset bandwidth breakdowns. The Content Management API (CMA) JavaScript SDK has been updated to support these endpoints.
Endpoint deprecation: The release of the new Usage API marks the official deprecation of the legacy /organization_periodic_usages and /space_periodic_usages endpoints. Developers must migrate existing scripts to the new endpoints. Please review the breaking change and follow our migration guide to update your scripts to the new endpoints before February 28, 2027.
Learn more