Blog
EngineeringApril 5, 2026 · 5 min read
Schema format v0.1: what goes in, what stays private
Every schema has a public card and a private package. This is where we draw the line and why the line matters.
by Everfetch Team
The public card
The public card should tell a developer whether a schema is relevant before they pull it. That means publishing:
- the site
- the intent category
- parameter names
- response field names
- health and verification signals
The private package
The private package can contain sensitive or operational details:
- URLs and endpoints
- headers
- selectors
- authentication flow
This split keeps the catalog factual while keeping execution details out of the public index.
Why the split is important
It improves trust, keeps the catalog safer to operate publicly, and avoids turning public index pages into an anonymous execution surface.