Credits

What credits are

Credits control how many agent runs you can execute per month — but only on the Free plan. Builder, Startup, and Enterprise have no credit limit at all: agent chat is unlimited on paid tiers, since metering a basic feature like talking to your own agent adds friction without a cost-recovery purpose. Each run costs credits based on its complexity. On Free, when your credit balance reaches zero, runs are rejected until the next monthly reset.

Credit cost per run

Complexity is determined by Valta based on the task scope, number of actions taken, and duration. You are not charged for runs that fail before they start (e.g. due to an AGENT_FROZEN or CREDITS_EXHAUSTED error).

Monthly allowances by plan

On Free, credits reset on the 1st of each month at midnight UTC and unused credits do not roll over. Referring another user tops up your balance before the reset — see your dashboard for details. Builder and up have nothing to track: there's no balance, no reset date, and no limit.

Checking your credit balance

import { ValtaClient } from 'valta-sdk'

const valta = new ValtaClient({ apiKey: process.env.VALTA_API_KEY })

const me = await valta.auth.whoami()

console.log(me.creditsRemaining) // e.g. 32 on Free — null on Builder/Startup/Enterprise (unlimited)
console.log(me.plan)             // 'free' | 'builder' | 'startup' | 'enterprise'

What happens when credits run out

This only applies on the Free plan — Builder and up never hit this. When your balance is insufficient to start a run:

• The run is rejected with HTTP 402
• The error code is CREDITS_EXHAUSTED
• No partial run is executed
• No credits are deducted

import { ValtaClient, ValtaError } from 'valta-sdk'

const valta = new ValtaClient({ apiKey: process.env.VALTA_API_KEY })

try {
  const run = await valta.agents.run(agent.id, { task: 'Process invoices.' })
} catch (err) {
  if (err instanceof ValtaError && err.code === 'CREDITS_EXHAUSTED') {
    console.log('Out of credits. Resets on the 1st of next month.')
  }
}

This is tied to your account's actual plan, not to beta status specifically. Every new account starts on Free (50 credits/month); upgrading to Builder, Startup, or Enterprise removes the credit limit immediately, beta or not.

Next steps

• Platform Status

• Agents SDK