> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.joytokens.ai/llms.txt.

# Guardrails

> Manage reusable access and budget policies

The **Guardrails** menu lets you manage reusable **access and budget policies** for API keys.

Policy list fields: **Policy Name, Tier, Product, Industry Pack, Policy Preference, Quota, Updated Time, Actions**, and you can also view the disabled model count and IP rule count.

## Create Policy

Click **Create Policy** in the upper-right corner to open the creation dialog.

![Create guardrail policy](/_fern-files/_img/8e6f5869fa9518bb2475c65d48a1fa2a31de657afb900dcad8aa8b0c897dc335.webp)![](/_fern-files/_img/8c1ae8ab8641950413a12e538693db6e8f60590a17f5cbbfae16c7c281e9288d.webp)

### Step 1: Policy and model scope

* **Name**: Required; the display name of the policy
* **Description**: Optional; briefly describe the purpose of the policy, up to 200 characters
* **Tier**: Choose Flagship, Standard, Economy, or Auto mode (intelligent routing decides on demand)
* **Industry Pack**: Choose Customer Service, Software Development & Tools, Content Generation, or Finance & Compliance; unrestricted industry pack is also supported
* **Model List Mode**: Supports Blacklist and Whitelist modes
  * **Blacklist**: Block the selected models; all other models remain routable
  * **Whitelist**: Allow only the selected models; all other models are not routable
* **Model List**: Select the models to block or allow according to the chosen mode; selected models will not be routed by API keys bound to this policy

![Step 1: Policy and model scope](/_fern-files/_img/eea20cbd15a31b59240ed498bc7ba12e5c307526e51731aa60b14be5ba373193.webp)

### Step 2: Routing and limits

* **Policy Preference**: The priority used when intelligently selecting models; currently supports Cost First, Quality First, Speed First, or Balanced mode
* **IP Whitelist**: After specifying IPs or CIDR ranges, only these IPs or CIDRs can use the API keys bound to this policy; separate values with commas or new lines
* **Budget Cycle**: Once set, a generated key can no longer be used after its billing reaches the budget; supports daily and weekly settings. Note: daily and weekly cannot be set at the same time—choose one
* **Budget Amount**: The budget this policy can consume

![Step 2: Routing and limits](/_fern-files/_img/f31d59345d0fea250a8623f64da90971432700cb374f44c654ff372b4898342c.webp)

## Policy List

Supports filtering by parameter and by status. The «⋮» on each row lets you manage that policy.

Displayed fields: **Policy Name, Tier, Product, Industry Pack, Policy Preference, Quota, Actions**, and more.

Clicking **Actions** shows a dropdown with **View, Edit, and Delete**:

* **View**: View the policy configuration, tier, industry pack, policy preference, IP whitelist, budget cycle, budget amount, and other details
* **Edit**: Modify the current policy configuration. Note: it cannot be updated if the policy is being used by an active API Key
* **Delete**: Delete the current policy. Note: it cannot be deleted if the policy is being used by an active API Key

![Guardrails list](/_fern-files/_img/8e6f5869fa9518bb2475c65d48a1fa2a31de657afb900dcad8aa8b0c897dc335.webp)![](/_fern-files/_img/8c1ae8ab8641950413a12e538693db6e8f60590a17f5cbbfae16c7c281e9288d.webp)![](/_fern-files/_img/421ffaa24edeac64521adf6e542fb36cab3768abb4b6280e0c758e85b41e36a8.webp)![](/_fern-files/_img/8eb67f2ce9a8d8c8d0ff2b907da4e6d72345c502c98b8c68edb4f8a27fa6c84b.webp)