# Configuration Schema

- Canonical URL: https://docs.fairvisor.com/docs/api/schema/
- Section: docs
- Last updated: n/a
> Schema expectations for Fairvisor policy bundles.


Fairvisor validates policy bundles as JSON objects at load time.

There is no public hosted JSON Schema URL in the current OSS runtime. The canonical validation logic is in the runtime loader and limiter validators.

## Runtime sources of truth

- `src/fairvisor/bundle_loader.lua`
- `src/fairvisor/token_bucket.lua`
- `src/fairvisor/cost_budget.lua`
- `src/fairvisor/llm_limiter.lua`

## Canonical references on this site

- [Bundle Structure](/docs/policy/bundle/)
- [Rules & Descriptors](/docs/policy/rules/)
- [Selectors](/docs/policy/selectors/)

## Validation behavior

Bundle loading fails when required fields are missing or invalid, for example:

- invalid/absent `bundle_version`
- invalid `policies` structure
- invalid limiter configuration for `token_bucket`, `cost_based`, or `token_bucket_llm`
- invalid `kill_switches`