Pull Requests

Using pull requests to submit changes to business or technical artifacts.

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...

#Pull Requests #Commits

← Back to all Policies

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-pull-requests"

Full body (Pro)

curl "https://api.apievangelist.com/v1/policies/source-of-truth-pull-requests?include=content" \
  -H "x-api-key: $AE_KEY"

Related across the network

curl "https://api.apievangelist.com/v1/policies/source-of-truth-pull-requests/related"

All policies

curl "https://api.apievangelist.com/v1/policies?limit=25"

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

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Pull Requests

Strategies

API Provenance Is Maintained and Auditable

Lifecycle

description Definitions Define

Policy Details

Guidance

Explore more

Discover APIs

Work with this as data

MCP tools for policies

Call it yourself

Get an API key