ORorq-ai
Budgets

Create a new budget

Changed on

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). Requires a Management Key with the Budgets permission; project-scoped API keys cannot manage budgets.

post/v2/budgets

Request

  • Base URL
    https://my.orq.ai
  • URL
    https://my.orq.ai/v2/budgets
  • Auth
    HTTP bearer

Request body

is_activeboolean

Whether the budget should be active immediately. Defaults to true when omitted.

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

  • 0b4e519a544fRevision changes
    • breaking

      removed the enum value BUDGET_ALERT_DIMENSION_UNSPECIFIED of the request property //

    • breaking

      removed the enum value BUDGET_PERIOD_UNSPECIFIED of the request property /////

    • info

      added the non-success response with the status

    • info

      removed the BUDGET_ALERT_DIMENSION_UNSPECIFIED enum value from the /////// response property for the response status

    • info

      removed the BUDGET_PERIOD_UNSPECIFIED enum value from the ////// response property for the response status

  • 732aed62833aRevision changes
    • warning

      added the new BUDGET_ALERT_DIMENSION_UNSPECIFIED enum value to the /////// response property for the response status

    • warning

      added the new BUDGET_PERIOD_UNSPECIFIED enum value to the ////// response property for the response status

    • info

      added the new BUDGET_ALERT_DIMENSION_UNSPECIFIED enum value to the request property //

    • info

      added the new BUDGET_PERIOD_UNSPECIFIED enum value to the request property /////

    • info

      removed the non-success response with the status