How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us

README

Require that each API contract repository has a dedicated README.

Strategies

API Provenance Is Maintained and Auditable

All API contracts must maintain a clear record of their provenance including reviews, certifications, pull requests, and change history, ensuring that the evolution of each API is traceable, audita...

Lifecycle

description Definitions Define

The definition is the contract. OpenAPI, AsyncAPI, JSON Schema, and APIs.json are the machine-readable artifacts I use to describe what an API is before, during, and after it exists. Investing in s...

menu_book Documentation Beta

Documentation is the API for humans. I generate reference docs from the definition and surround them with the guides, examples, and getting-started material that turn a spec into understanding. Doc...

#README
← Back to all Policies
Policy Details
Scope Business Contract
Property none
Type GitHubReadme
Stages Definition
Slug source-of-truth-readme
Guidance
View Guidance
Explore more

Navigate related API building blocks.

All Policies Lifecycle Rules Guidance Experiences Strategies
Discover APIs
apis.io — API Search

Search across thousands of APIs on apis.io →

Work with this as data

Every policy here is available over the API and to AI agents over MCP.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for policies
6 tools reach this content
  • find_building_blocksBrowse every policies entry — call it with type="policies".
  • get_building_blockOne policies entry in full; add include=content for the body (Pro).
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
This policy 
curl "https://api.apievangelist.com/v1/policies/source-of-truth-readme"
Full body (Pro) 
curl "https://api.apievangelist.com/v1/policies/source-of-truth-readme?include=content" \
  -H "x-api-key: $AE_KEY"
Related across the network 
curl "https://api.apievangelist.com/v1/policies/source-of-truth-readme/related"
All policies 
curl "https://api.apievangelist.com/v1/policies?limit=25"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account