Sign in
Budgets

Create a new budget

Creates a new budget in the workspace. Exactly one scope variant must be set (workspace / project / identity / api_key / provider / model). At least one of limits.amount, limits.token_limit, or rate_limit.requests_per_minute MUST be provided. Uniqueness is enforced across (workspace_id, scope_kind, scope_target_id).

post/v2/budgets

Request body

is_activeboolean

Whether the budget should be active immediately. Defaults to true when omitted (handler enforces).

expires_atstring date-time

Optional expiration. When set in combination with is_active=true, the value MUST be in the future; the handler rejects past values.

Response

OK

Changes

Changed in 11 of the 254 revisions of this API.2610

  • 9642bb8e4f832See the full diff
    • ●

      removed the request property scope/allOf[BudgetScope]/factory

      request-property-removed

    • ●

      removed the optional property budget/allOf[BudgetRestResponse]/scope/allOf[BudgetScopeRestResponse]/factory from the response with the 200 status

      response-optional-property-removed

    This revision also has 39 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • a38e9ab597712See the full diff
    • ○

      added the new optional request property scope/allOf[BudgetScope]/factory

      new-optional-request-property

    • ○

      added the optional property budget/allOf[BudgetRestResponse]/scope/allOf[BudgetScopeRestResponse]/factory to the response with the 200 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 2f27caf6888c2See the full diff
    • ○

      added the new optional request property alerts

      new-optional-request-property

    • ○

      added the optional property budget/allOf[Budget]/alerts to the response with the 200 status

      response-optional-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • bee257c5b2482See the full diff
    • ●

      removed the request property alerts

      request-property-removed

    • ●

      removed the optional property budget/allOf[Budget]/alerts from the response with the 200 status

      response-optional-property-removed

    This revision also has 49 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 801f61a5a0562See the full diff
    • ○

      added the new optional request property alerts

      new-optional-request-property

    • ○

      added the optional property budget/allOf[Budget]/alerts to the response with the 200 status

      response-optional-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 42d5d20625272See the full diff
    • ●

      removed the request property alerts

      request-property-removed

    • ●

      removed the optional property budget/allOf[Budget]/alerts from the response with the 200 status

      response-optional-property-removed

    This revision also has 49 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • d418091db1632See the full diff
    • ○

      added the new optional request property alerts

      new-optional-request-property

    • ○

      added the optional property budget/allOf[Budget]/alerts to the response with the 200 status

      response-optional-property-added

  • bc4a415db9cb1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 54f62cd22dcd1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 46 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f21a1b29f8451See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 254 revisions, 71 have no diff computed.