Logo
Search
API Docs

Spending Limits & Cost Monitoring

Account & Team Management

Spending Limits & Cost Monitoring Alerts

Overview

Billing, Usage & Cost Tracking covers how credit-based billing works and how to read the cost breakdown on a single call. Analytics API: Custom Metric Queries covers how to pull that same cost data programmatically. This page covers the piece those two don't: the proactive workflow for capping spend and getting notified automatically when it moves outside expected patterns — setting an organization-wide spending limit, building a cost-monitoring dashboard, and configuring automated spending alerts.


Setting an Organization Spending Limit

You can set a monthly spending limit for your organization from Dashboard > Settings > Billing. This gives you a hard ceiling on monthly spend, separate from the reserved concurrency and add-on settings described in Billing, Usage & Cost Tracking.


Monitoring Spending Patterns: Boards & the Analytics API

Before you need an alert to fire, it helps to have an at-a-glance view of where spend is trending. You can build this either as a visual dashboard using Boards, or by querying the same data directly through the Analytics API if you want to feed it into your own reporting.

Example Cost-Monitoring Dashboard Layout

WidgetTypeWhat it shows
Total Cost TodayText (KPI)Running total spend for the current day
Average Cost Per CallText (calculated metric){{totalCost}} / {{totalCalls}}
Cost Per MinuteText (calculated metric){{totalCost}} / ({{totalMinutes}} / 60)
Daily Spending TrendLine chartCost grouped by day over the selected time range
Cost by AssistantBar chartCost grouped by assistant, to spot which assistant is driving spend
Cost by Call TypePie chartCost split between inbound and outbound calls

See Observability: Boards, Logs & Analytics for the full Boards walkthrough, including how to set up calculated metrics, and Analytics API: Custom Metric Queries if you'd rather query cost and the costBreakdown.* columns directly from your own systems.


Automated Spending Alerts via Monitors

Rather than checking a dashboard manually, you can set up a Monitor that watches a cost metric continuously and notifies you the moment it crosses a threshold you define.

  1. Go to Observability > Monitors in the Dashboard and click New Monitor.
  2. Set Category to Infrastructure.
  3. Choose a Cost metric as the trigger, and set the threshold value that should fire the alert (for example, total cost exceeding a dollar amount within a given interval).
  4. Attach a Notifier — email, Slack, or webhook — so your team is actually notified when the monitor fires. If you don't already have a notifier configured, you can create one from the same Monitors area first.
  5. Save the monitor. It runs continuously in the background and raises an alert through your configured notifier whenever the cost threshold is crossed.

In summary: set your organization's monthly ceiling under Dashboard > Settings > Billing, use Boards or the Analytics API to keep an eye on spending patterns day to day, and layer a cost Monitor on top so you're notified automatically the moment spend crosses a threshold, instead of finding out after the fact.