Update Cash Buying Settings
PUT/api/cash-buying/settings
Update any subset of the settings. Changes are written to the activity log with old and new values.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Fields (all optional):
- cash_source: manual | accounting
- credit_line_limit: number ≥ 0
- credit_line_account_ids: array of accounting account ids whose (liability) balance is the credit drawn
- bank_account_ids: array of accounting bank account ids that count as cash (empty = every bank account)
- reserve_floor: number ≥ 0, the base reserve
- include_sales_inflows: boolean, add estimated payouts (off by default)
- payout_lag_days: integer 0–120
- payout_haircut_pct: number 0–100
- horizon_weeks: integer 4–26
- unscheduled_payables_in_week_one: boolean
- book_currency: 3-letter currency the accounting book reports in, null = your home currency
- ranking_weights: object, or null to reset to the defaults. risk.high/medium/low/none/unknown 0–1, low_confidence_multiplier 0.1–1, default_markup_pct 0–500 (all required when the object is sent)
Permission: cash_buying.update. Token scope: accounting:write.
Balance fields: callers without the cash_buying.view_balances permission can still change settings, but the response omits credit_line_limit, reserve_floor, credit_line_account_ids and bank_account_ids (absent, not null).
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.