Budgets and costs
See what every run cost, set budgets for the organization, projects, agents and single tasks, and what happens at 80 and 100 percent.
Every run records what it cost. Budgets cap that spend before it happens, not after: when a limit is reached, the work pauses until a person decides to continue.
Where costs come from
Each run reports its provider, model, tokens and cost. Veyra adds them up by agent, task, project, routine and day. Runs on a subscription plan record the plan's fee separately from per-token use, so you can see both.
Note
Veyra's numbers are its own accounting of runs. They are not your provider's invoice, which may include use outside Veyra.
Read your costs
Open Costs:
- The summary shows this month's spend against the organization budget.
- Filters narrow by agent, project, model and date range; the share bar keeps a filtered view as a link.
- Daily charges charts spend per day.
- Subscriptions lists fixed-fee accounts. Edit a price you manage, link two accounts that are the same paid seat, or stop tracking one.
- Decisions and Fast responses tabs show the cost of those services.
If a run's cost could not be recorded, the summary lists it under run costs unavailable. Retry cost recording reprocesses the saved usage without running the agent again.
Budgets
Budgets are set in US dollars (the API uses cents).
| Scope | Period | Set it on |
|---|---|---|
| Organization | Calendar month (UTC) | Costs › Budgets or organization settings. |
| Project | Calendar month (UTC) | The project's Budget. |
| Agent | Calendar month (UTC) | The agent's Budgets tab. |
| Task | The task's lifetime | The task's Budget in Details or when you create it. |
You need the Manage budgets permission (budgets:manage).
What happens at the limit
| Reached | Effect |
|---|---|
| 80 percent | A warning. Agents are told to focus on what matters most. |
| 100 percent | A hard stop. The agent, project or task is paused and starts no new runs. |
A hard stop creates a budget card for the organization's Budget owner. From the card, Raise limit sets a higher budget and lets the work continue; Keep paused leaves it stopped. A new month lifts monthly stops automatically.
Limits overlap: work must be inside every budget that applies to it. Raising an agent's budget does not help if its project is also at its limit.
From the API
# Set an agent's monthly budget to $50
curl -X PATCH "https://intelligence-api.veyra.so/api/agents/$AGENT_ID" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"budgetMonthlyCents": 5000}'
# Spend summary for the organization
curl "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/costs/summary" \
-H "Authorization: Bearer $VEYRA_API_KEY"See Costs and budgets in the API reference.