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.
Auth: Accepts API key or OAuth Bearer (campaigns:write).
Authorizations
Pass your Soundlink sk_* API key as a Bearer token:
Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see
oauthBearer for that). Accepted on all Public API operations. Send
only one Authorization header per request.
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