PApaywithlocus
Tenants

Set or clear account spend and balance controls

Sets the monthly hard ceiling, monthly spend-email threshold, and/or low-balance email threshold. Send at least one field; omitted fields keep their current value and an explicit null clears one. Amounts are positive USD with at most 6 decimal places, up to 1000000000, and alertThresholdUsd may not exceed monthlyLimitUsd. Once committed spend reaches the ceiling, burns are denied with TENANT_MONTHLY_SPEND_LIMIT_EXCEEDED until the window resets — the limit bounds new spend and never cancels in-flight calls. Personal changes require the account owner on a session authenticated within the last ten minutes; enterprise changes require a workspace owner or admin with MFA or passkey step-up in that window.

put/credits/tenants/me/spend-controls

Request

  • Base URL
    https://api.paywithlocus.com/api
  • URL
    https://api.paywithlocus.com/api/credits/tenants/me/spend-controls
  • Auth
    HTTP bearer

Headers

X-Locus-Step-Upstring password

Short-lived raw MFA/passkey step-up token bound to the authenticated Cognito subject. Send it alongside the dashboard Bearer token for workspace-administrator mutations when the base session does not itself prove MFA within the last ten minutes. Never send it with a tenant secret key.

Request body

monthlyLimitUsdstring

Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.

alertThresholdUsdstring

Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.

lowBalanceAlertUsdstring

Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.

Response

Updated controls

successunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.