Spend & Usage Alerts

Cost budgets let you define spending or usage thresholds for your Veriproof applications. When a threshold is crossed, Veriproof sends notifications to your configured notification channels (Slack, Microsoft Teams) and/or fires a webhook event.

CustomerAdmin and CustomerBusinessOwner can create and manage budgets. All roles can view budget status.

How Budgets Work

A budget tracks accumulated cost or session volume against a threshold within a measurement window. Veriproof evaluates budgets periodically and fires an alert when a threshold is first exceeded. A resolution event fires when the metric drops back below the threshold.

Measurement Windows

Window	Description
Monthly	Resets at the start of each calendar month (00:00 UTC on the 1st)
Daily	Resets at 00:00 UTC each day

Metric Types

Metric type	Description
`cost_usd`	Estimated USD cost for the period
`session_count`	Number of sessions ingested
`token_count`	Total tokens processed across sessions

Creating a Budget

Open Cost Budgets

Navigate to Settings → Billing → Cost Budgets and click Add Budget.

Configure the budget

Field	Description
Name	A descriptive label for this budget
Application	The application to monitor (or “All applications”)
Metric	What to measure: cost, session count, or token count
Threshold	The value that triggers an alert
Window	Monthly or daily
Alert at (%)	Optional: trigger at a percentage of the threshold before it’s fully reached (e.g. alert at 80% to get an early warning)

Add notification destinations

Select one or more notification channels (Slack / Teams) to receive the alert message. Optionally enable the Webhook checkbox to also fire an alert.triggered webhook event.

Save

Click Save budget. The budget starts tracking from the beginning of the current window.

Viewing Budget Status

The Settings → Billing → Cost Budgets page shows all budgets with their current utilization:

Column	Description
Name	Budget name
Application	Scope
Metric	Cost, sessions, or tokens
Threshold	Configured limit
Current	Current period value
Utilization	Percentage of threshold consumed (progress bar)
Status	OK / Warning / Critical / Triggered
Next reset	When the measurement window resets

Editing and Deleting Budgets

To edit a budget: click its name to open the budget detail, then click Edit.

To delete a budget: open the budget detail and click Delete. Deletion stops all future alerts from this budget and cannot be undone.

API


GET    /v1/cost/budgets               # List all budgets
POST   /v1/cost/budgets               # Create a budget
PUT    /v1/cost/budgets/{budgetId}    # Update a budget
DELETE /v1/cost/budgets/{budgetId}    # Delete a budget

Create a budget via API


POST /v1/cost/budgets
Content-Type: application/json
 
{
  "name": "Production — monthly cost cap",
  "applicationId": "app_xyz789",
  "metricType": "cost_usd",
  "threshold": 500.00,
  "window": "monthly",
  "alertAtPercent": 80,
  "notificationChannelIds": ["chan_01H5..."],
  "webhookEnabled": true
}

Notification Channels

Notification channels are the Slack workspaces or Microsoft Teams tenants that receive formatted alert messages.

Creating a Notification Channel

Navigate to Settings → Integrations → Notification Channels and click Add channel.
Select Slack or Microsoft Teams.
For Slack: authorize the Veriproof app in your Slack workspace and select the target channel.
For Teams: provide an Incoming Webhook URL for the Teams channel.
Click Send test message to verify the channel is working.
Save the channel.

Notification Channel API


GET    /v1/notification-channels                         # List channels
POST   /v1/notification-channels                         # Create a channel
GET    /v1/notification-channels/{channelId}             # Get a single channel
PUT    /v1/notification-channels/{channelId}             # Update a channel
DELETE /v1/notification-channels/{channelId}             # Remove a channel
POST   /v1/notification-channels/{channelId}/test        # Send a test message

Alert Message Format

Triggered budget alerts are sent as a formatted message:

[Veriproof Alert] Production — monthly cost cap
Threshold exceeded: $523.40 / $500.00 (104.7%)
Application: production-app
Window: Monthly (resets 2025-07-01)
View in portal →

Resolution messages are sent when the metric drops back below threshold at the end of a window or after a budget edit.

Alert Rules (Advanced)

The budget system described above is designed for simple cost and volume thresholds. For more complex alert logic (e.g. “alert when refusal rate exceeds 25% over a sliding 1-hour window”), use the Alert Rules system available in Alerts → Alert Rules in the Customer Portal. Alert rules support:

Metric-based thresholds on any governance or quality dimension
Sliding or fixed windows
Multi-condition AND/OR logic
The same notification channel and webhook delivery infrastructure

See the Monitoring & Alerting guide for full alert rule documentation.