v1

latestOpenAPI 3.1.02026-08-042453938.9 KB

Customers

Set customer spending cap

Set or update a per-customer spending cap. Supports DAILY_CHARGE_LIMIT, MONTHLY_CHARGE_LIMIT, and SINGLE_CHARGE_LIMIT. When autoBlock=true (default), charges are rejected at 100% of the cap. Requires a secret key (sk_*).

put/v1/customers/{id}/spending-cap

Path parameters

idstring required

Request body

capType'DAILY_CHARGE_LIMIT' | 'MONTHLY_CHARGE_LIMIT' | 'SINGLE_CHARGE_LIMIT' required

Type of spending cap

limitValuenumber required

Spending limit in USDC

autoBlockboolean

Auto-block charges when cap is reached (default: true)

Response

Spending cap set

idstring

capTypestring

limitValuestring

autoBlockboolean