Sign in
Spend Limits

Create a spend limit

Sets a limit for a product and period that has none. Send exactly one of amount and unlimited: true. The period's spend is checked at once: if it is already above the new limit, the product is blocked immediately (evaluation.blocked_now). Returns 409 when a limit already exists for the product and period; update it instead.

post/spend_limits

Request body

OR

Example request

{
  "product": "inference",
  "period": "daily",
  "amount": 100,
  "reason": "Team budget"
}

Response

The limit was created. evaluation says whether the change blocked the product.

Example response

{
  "data": {
    "record_type": "spend_limit",
    "product": "inference",
    "product_name": "Inference",
    "period": "daily",
    "period_start": "2026-09-24",
    "period_end": "2026-09-25",
    "limit": {
      "amount": "100",
      "origin": "self_service",
      "updated_at": "2026-09-24T09:12:03.412Z"
    },
    "effective_limit_usd": "100",
    "spend_usd": "37.41",
    "block": {
      "detected_at": "2026-09-24T08:41:17Z",
      "spend_usd": "10.20",
      "limit_usd": "10",
      "blocked_until": "2026-09-25"
    },
    "evaluation": {
      "spend_usd": "37.41",
      "note": "A block was lifted by Telnyx support today; this limit applies from tomorrow."
    }
  }
}

Changes

Changed in 1 of the 102 revisions of this API.1

Of the 102 revisions, 1 has no diff computed.