Skip to main content
PUT
Set or replace a budget

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Body

application/json
scope
enum<string>
required
Available options:
account,
key,
agent
limits
object
required

Budget limits. At least one enforceable limit (maxSendsPerDay, maxNewRecipientsPerHour, or hardStopOnComplaint=true) is required. maxSpendPerDayCents is reserved for V2 and accepted but not yet enforced.

scopeId
string | null

Required for key/agent scopes (an api_key id you own); omit for the account scope.

enabled
boolean
default:true

Response

Success

budget
object
required

A fail-closed spend/send budget for an account, key, or agent scope.