How do I set a monthly AI spending limit?

Create a hard budget that blocks or degrades AI calls before charges hit your provider bill — in under 5 minutes.

Goal: A monthly spending limit enforced at the proxy — so overspend is impossible, not just alerted.

Time: 5 minutes.

Step 1 — Go to Budgets and create a new budget

Open Budgets → New Budget.

Fill in the form:

Field	What to enter
Name	Something descriptive — `Engineering monthly`, `chatbot feature`, `Org total`
Monthly limit	Your budget in USD
Scope	See below
Enforcement	See below
Alert thresholds	Pick from preset toggles (25/50/75/80/90/95/100%) — default preselected is `50, 80, 100`

Alert thresholds only produce a notification if you've routed Budget Alerts to a Slack channel in Settings → Slack Alerts — Slack is currently the only delivery channel for budget alerts, there's no separate email digest.

Choosing the scope:

Scope	Use when
Global	One limit for your entire organisation's AI spend
Department	Limit a team — needs `X-Cost-Department: engineering` in your calls
Feature	Limit a single product feature — needs `X-Cost-Feature: chatbot` in your calls

Choosing enforcement:

Mode	What happens when the limit is hit
Alert	Call goes through, you get a notification. Good for monitoring.
Degrade	Call is rerouted to a cheaper model. Good for production features.
Block	Call returns 429. Good for experimental features and agents.

Start with Alert, graduate to Block

If you're not sure which to pick, start with Alert for 2 weeks to understand normal spend patterns. Then switch to Block or Degrade once you're confident in the limit.

Step 2 — Save and verify

Click Save. The budget appears on the Budgets page immediately, and you can see its current spend vs. limit there.

To check remaining budget programmatically, call the status endpoint rather than reading a response header — there's no x-cog-budget-remaining header on proxy responses:

import httpx
 
resp = httpx.get(
    "https://api.cognocient.com/api/budgets/status",
    params={"feature": "chatbot"},
    headers={"Authorization": f"Bearer {COG_API_KEY}"},
)
print(resp.json())  # includes can_proceed and percent_used

Step 3 — Test the enforcement (optional)

To verify the block mode works: temporarily set the budget to $0.01, make a call, confirm you get a 429. Then restore the real limit.

Useful follow-ups

Multiple levels — Add a department budget on top of feature budgets. The tightest limit always wins. See Hierarchical Budgets.
Agent workflows — Add a per-run limit so one runaway agent can't consume your entire feature budget. See Track Cost Per Agent Run.
Get alerted in Slack — Route Budget Alerts to a Slack channel so threshold hits show up where your team already works. See Slack Alerts.

How do I set a monthly AI spending limit?

Step 1 — Go to Budgets and create a new budget

Step 2 — Save and verify

Step 3 — Test the enforcement (optional)

Useful follow-ups

On this page