> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pikarc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Plan Tiers

> Compare Pikarc plans, understand feature gating, and what happens on downgrade.

## Tier Comparison

| Feature                    |   Basic   |      Pro     |     Scale    |   Enterprise  |
| -------------------------- | :-------: | :----------: | :----------: | :-----------: |
| **Price**                  |    Free   |    \$25/mo   |    \$79/mo   |     Custom    |
| **Runs/month**             |   1,000   |    50,000    |   Unlimited  |   Unlimited   |
| **Concurrent runs**        | 3 (fixed) | Configurable | Configurable |  Configurable |
| **Data retention**         |   1 day   |    14 days   |    90 days   |    365 days   |
| **Per-user daily budgets** |     No    |      Yes     |      Yes     |      Yes      |
| **Kill switch**            |     No    |      No      |      Yes     |      Yes      |
| **Workspace daily budget** |    Yes    |      Yes     |      Yes     |      Yes      |
| **Billing**                |    None   |    Stripe    |    Stripe    | Contact sales |

## Feature Gating

Certain workspace settings are restricted by plan. The API returns `403` when you try to use a feature your plan doesn't include.

### Kill Switch

Available on **Scale** and **Enterprise** only. Attempting to enable it on Basic or Pro returns:

```json theme={null}
{
  "detail": "Kill switch is not available on the pro plan. Upgrade to Scale or Enterprise."
}
```

### Per-User Daily Budgets

Available on **Pro**, **Scale**, and **Enterprise**. Setting `user_daily_budget_usd` on Basic returns `403`.

### Concurrent Run Configuration

Basic plans are fixed at 3 concurrent runs. Pro and above can configure `max_concurrent_runs` to any value.

### Monthly Run Limit

* **Basic**: 1,000 runs/month
* **Pro**: 50,000 runs/month
* **Scale / Enterprise**: Unlimited

When the monthly limit is reached, new runs are denied with `MONTHLY_RUN_LIMIT_EXCEEDED`.

## Data Retention

Runs older than your plan's retention period are automatically cleaned up:

| Plan       | Retention |
| ---------- | --------- |
| Basic      | 1 day     |
| Pro        | 14 days   |
| Scale      | 90 days   |
| Enterprise | 365 days  |

The cleanup job runs every 6 hours, batch-deleting expired runs. Running runs are never deleted.

## Downgrade Behavior

When you downgrade your plan (e.g., Scale → Pro, or Pro → Basic), Pikarc automatically resets workspace configuration that the new plan doesn't support:

| Setting               | What happens on downgrade               |
| --------------------- | --------------------------------------- |
| Kill switch           | Disabled if new plan doesn't support it |
| Per-user daily budget | Cleared if new plan doesn't support it  |
| Max concurrent runs   | Capped to 3 if downgrading to Basic     |

These resets happen immediately when the plan change takes effect. Stripe downgrades take effect at the end of the billing period.

## Upgrading

Upgrades take effect immediately. From the dashboard:

1. Go to **Subscription**
2. Select your new plan
3. Complete checkout via Stripe (for Pro/Scale)

For Enterprise plans, email [support@pikarc.dev](mailto:support@pikarc.dev).

The frontend configuration page shows disabled controls with upgrade hints for features not available on your current plan.
