Learn API management
Last updated: October 2026
API management is the combination of a runtime gateway and the lifecycle tooling around the API contract, and these guides explain the second half from the point of view of a team that already runs APIs: what the layers are, how they connect through the OpenAPI document, how to govern APIs with rules in CI, and how to keep an inventory that stays accurate.
Scalar builds the lifecycle and governance layers, a registry with breaking-change detection, linting, documentation and a developer portal, SDKs, and hosted MCP servers that proxy, rate limit, and measure AI agent traffic. It does not build a general-purpose gateway for human and application traffic. The guides say so wherever the boundary matters, and they point to the gateway vendors where a gateway is what you need.
Start here
- API management vs API gateway vs API lifecycle management: the layers, what a gateway does, what lifecycle tooling does, and an honest decision guide for whether you need each.
- API governance with OpenAPI: the style guide as a ruleset, linting in CI, breaking-change checks, a registry with access control, and a working GitHub Actions workflow.
- API catalog vs API registry: the inventory people browse versus the store tools read from, the RFC 9727 machine-readable catalog, and how to generate one from a registry.
Choosing tools
- Best API management platforms (2026): gateways and lifecycle platforms compared on licence, deployment, developer portal, MCP support, and published pricing, with sources.
- Best API documentation tools (2026): the developer portal layer on its own.
Related tracks
The OpenAPI guides cover the contract itself, including Spectral rules and security schemes. The SDK guides cover client libraries generated from the same document, and the MCP guides cover exposing it to AI agents. The Learn home page lists every topic.
Related
- Learn: What is OpenAPI? · Spectral rules · What is MCP?
- Docs: Scalar Registry · Enterprise
- Product: Scalar Registry — versioned OpenAPI and AsyncAPI documents, rules, and schemas, feeding docs, SDKs, and MCP servers alongside your gateway
