Enforce Workspace Budget and Rate Limits

​

Overview

• Allocate specific budgets to different departments, teams, or projects
• Prevent individual workspaces from consuming disproportionate resources
• Establish rate limits to ensure equitable API access across workspaces
• Maintain greater visibility and control over organization-wide AI expenditure

​

Accessing Workspace Budget Controls

1. In the app sidebar, click Workspace Control for the workspace you want to manage
2. Select the Budget Allocation tab
3. Add your workspace rate limits and budgets, then click Update

​

Who can manage workspace budgets

​

Setting Rate Limits

1. Toggle on Add Rate Limit
2. Choose your limit type:
   • Requests: Limit based on number of API calls
   • Tokens: Limit based on token consumption
3. Specify the limit value in the Set Rate Limit field
4. Select a time interval from the dropdown (Requests/Minute, Requests/Hour, Requests/Day)

​

Setting Budget Limits

1. Toggle on Add Budget
2. Choose your limit type:
   • Cost: Set a maximum spend in USD
   • Tokens: Set a maximum token usage
3. Enter the budget amount in the Budget Limit ($) field
4. Optionally, set an Alert Threshold ($) to receive notifications before reaching the full budget
5. Select a Periodic Reset option to determine when the budget refreshes

​

Alert Thresholds

1. Enter a value in the Alert Threshold ($) field
2. When usage reaches this threshold, notifications will be sent to configured recipients
3. The workspace continues to function until the full budget limit is reached

​

Periodic Reset Options

• No Periodic Reset: The budget limit applies until exhausted
• Reset Weekly: Budget limits reset every Sunday at 12 AM UTC
• Reset Monthly: Budget limits reset on the 1st of each month at 12 AM UTC

The configuration options for workspace budgets and rate limits are the same as other budget and rate limit controls in the Portkey app (for API keys and providers). If you’re familiar with those, this will feel identical—just applied at the workspace level.

​

Notification System

• Organization administrators and owners

​

Use Cases

• Departmental Allocations: Assign specific AI budgets to different departments (Marketing, Customer Support, R&D)
• Project Management: Allocate resources based on project priority and requirements
• Cost Center Tracking: Monitor and control spending across different cost centers
• Phased Rollouts: Gradually increase limits as teams demonstrate value and mature their AI use cases

​

Set Workspace Budget and Rate Limits using Portkey Admin API

• The endpoint updates a workspace and accepts both usage_limits (budgets) and rate_limits.
• Budget limits mirror the app controls: cost- or token-based, optional alert_threshold, and optional periodic_reset of weekly or monthly.
• Rate limits support request- or token-based throttling with units rpm (per minute), rph (per hour), or rpd (per day).

from portkey_ai import Portkey

portkey = Portkey(api_key="PORTKEY_API_KEY")

workspace = portkey.admin.workspaces.update(
    workspace_id="WORKSPACE_ID",
    # Workspace budgets (usage_limits): supports multiple entries
    usage_limits=[
        {
            "type": "cost",            # or "tokens"
            "credit_limit": 500,       # integer >= 1; dollars if type == "cost"
            "alert_threshold": 400,    # optional; integer >= 1
            "periodic_reset": "monthly"  # optional; "weekly" | "monthly"
        },
    ],
    # Workspace rate limits: supports multiple entries
    rate_limits=[
        {
            "type": "requests",  # or "tokens"
            "unit": "rpm",       # "rpm" | "rph" | "rpd"
            "value": 120         # integer
        },
    ],
)

print(workspace)

​

Availability