> ## 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.

# Schema reference

> Field-by-field reference for every agent configuration section, organised exactly like the canonical system schema, each linked to its dashboard page.

Every Agentheya agent is defined by a set of **configuration sections**. This chapter documents each one **field by field**, in the same hierarchy as the canonical system schema. Each section page links back to the dashboard page where you edit it.

<Info>These pages reflect exactly what the configuration validator accepts — author against them precisely.</Info>

## How configuration is stored

Each section is stored as JSON and validated on every write against its schema (`additionalProperties:false`, enums and `required` enforced, no coercion). Author against these pages exactly — unknown fields are rejected, not ignored.

## Tier layering

Sections and individual fields can be gated by plan tier (`x_min_tier`). The schema is served **layered to the caller's plan**: fields above your plan are stripped from reads and rejected on writes. A **Tier** column below and a badge on each field mark anything above the baseline. (Free trial = full Pro; Business unlocks the rest.)

## All sections

### Identity & purpose

| Section                                       | Shape  | Tier      | Edit in the dashboard                        |
| --------------------------------------------- | ------ | --------- | -------------------------------------------- |
| [`details`](/reference/details)               | object | All plans | [Details page](/sidebar-menu/details)        |
| [`public_details`](/reference/public_details) | object | All plans | [Public Details page](/sidebar-menu/details) |
| [`purpose`](/reference/purpose)               | object | All plans | [Purpose page](/sidebar-menu/purpose)        |
| [`rules`](/reference/rules)                   | array  | All plans | [Rules page](/sidebar-menu/rules)            |
| [`examples`](/reference/examples)             | array  | All plans | [Examples page](/sidebar-menu/examples)      |

### Knowledge & memory

| Section                                          | Shape  | Tier      | Edit in the dashboard                             |
| ------------------------------------------------ | ------ | --------- | ------------------------------------------------- |
| [`data_internal`](/reference/data_internal)      | object | All plans | [Internal Data page](/sidebar-menu/data-internal) |
| [`data_public`](/reference/data_public)          | object | All plans | [Public Data page](/sidebar-menu/data-public)     |
| [`knowledge_graph`](/reference/knowledge_graph)  | object | All plans | [Knowledge page](/sidebar-menu/knowledge)         |
| [`weaviate`](/reference/weaviate) *(deprecated)* | object | All plans | *Deprecated — no editor*                          |
| [`memory_schema`](/reference/memory_schema)      | object | All plans | [Memory page](/sidebar-menu/memory)               |

### Tools & capabilities

| Section                                     | Shape  | Tier      | Edit in the dashboard                       |
| ------------------------------------------- | ------ | --------- | ------------------------------------------- |
| [`connectors`](/reference/connectors)       | object | All plans | [Connectors page](/sidebar-menu/connectors) |
| [`tools`](/reference/tools)                 | array  | Pro       | [Tools page](/sidebar-menu/tools)           |
| [`builtin_tools`](/reference/builtin_tools) | object | Pro       | [Tools page](/sidebar-menu/tools)           |
| [`skills`](/reference/skills)               | object | All plans | [Skills page](/sidebar-menu/skills)         |
| [`plugins`](/reference/plugins)             | array  | Pro       | [Plugins page](/sidebar-menu/plugins)       |

### Channels & interface

| Section                                           | Shape  | Tier      | Edit in the dashboard                             |
| ------------------------------------------------- | ------ | --------- | ------------------------------------------------- |
| [`widget`](/reference/widget)                     | object | Pro       | [Widgets page](/sidebar-menu/widgets)             |
| [`im_channels`](/reference/im_channels)           | object | All plans | [IM channels page](/sidebar-menu/im-channels)     |
| [`feed_monitors`](/reference/feed_monitors)       | array  | All plans | [Feeds page](/sidebar-menu/feeds)                 |
| [`hooks`](/reference/hooks)                       | array  | Business  | [Hooks page](/sidebar-menu/hooks)                 |
| [`handoff_settings`](/reference/handoff_settings) | object | Pro       | [Human handoff page](/sidebar-menu/human-handoff) |
| [`a2a_card`](/reference/a2a_card)                 | object | Business  | [Details page](/sidebar-menu/details)             |

### Commerce & policies

| Section                                                     | Shape  | Tier      | Edit in the dashboard                 |
| ----------------------------------------------------------- | ------ | --------- | ------------------------------------- |
| [`pricing`](/reference/pricing)                             | object | All plans | [Pricing page](/sidebar-menu/pricing) |
| [`policy_tos`](/reference/policy_tos)                       | object | All plans | [Details page](/sidebar-menu/details) |
| [`policy_privacy`](/reference/policy_privacy)               | object | All plans | [Details page](/sidebar-menu/details) |
| [`policy_refund`](/reference/policy_refund)                 | object | All plans | [Details page](/sidebar-menu/details) |
| [`policy_acceptable_use`](/reference/policy_acceptable_use) | object | All plans | [Details page](/sidebar-menu/details) |

### Operations

| Section                               | Shape  | Tier     | Edit in the dashboard                       |
| ------------------------------------- | ------ | -------- | ------------------------------------------- |
| [`monitoring`](/reference/monitoring) | object | Business | [Monitoring page](/sidebar-menu/monitoring) |
| [`langfuse`](/reference/langfuse)     | object | Business | [Monitoring page](/sidebar-menu/monitoring) |

## Nested sub-schemas

Two sections have rich sub-schemas documented on their own granular pages:

* [`public_details.page_layout`](/sections/page-layout) — the ten public-chat-page block types (`hero`, `json_render`, `faq`, …).
* [`data_internal.external_stores`](/sections/data/external-stores) — external vector-store backends ([Pinecone](/sections/data/external-stores/pinecone), [Weaviate](/sections/data/external-stores/weaviate)).