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.

Veyra Docs TeamUpdated 2 min readVersion 3 · History

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

curl
# 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.

BudgetsCostsGovernance