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

Version

The version of the proposed API change in the road map.

Lifecycle

tag Versioning Define

APIs change, and how you version is how you keep faith with the people who depend on you. I decide my versioning and compatibility strategy at the beginning, not after I have already broken someone...

#Properties #3rd-Party
← Back to all Policies
Policy Details
Scope Business Contract
Property none
Type none
Stages Define
Slug road-map-version
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/road-map-version"
Full body (Pro) 
curl "https://api.apievangelist.com/v1/policies/road-map-version?include=content" \
  -H "x-api-key: $AE_KEY"
Related across the network 
curl "https://api.apievangelist.com/v1/policies/road-map-version/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