Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -1295,7 +1295,8 @@
{
"group": "Articles",
"pages": [
"help-center/you-do-not-have-enough-permissions"
"help-center/you-do-not-have-enough-permissions",
"help-center/when-do-budget-limits-reset"
]
}
]
Expand Down
33 changes: 33 additions & 0 deletions help-center/when-do-budget-limits-reset.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: "When do budget limits reset?"
description: "Understand when workspace and integration budget limits automatically reset"
---

Budget limits with periodic reset enabled refresh at fixed times:

| Reset period | When it resets |
|:---|:---|
| **Weekly** | Monday at 00:00 UTC |
| **Monthly** | 1st of each month at 00:00 UTC |

<Info>
Reset timing is based on calendar boundaries, not when you originally set the budget.
</Info>

## Where to check reset settings

Budget limits can be configured at multiple levels:

- **Workspace level**: Settings > Budget Allocation
- **Integration level**: Edit the integration and check the Periodic Reset setting

## Related

<CardGroup cols={2}>
<Card title="Workspace budget limits" icon="building" href="/product/administration/enforce-workspace-budget-limts-and-rate-limits">
Configure budgets at the workspace level
</Card>
<Card title="Integration budget limits" icon="plug" href="/product/ai-gateway/virtual-keys/budget-limits">
Configure budgets on individual integrations
</Card>
</CardGroup>
4 changes: 2 additions & 2 deletions product/administration/enforce-budget-and-rate-limit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
</Tip>

## Overview
For enterprises deploying AI at scale, maintaining financial oversight and operational control is crucial. Portkey's governance features for API keys provide finance teams, IT departments, and executives with the transparency and guardrails needed to confidently scale AI adoption across the organization.

Check warning on line 15 in product/administration/enforce-budget-and-rate-limit.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-budget-and-rate-limit.mdx#L15

Did you really mean 'Portkey's'?

By implementing budget and rate limits on API keys at both organization and workspace levels, you can:

Expand Down Expand Up @@ -63,8 +63,8 @@
</Frame>

- **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
- **Reset Weekly**: Budget limits reset every Monday at 00:00 UTC
- **Reset Monthly**: Budget limits reset on the 1st of each month at 00:00 UTC

## Rate Limits

Expand Down Expand Up @@ -113,7 +113,7 @@

### Default Recipients

When limits are reached or thresholds are crossed, Portkey automatically sends notifications to:

Check warning on line 116 in product/administration/enforce-budget-and-rate-limit.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-budget-and-rate-limit.mdx#L116

Did you really mean 'Portkey'?

- Organization administrators
- Organization owners
Expand All @@ -123,6 +123,6 @@

## Availability

These features are available to Portkey Enterprise customers and select Pro users. To enable these features for your account, please contact [support@portkey.ai](mailto:support@portkey.ai) or join the [Portkey Discord](https://portkey.ai/community) community.

Check warning on line 126 in product/administration/enforce-budget-and-rate-limit.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-budget-and-rate-limit.mdx#L126

Did you really mean 'Portkey'?

To learn more about the Portkey Enterprise plan, [schedule a consultation](https://portkey.sh/demo-16).

Check warning on line 128 in product/administration/enforce-budget-and-rate-limit.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-budget-and-rate-limit.mdx#L128

Did you really mean 'Portkey'?
Original file line number Diff line number Diff line change
Expand Up @@ -88,15 +88,15 @@
Workspace budgets can be set to automatically reset at regular intervals:

- **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
- **Reset Weekly**: Budget limits reset every Monday at 00:00 UTC
- **Reset Monthly**: Budget limits reset on the 1st of each month at 00:00 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.

Check warning on line 94 in product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx#L94

Did you really mean 'Portkey'?


## Notification System

When workspace limits are approached or reached, Portkey automatically sends notifications to:

Check warning on line 99 in product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx#L99

Did you really mean 'Portkey'?

- Organization administrators and owners

Expand All @@ -108,14 +108,14 @@
- **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

Check warning on line 111 in product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx#L111

Did you really mean 'Rollouts'?






### Set Workspace Budget and Rate Limits using Portkey Admin API

Check warning on line 118 in product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx#L118

Did you really mean 'Portkey'?

Use the Admin API to programmatically manage workspace budgets and rate limits.

Expand Down Expand Up @@ -163,4 +163,4 @@

## Availability

Workspace Budget Limits are available to Portkey Enterprise customers and select Pro users. To enable these features for your account, please contact [support@portkey.ai](mailto:support@portkey.ai) or join the [Portkey Discord](https://portkey.ai/community) community.

Check warning on line 166 in product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/administration/enforce-workspace-budget-limts-and-rate-limits.mdx#L166

Did you really mean 'Portkey'?
4 changes: 2 additions & 2 deletions product/ai-gateway/virtual-keys/budget-limits.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,13 @@
To apply budgets and rate limits at the workspace level (across keys), see [Enforce Workspace Budget and Rate Limits](/product/administration/enforce-workspace-budget-limts-and-rate-limits).
</Tip>

**Budget Limits on Providers** provide a simple way to manage your spending on AI providers (and LLMs) - giving you confidence and control over your application's costs.

Check warning on line 16 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L16

Did you really mean 'LLMs'?

Budget Limit is currently only available to **Portkey** [**Enterprise Plan**](https://portkey.ai/docs/product/enterprise-offering) customers. Email us at `support@portkey.ai` if you would like to enable it for your org.

Check warning on line 18 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L18

Did you really mean 'Portkey'?

## Setting Budget Limits on Providers

When creating a new integration on Portkey, you can set limits in two ways:

Check warning on line 22 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L22

Did you really mean 'Portkey'?

### Cost-Based Limits
Set a budget limit in USD that, once reached, will automatically expire the key to prevent further usage and overspending.
Expand All @@ -27,7 +27,7 @@
### Token-Based Limits
Set a maximum number of tokens that can be consumed, allowing you to control usage independent of cost fluctuations.

And you can set both these limtis for each workspace.

Check warning on line 30 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L30

Did you really mean 'limtis'?

> #### Key Considerations
>
Expand All @@ -37,7 +37,7 @@
> * Budget limits apply until exhausted or reset
> * Budget limits are applied only to requests made after the limit is set; they do not apply retroactively
> * Once set, budget limits **cannot be edited** by any organization member
> * Budget limit feature is available for **all LLMs** available on Portkey and will apply to **all members/workspaces** who have permission to use it.

Check warning on line 40 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L40

Did you really mean 'LLMs'?

Check warning on line 40 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L40

Did you really mean 'Portkey'?

## Alert Thresholds

Expand All @@ -62,8 +62,8 @@
- **Reset Monthly**: Budget limits automatically reset every month

### Reset Timing
- Weekly resets occur at the beginning of each week (Sunday at 12 AM UTC)
- Monthly resets occur on the **1st** calendar day of the month, at **12 AM UTC**, irrespective of when the budget limit was set prior
- Weekly resets occur at the beginning of each week (Monday at 00:00 UTC)
- Monthly resets occur on the **1st** calendar day of the month, at **00:00 UTC**, irrespective of when the budget limit was set prior

## Editing Budget Limits

Expand All @@ -71,20 +71,20 @@

## Monitoring Your Spending and Usage

You can track your spending and token usage for any specific provider by navigating to the Analytics tab and filtering by the **desired provider** and **timeframe**.

Check warning on line 74 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L74

Did you really mean 'timeframe'?

## Pricing Support and Limitations

Budget limits currently apply to all providers and models for which Portkey has pricing support. If a specific request log shows `0 cents` in the COST column, it means that Portkey does not currently track pricing for that model, and it will not count towards the providers's budget limit.

Check warning on line 78 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L78

Did you really mean 'Portkey'?

Check warning on line 78 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L78

Did you really mean 'Portkey'?

Check warning on line 78 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L78

Did you really mean 'providers's'?

For token-based budgets, Portkey tracks both input and output tokens across all supported models.

Check warning on line 80 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L80

Did you really mean 'Portkey'?

It's important to note that budget limits cannot be applied retrospectively. The spend counter starts from zero only after you've set a budget limit for a key.

## Availability

Budget Limits is currently available **exclusively to Portkey Enterprise** customers and select Pro users. If you're interested in enabling this feature for your account, please reach out to us at [support@portkey.ai](mailto:support@portkey.ai) or join the [Portkey Discord](https://portkey.ai/community) community.

Check warning on line 86 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L86

Did you really mean 'Portkey'?

## Enterprise Plan

To discuss Portkey Enterprise plan details and pricing, [you can schedule a quick call here](https://portkey.sh/demo-16).

Check warning on line 90 in product/ai-gateway/virtual-keys/budget-limits.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/ai-gateway/virtual-keys/budget-limits.mdx#L90

Did you really mean 'Portkey'?
4 changes: 2 additions & 2 deletions product/model-catalog/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,9 @@

## Understanding the Integrations Dashboard

Navigate to the [Integrations page](https://app.portkey.ai/integrations) in your Portkey organization settings. The page is organized into three tabs, each serving a distinct purpose:

Check warning on line 45 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L45

Did you really mean 'Portkey'?

* **`All`**: This is a comprehensive list of all 50+ providers Portkey supports. This is your starting point for connecting a new provider to your organization.

Check warning on line 47 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L47

Did you really mean 'Portkey'?
* **`Connected`**: This tab lists all the integrations that you have personally connected at the organization level. It's your primary view for managing your centrally-governed providers.
* **`Workspace-Created`**: This tab gives you complete visibility and governance over any integrations created *by Workspace Admins* for their specific workspaces. It ensures that even with delegated control, you maintain a full audit trail and can manage these instances if needed.

Expand Down Expand Up @@ -161,7 +161,7 @@
1. In your Integration settings, navigate to **Model Provisioning**
2. Select the configuration options:
- **Allow All Models**: Provides access to all models offered by the provider
- **Allow Specific Models**: Create an allowlist of approved models

Check warning on line 164 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L164

Did you really mean 'allowlist'?

**Important:** The model list you set here applies to all Providers created from this Integration. Workspaces will only see and be able to use the models you've enabled.

Expand Down Expand Up @@ -204,7 +204,7 @@

### Budget Limits

**Budget Limits on Integrations** provide a simple way to manage your spending on AI providers (and LLMs) - giving you confidence and control over your application's costs. They act as financial guardrails, preventing unexpected AI costs across your organization. These limits cascade down to all AI Providers created from this Integration.

Check warning on line 207 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L207

Did you really mean 'LLMs'?

#### Setting Budget Limits

Expand Down Expand Up @@ -232,7 +232,7 @@
> * Budget limits apply until exhausted or reset
> * Budget limits are applied only to requests made after the limit is set; they do not apply retroactively
> * Once set, budget limits **cannot be edited** by any organization member
> * Budget limits work for **all AI provider** created on Portkey using the given **integration**

Check warning on line 235 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L235

Did you really mean 'Portkey'?

#### Alert Thresholds

Expand All @@ -257,8 +257,8 @@
* **Reset Monthly**: Budget limits automatically reset every month

**Reset Timing:**
* Weekly resets occur at the beginning of each week (Sunday at 12 AM UTC)
* Monthly resets occur on the **1st** calendar day of the month, at **12 AM UTC**, irrespective of when the budget limit was set prior
* Weekly resets occur at the beginning of each week (Monday at 00:00 UTC)
* Monthly resets occur on the **1st** calendar day of the month, at **00:00 UTC**, irrespective of when the budget limit was set prior


### Rate Limits
Expand Down Expand Up @@ -295,7 +295,7 @@
> * Setting the limit to 0 disables the provider
> * Rate limits apply immediately after being set
> * Once set, rate limits **cannot be edited** by any organization member
> * Rate limits work for **all providers** available on Portkey and apply to **all organization members** who use the provider

Check warning on line 298 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L298

Did you really mean 'Portkey'?
> * After a rate limit is reached, requests will be rejected until the time period resets

#### Use Cases for Rate Limits
Expand All @@ -319,7 +319,7 @@

### Tracking Spending and Usage

Track spending, usage, and 40+ crucial metrics for any specific AI integration by navigating to the Analytics tab and filtering by the **desired key** and **timeframe**.

Check warning on line 322 in product/model-catalog/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (portkey-docs) - vale-spellcheck

product/model-catalog/integrations.mdx#L322

Did you really mean 'timeframe'?


<Frame>
Expand Down
Loading