---
layout: default
section: Guidance
title: Governance of APIs
summary: How organizations actually direct, control, and guide the design, delivery, and consumption of APIs at scale.
nav: Guidance
sub: Governance of APIs
---

<div class="row gx-xl-9">
  <div class="col-12">
    <section>

      <h1 class="fs-3 mb-2">{{ page.title }}</h1>
      <p class="lead text-muted mb-5">{{ page.summary }}</p>

      <!-- What It Is -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">What It Is</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/engines/" class="text-decoration-none">Engines</a></h2>
              <p class="text-muted small mb-0">The runtime tooling that evaluates rules against API definitions.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/people/" class="text-decoration-none">People</a></h2>
              <p class="text-muted small mb-0">The humans whose behavior and collaboration API governance is really about.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/capital-g-governance/" class="text-decoration-none">Capital-G Governance</a></h2>
              <p class="text-muted small mb-0">Formal top-down governance programs with mandated rules and enforcement.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/lowercase-g-governance/" class="text-decoration-none">Lowercase-g Governance</a></h2>
              <p class="text-muted small mb-0">Lightweight practical guidance that teams actually follow.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/ontological/" class="text-decoration-none">Ontological</a></h2>
              <p class="text-muted small mb-0">Governance grounded in shared definitions of what things are.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/epistemological/" class="text-decoration-none">Epistemological</a></h2>
              <p class="text-muted small mb-0">Governance grounded in how we know and validate what is true about APIs.</p>
            </div>
          </div>
        </div>
      </div>

      <!-- Core Tensions -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">Core Tensions</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/velocity/" class="text-decoration-none">Velocity</a></h2>
              <p class="text-muted small mb-0">The speed at which teams can ship APIs without accumulating quality debt.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/quality/" class="text-decoration-none">Quality</a></h2>
              <p class="text-muted small mb-0">The measurable correctness, consistency, and completeness of API definitions.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/cost/" class="text-decoration-none">Cost</a></h2>
              <p class="text-muted small mb-0">The financial and operational cost of API sprawl, inconsistency, and rework.</p>
            </div>
          </div>
        </div>
      </div>

      <!-- Program & Culture -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">Program &amp; Culture</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/guardrails/" class="text-decoration-none">Guardrails</a></h2>
              <p class="text-muted small mb-0">Rules and checks that prevent harmful patterns without blocking progress.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/literacy/" class="text-decoration-none">Literacy</a></h2>
              <p class="text-muted small mb-0">The baseline HTTP and API design knowledge governance programs depend on.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/feedback-loops/" class="text-decoration-none">Feedback Loops</a></h2>
              <p class="text-muted small mb-0">Structured channels for teams to report problems and influence governance policy.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/awareness/" class="text-decoration-none">Awareness</a></h2>
              <p class="text-muted small mb-0">Making teams aware of policies, standards, and the state of their APIs.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/policies/" class="text-decoration-none">Policies</a></h2>
              <p class="text-muted small mb-0">The human and business rationale behind every governance rule.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/provenance/" class="text-decoration-none">Provenance</a></h2>
              <p class="text-muted small mb-0">The history and origin story behind why a rule or pattern exists.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/platforms/" class="text-decoration-none">Platforms</a></h2>
              <p class="text-muted small mb-0">The platform layer that carries the governance load so teams don't have to.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/self-service/" class="text-decoration-none">Self-Service</a></h2>
              <p class="text-muted small mb-0">Making governance tooling available on-demand without bottlenecks.</p>
            </div>
          </div>
        </div>
      </div>

      <!-- Tooling -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">Tooling</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/rules/" class="text-decoration-none">Rules</a></h2>
              <p class="text-muted small mb-0">Machine-executable checks applied to API definitions at any lifecycle stage.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/style-guide/" class="text-decoration-none">Style Guide</a></h2>
              <p class="text-muted small mb-0">Documented API design conventions that inform and generate governance rules.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/editors/" class="text-decoration-none">Editors</a></h2>
              <p class="text-muted small mb-0">Text and visual editors with inline governance feedback.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/ide/" class="text-decoration-none">IDE</a></h2>
              <p class="text-muted small mb-0">Inline governance feedback delivered where developers already work.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/cli/" class="text-decoration-none">CLI</a></h2>
              <p class="text-muted small mb-0">Command-line tooling for running governance checks in developer workflows.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/ci-cd/" class="text-decoration-none">CI/CD</a></h2>
              <p class="text-muted small mb-0">Continuous integration and delivery pipelines as governance enforcement points.</p>
            </div>
          </div>
        </div>
      </div>

      <!-- Protocols & Specifications -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">Protocols &amp; Specifications</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/openapi/" class="text-decoration-none">OpenAPI</a></h2>
              <p class="text-muted small mb-0">The primary surface on which API governance rules operate.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/asyncapi/" class="text-decoration-none">AsyncAPI</a></h2>
              <p class="text-muted small mb-0">The specification surface for governing event-driven API definitions.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/json-schema/" class="text-decoration-none">JSON Schema</a></h2>
              <p class="text-muted small mb-0">The vocabulary used to define and validate API data shapes across governance rules.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/rest/" class="text-decoration-none">REST</a></h2>
              <p class="text-muted small mb-0">Representational state transfer as the dominant HTTP API architectural style.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/async/" class="text-decoration-none">Async</a></h2>
              <p class="text-muted small mb-0">Governing asynchronous and event-driven API patterns alongside REST.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/graphql/" class="text-decoration-none">GraphQL</a></h2>
              <p class="text-muted small mb-0">Governing GraphQL schemas and operations alongside REST governance.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/grpc/" class="text-decoration-none">gRPC</a></h2>
              <p class="text-muted small mb-0">Google Remote Procedure Call as an alternative high-performance API protocol.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/changes/" class="text-decoration-none">Changes</a></h2>
              <p class="text-muted small mb-0">Managing and governing breaking and non-breaking API changes over time.</p>
            </div>
          </div>
        </div>
      </div>

      <!-- Operations & Scale -->
      <h5 class="fw-semibold text-muted mb-3 mt-2 pb-1 border-bottom">Operations &amp; Scale</h5>
      <div class="row mb-4">
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/lifecycle/" class="text-decoration-none">Lifecycle</a></h2>
              <p class="text-muted small mb-0">The end-to-end stages through which an API is designed, built, and retired.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/landscape/" class="text-decoration-none">Landscape</a></h2>
              <p class="text-muted small mb-0">The full map of APIs, teams, and operations that governance must cover.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/discovery/" class="text-decoration-none">Discovery</a></h2>
              <p class="text-muted small mb-0">You have to know where all your APIs are before you can govern them.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/observability/" class="text-decoration-none">Observability</a></h2>
              <p class="text-muted small mb-0">Logs, metrics, and traces that reveal API runtime behavior.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/production/" class="text-decoration-none">Production</a></h2>
              <p class="text-muted small mb-0">Governing APIs that are live and serving real traffic.</p>
            </div>
          </div>
        </div>
        <div class="col-md-6 col-lg-4 mb-3">
          <div class="card h-100 border-0 shadow-sm">
            <div class="card-body">
              <h2 class="fs-6 mb-1"><a href="https://guidance.apievangelist.com/store/consumption/" class="text-decoration-none">Consumption</a></h2>
              <p class="text-muted small mb-0">Governing how APIs are consumed and what patterns consumers should follow.</p>
            </div>
          </div>
        </div>
      </div>

    </section>
  </div>
</div>