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

# pricing

> Per-agent power-user pricing tiers (what your power-users pay to use the agent), the Stripe currency, and free-evaluation settings.

# `pricing` — Pricing

Per-agent power-user pricing tiers (what your power-users pay to use the agent), the Stripe currency, and free-evaluation settings.

**Section key** `pricing` · **Shape** object · **Tier** All plans\
**Edit in the dashboard:** [Pricing page](/sidebar-menu/pricing)\
**Related:** [Billing](/sidebar-menu/pricing)

## Fields

| Field               | Required | Type             | Allowed values / constraints | Default | Description                                                                                                                                                    |
| ------------------- | -------- | ---------------- | ---------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tiers`             | no       | array of object  | —                            | —       | Pricing tiers available to power-users. Leave empty for a free agent. All fields are optional — missing id/name are auto-defaulted on save. Item fields below. |
| `stripe_currency`   | no       | string           | —                            | —       | ISO currency code used for Stripe checkout. Defaults to 'usd'.                                                                                                 |
| `free_eval_enabled` | no       | boolean          | —                            | —       | Whether to offer new power-users a limited free-evaluation quota before requiring a paid tier.                                                                 |
| `free_eval_tokens`  | no       | number \| string | —                            | —       | Token budget for the free evaluation period. Empty string means no limit is set.                                                                               |

### `tiers` items

Pricing tiers available to power-users. Leave empty for a free agent. All fields are optional — missing id/name are auto-defaulted on save.

| Field                        | Required | Type            | Allowed values / constraints        | Default | Description                                                                                                                                                                                                                             |
| ---------------------------- | -------- | --------------- | ----------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                         | no       | string          | —                                   | —       | Stable unique tier ID, e.g. "tier\_1" or "pro". Auto-generated from the name when omitted.                                                                                                                                              |
| `name`                       | no       | string          | —                                   | —       | Tier name, e.g. "Basic", "Pro". Defaults to "Tier N" when omitted.                                                                                                                                                                      |
| `subtitle`                   | no       | string          | —                                   | —       | Optional short line shown under the tier name.                                                                                                                                                                                          |
| `tagline`                    | no       | string          | —                                   | —       | Short marketing tagline shown on the tier card.                                                                                                                                                                                         |
| `currency`                   | no       | string          | —                                   | —       | ISO currency code, e.g. "usd". Defaults to "usd".                                                                                                                                                                                       |
| `price_statement`            | no       | string          | —                                   | —       | Optional free-form price text shown instead of/next to the computed price.                                                                                                                                                              |
| `price_options`              | no       | array of object | —                                   | —       | Purchasable price points for this tier. Empty/absent = nothing to buy (display-only tier). Item fields below.                                                                                                                           |
| `features`                   | no       | array of string | —                                   | —       | List of features included in this tier.                                                                                                                                                                                                 |
| `per_agent_features_heading` | no       | string          | —                                   | —       | Optional heading shown above the per-agent feature list.                                                                                                                                                                                |
| `per_agent_features`         | no       | array of string | —                                   | —       | Optional per-agent feature list.                                                                                                                                                                                                        |
| `included_features_heading`  | no       | string          | —                                   | —       | Heading shown above the included-features list. Falls back to "Includes:".                                                                                                                                                              |
| `included_features`          | no       | array of string | —                                   | —       | Optional included-features list.                                                                                                                                                                                                        |
| `inherits_from`              | no       | string          | —                                   | —       | ID of an earlier tier this one builds on. Informational only.                                                                                                                                                                           |
| `cta_label`                  | no       | string          | —                                   | —       | Label for the tier card's CTA button. Falls back to "Select Plan".                                                                                                                                                                      |
| `highlight`                  | no       | boolean         | —                                   | —       | Visually highlight this tier card.                                                                                                                                                                                                      |
| `agent_user_dashboard_pages` | no       | array of string | —                                   | —       | Power-user dashboard page keys unlocked by this tier (e.g. rules, examples, data, widgets, schedules, im\_channels, email\_addresses, api\_keys, webhooks, handoff, mcp\_openapi, tools, hooks, feeds, users, crm). Absent = all pages. |
| `agent_user_tier_level`      | no       | enum            | one of `no_settings`, `solo`, `pro` | —       | DEPRECATED legacy capability level — use agent\_user\_dashboard\_pages instead.                                                                                                                                                         |
| `enabled`                    | no       | boolean         | —                                   | —       | Whether this tier is visible on the power-user pricing page. Absent = true.                                                                                                                                                             |
| `collapsed`                  | no       | boolean         | —                                   | —       | Editor-only: tier card collapsed state in the owner pricing editor.                                                                                                                                                                     |

### `tiers.price_options` items

Purchasable price points for this tier. Empty/absent = nothing to buy (display-only tier).

| Field               | Required | Type   | Allowed values / constraints                                                                    | Default | Description                                                       |
| ------------------- | -------- | ------ | ----------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------- |
| `price_cents`       | no       | number | min 0                                                                                           | —       | Price in cents. 0 = free.                                         |
| `credits_per_month` | no       | number | min 0                                                                                           | —       | Credits granted per month (or per bundle for one-time purchases). |
| `billing_type`      | no       | enum   | one of `subscription`, `subscription_yearly`, `token_bundle`, `interaction_bundle`, `per_query` | —       | Billing model. Absent = 'subscription' (monthly).                 |