Set spending limit
PUT
/v1/wallet/spending-limit
Set a hard $/month ceiling on the signed-in user's spend, or pass a null/omitted amount to turn it off. Once the calendar month's measured charges reach the limit, processing pauses the same way it does when the wallet runs out of credit; the limit resets automatically on the 1st.
Authorizations
Bearer
JWT bearer token from POST /v1/auth/login.
Type
HTTP (bearer)
or
ApiKey
Scoped API key for non-interactive clients (issued by PBI #1426).
Type
API Key (header: X-Api-Key)
Request Body
application/json
Payload for PUT /wallet/spending-limit (billing guardrails, #1890): the new monthly cap in USD, or
null to disable it.
The new monthly spending cap, in USD; null disables the limit.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"Responses
OK
application/json
What the user sees of their wallet: a remaining balance, or — for a whitelisted account — that the
work is included at no charge.
The amount (#1889) auto top-up adds each time it fires, or null when disabled.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"The owner's opt-in auto-top-up monthly cap (#1889), or null for no cap.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"The owner's opt-in auto-top-up "balance below $X" threshold (#1889), or null when disabled.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"Spendable credit: BalanceUsd − ReservedUsd (#1479). This is the
figure the affordability gate uses, so a client that shows the raw balance while the gate compares
against this will disagree with it whenever a batch is in flight — show this as the spendable number, and
the balance as the settled one.
Default
0Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"Remaining prepaid credit in USD (meaningless when Unlimited).
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"Currency code for BalanceUsd (always USD for now).
Default
"USD"True when a charged account's balance has fallen to/below the configured low-balance threshold — the
cue an agent uses to prompt a top-up before the next batch is blocked. Always false when Unlimited.
Default
falseThe owner's opt-in low-balance email alert threshold (#1890), or null when disabled.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"The owner's opt-in monthly spending ceiling (#1890), or null when disabled.
Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"Credit currently held against batches that are in flight but not yet charged (#1479) — the committed
never-exceed quotes of the owner's queued/running jobs. Always 0 when Unlimited
(such an account is never charged, so nothing is ever held).
Default
0Format
"double"Pattern
"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"True for a whitelisted account — show "included / no charge", not a balance.