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.

These pages reflect exactly what the configuration validator accepts — author against them precisely.

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	object	All plans	Details page
public_details	object	All plans	Public Details page
purpose	object	All plans	Purpose page
rules	array	All plans	Rules page
examples	array	All plans	Examples page

Knowledge & memory

Section	Shape	Tier	Edit in the dashboard
data_internal	object	All plans	Internal Data page
data_public	object	All plans	Public Data page
knowledge_graph	object	All plans	Knowledge page
weaviate (deprecated)	object	All plans	Deprecated — no editor
memory_schema	object	All plans	Memory page

Tools & capabilities

Section	Shape	Tier	Edit in the dashboard
connectors	object	All plans	Connectors page
tools	array	Pro	Tools page
builtin_tools	object	Pro	Tools page
skills	object	All plans	Skills page
plugins	array	Pro	Plugins page

Channels & interface

Section	Shape	Tier	Edit in the dashboard
widget	object	Pro	Widgets page
im_channels	object	All plans	IM channels page
feed_monitors	array	All plans	Feeds page
hooks	array	Business	Hooks page
handoff_settings	object	Pro	Human handoff page
a2a_card	object	Business	Details page

Commerce & policies

Section	Shape	Tier	Edit in the dashboard
pricing	object	All plans	Pricing page
policy_tos	object	All plans	Details page
policy_privacy	object	All plans	Details page
policy_refund	object	All plans	Details page
policy_acceptable_use	object	All plans	Details page

Operations

Section	Shape	Tier	Edit in the dashboard
monitoring	object	Business	Monitoring page
langfuse	object	Business	Monitoring page

Nested sub-schemas

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

• public_details.page_layout — the ten public-chat-page block types (hero, json_render, faq, …).
• data_internal.external_stores — external vector-store backends (Pinecone, Weaviate).