Set low-balance alert
PUT
/v1/wallet/low-balance-alert
Ask to be emailed once your balance drops below a threshold, or pass a null/omitted threshold to turn the alert off. It never charges anything — it's a heads-up, deduped to at most once every rolling 24 hours.
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/low-balance-alert (#1890): the new balance threshold in USD, or
null to disable it.
Send an email once the balance falls to or below this amount, in USD; null disables the alert.
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.