Use OpenAPI Overlays Today
Overlays are a way to "patch" an OpenAPI document, by pointing to a specific part of it with a JSONPath, then using "actions" to update or remove parts of the document. Can this help you?
API Design Basics: Cacheability
Designing an API with cachability in mind produces a more sensible and better seperated set of resources, and it just so happens to be more performant, cheaper, and better for the environment.
Schrödinger's Protocol
AI tooling for APIs is moving so quickly, it can be difficult to tell who's winning. Also in this edition: State of API DevX survey, OpenAPI on BlueSky, Mobile GraphQL at Meta in 2025, and a dev's guide to API-first design
Enforcing API consistency with a large team
Keeping APls consistent in large organizations to speed up integrations, improve code-reuse, and avoid wasting time and money.
MCP ❤️ APIs
AI is dead, MCP takes over the world? Also, some non-hyperbolic API tech news, including: Building APIs with Next.js, New URLPattern APIs on Cloudflare, File Uploads, and breaking free from vendor lock-in
API Design Basics: File Uploads
How does a REST API handle uploading images or spreadsheets when it normally only handles JSON or XML?
Civic APIs
An exploration of APIs maintained for public record, with examples from The UK, Australia, and the EU. Plus, the latest from Jira REST API, Fast HTTP, Arazzo, and Designing APIs for Security
A Developer's Guide to API Design-First
Learn API Design-First to build clear, consistent, and efficient APIs. Master OpenAPI, AsyncAPI, and top tools to streamline design, docs, and automation.
A Golden Age for APIs
The tech world looks more and more to APIs to get things done with automation. In this issue: MCP for APIs, Arazzo, GraphOS, TanStack Router, the basics of API Rate Limiting, and more!
API Design Basics: Rate Limiting
Keep APIs running smoothly by controlling how many requests clients can make.
...Surely you mean to call it OpenAPI?
How long can an old name last? We're still trying to get people to say OpenAPI instead of Swagger. Also: Vacuum linting, OpenAPI for Rust Crates, a new Nock, and more!
HTTP Traffic vs OpenAPI
Mergers and Acquisitions are shaping the way we use industry-standard HTTP tools. Also in this newsletter: A fresh Bun, Rails APIs with Clickfunnels, new Express release, and a wild exploit of McDonalds' API in India.
API Design Basics: Designing for Security
Keep these principles in mind when planning and designing an API, to sidestep major security issues before anyone even starts coding.