Skip to main content

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.

Required scope: accounting:write

Grant 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​

OK

Response Headers
    Content-Type