---
title: "Update Spending Limit"
method: PUT
path: "/v1/admin/accounts/{user_id}/spending-limit"
tags: ["admin"]
---

# Update Spending Limit

`PUT /v1/admin/accounts/{user_id}/spending-limit`

Update a user's per-period spending limit.

- field absent → no-op
- field null → reset to billing-type default
- field number → set to that dollar amount

## Path parameters

- `user_id` string, required

## Headers

- `authorization` string

## Request body

- UpdateSpendingLimitRequest — Request to update a user's per-period spending limit (in dollars). `null` resets to the billing-type default (see `BILLING_TYPE_DEFAULTS`). The constraint applies on input parsing only — existing rows storing out-of-range values continue to read normally.
  - `spending_limit` integer, nullable — Per billing period in dollars; null = use type default

## Response `200`

Successful Response

- AdminAccountResponse — Full account info for admin view.
  - `user_id` string, required — User ID
  - `email` string, nullable — Account email
  - `billing_type` string — 'prepaid' or 'postpaid'
  - `spending_limit` integer, nullable — Spending limit per period in dollars
  - `balance_dollars` number, nullable — Prepaid shadow balance (dollars)
  - `rate_limits` AccountRateLimits — Current rate limits and real-time usage counters.
    - `rpm` RateLimitInfo — Rate limit for a single dimension (e.g. rpm, concurrency).
      - `usage` integer — Current usage in this window
      - `limit` integer, nullable — Maximum allowed (null = default/unlimited)
    - `concurrency` RateLimitInfo — Rate limit for a single dimension (e.g. rpm, concurrency).
      - `usage` integer — Current usage in this window
      - `limit` integer, nullable — Maximum allowed (null = default/unlimited)
  - `auto_charge` AutoChargeInfo — Auto-charge configuration.
    - `enabled` boolean — Whether auto-charge is enabled
    - `threshold` integer, nullable — Balance threshold
    - `amount` integer, nullable — Top-up amount
  - `created_at` string, nullable — Account creation timestamp
  - `updated_at` string, nullable — Last update timestamp

---

[API](https://skmtc.dev/beeble/apis/beeble-developer-api.md) · [All operations](https://skmtc.dev/beeble/apis/beeble-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beeble/beeble-developer-api/revisions/f35ce0de5d00/schema)