CH·02CLI reference

deeprelay spend-limit

View, set or clear the org monthly spending limit and daily spend cap

Synopsis

Show the org's current monthly spending limit and opt-in daily spend cap, along with how much has been spent this month and today — or set them.

The monthly limit counts pay-as-you-go spend charged to the balance over the UTC calendar month and resets at 00:00 UTC on the 1st. Once it is reached, requests charged to the balance are refused until that reset, or until an admin raises or removes the limit. Usage covered by a plan does not count against it.

The daily cap is a sibling to the monthly limit: both can be set, and the tighter applicable limit wins. It defaults to none — deeprelay.ai never imposes a platform default cap. Use it to bound the blast radius of a compromised key or a runaway script: once the org's spend in the current UTC day reaches the cap, new spend is blocked until the next day.

With no write flags, deeprelay spend-limit shows the current settings. Setting a limit requires org-admin privileges; a non-admin member gets a permission error.

--clear removes the limit entirely — both the monthly limit and the daily cap. It is the only way to remove a monthly limit, since --monthly has a $1.00 floor and so cannot express "no limit". It is org-admin only, like every other write here. When no limit is set there is nothing to remove: the command says so and exits 0, so an idempotent teardown script does not fail on its second run.

Examples

# Show the current monthly limit + daily cap and spend so far
deeprelay spend-limit

# Set a $25/day cap (leaves the monthly limit unchanged)
deeprelay spend-limit --daily 25

# Set both the monthly limit and the daily cap
deeprelay spend-limit --monthly 1000 --daily 50

# Remove the daily cap (monthly limit stays)
deeprelay spend-limit --clear-daily

# Remove the spending limit entirely (monthly limit and daily cap)
deeprelay spend-limit --clear

# JSON for scripting
deeprelay spend-limit --output json | jq '.daily_limit_dollars'

deeprelay spend-limit [flags]

Options

      --clear           Remove the spending limit entirely (monthly limit and daily cap); org-admin only
      --clear-daily     Remove the daily spend cap
      --daily float     Set the opt-in daily spend cap in USD
  -h, --help            help for spend-limit
      --monthly float   Set the monthly spending limit in USD (min 1.00)

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")

Synopsis

Examples

Options

Options inherited from parent commands

SEE ALSO