---
title: "analytics spend-limit"
description: "Set or remove the organization monthly spend cap"
canonical: "https://pgbeam.com/docs/cli/analytics/spend-limit"
last-updated: "2026-09-14T19:37:21.000Z"
---

# analytics spend-limit

> Set or remove the organization monthly spend cap

URL: https://pgbeam.com/docs/cli/analytics/spend-limit

Set a monthly USD spend cap for the active organization, or remove it with `--remove`. When the cap is reached, usage-based features are paused until the next billing period. Pass the amount in dollars (e.g. 250 for $250/mo).

## Usage

## Options

Option

Description

Required

Default

`<amount>`

Monthly spend cap in USD (e.g. 250). Omit when using --remove.

No

-

`--remove`

Remove the spend cap entirely

No

`false`

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Confirms the new spend cap (or its removal) and prints the current value. With `--json`, returns the updated organization plan object.