---
title: "Set this account's monthly spend cap"
method: POST
path: "/v1/account/spend-cap"
tags: ["Account"]
---

# Set this account's monthly spend cap

`POST /v1/account/spend-cap`

## Request

- Base URL: `https://api.galleyrender.com`
- URL: `https://api.galleyrender.com/v1/account/spend-cap`
- Auth: HTTP bearer

The cap bounds what you are billed **past** your plan's allowance, at your plan's own rate, over your Stripe billing period. The pages and images the plan includes never count toward it, so a cap of `0` means "never bill me past my plan" rather than "stop rendering". On an annual plan the figure is monthly and the period cap is twelve times it.

Anything from `0` to the maximum in `max_self_serve_usd` (also on `GET /v1/account` as `limits.monthly_spend_cap_max_usd`). Above that, write to support@galleyrender.com.

Free accounts and keyless trials cannot be billed and are never capped: the setting is stored and `applies_now` is `false` until the account is on a paid plan.

A rise is emailed to the account's verified address, because a key is the account and the inbox is the one place a key holder cannot reach.

## Request body

- object
  - `monthly_spend_cap_usd` number, required: US dollars a month, cents allowed. `0` means no overage at all.

## Response `200`

Set. In force from the next render on a paid plan.

- object
  - `object` 'spend_cap', required
  - `account` string, required
  - `plan` string
  - `monthly_spend_cap_usd` number, required
  - `previous_monthly_spend_cap_usd` number
  - `period_spend_cap_usd` number: What the cap is over the billing period: twelve times the monthly figure on an annual plan.
  - `period_months` integer
  - `max_self_serve_usd` number
  - `applies_now` boolean
  - `effect` string
  - `raise_above_the_maximum` string
  - `docs_url` string, uri

## Other responses

- `400`: `invalid_request`: not a number, negative, or above the maximum.
- `401`: `authentication_error`.
- `409`: `conflict`: the cap changed while this request was in flight.

---

[API](https://skmtc.dev/galleyrender/apis/galley-render-api.md) · [All operations](https://skmtc.dev/galleyrender/apis/galley-render-api/llms.txt) · [OpenAPI document](https://skmtc.dev/galleyrender/apis/galley-render-api/revisions/a85d68468cd2?raw)