Increase wallet campaign budget
Raises budget for a wallet-funded campaign. Requires the
campaigns:write scope and an Idempotency-Key header.
Wallet campaigns only (generation: 3).
Modes (default current_and_renewals):
current_cycle— applies to the current billing cycle onlynext_renewal— adjusts the next-cycle daily budget (may useamount: 0withtargetDailyBudgetto set an absolute next-cycle target)current_and_renewals— applies to the current cycle and future renewals
Debits the organization wallet when the current cycle is increased.
Authorizations
Pass your Soundlink sk_* API key in the x-api-key header.
Keys can carry explicit scopes (for example campaigns:read, metrics:read, videos:write) enforced by the backend.
Deprecated, retiring 2026-08-17 — migrate to Authorization: Bearer sk_... (see apiKeyBearerAuth) before then.
Headers
A unique string identifying this request, used to safely retry write
operations (create, stop, budget increase/decrease) without repeating
side effects. Required on every request that references this parameter.
Reusing this key with an unchanged request body replays the original
response; reusing it with a different body returns
409 idempotency_key_conflict. Keys are honored for 24 hours.
1 - 255Path Parameters
Campaign identifier (UUID)
Body
Wallet debit / top-up amount in USD. Must be positive, except
mode: next_renewal with targetDailyBudget where amount may
be 0.
Defaults to current_and_renewals when omitted on increase requests.
current_cycle, next_renewal, current_and_renewals Optional absolute next-cycle daily budget (USD). Most useful with
mode: next_renewal.
x > 0