Blog
Practical writing on designing, mocking, testing, and shipping APIs — and making them ready for AI agents.
API Design Principles: A Practical Guide
The six design decisions that make or break an API: resource modeling, naming, idempotency, pagination, error formats, and versioning — with concrete examples.
Designing Agent-Ready APIs
AI agents are becoming API consumers. What that changes about API design — descriptions as prompts, error messages agents can act on, and why MCP is the new integration surface.
Design-First vs. Code-First API Development
Two workflows for building APIs, and why the order you write the contract in changes everything downstream: parallel work, review quality, and drift.
Versioning APIs Without Breaking Your Consumers
What actually counts as a breaking change, why additive evolution beats version bumps, and how to run a deprecation your consumers will forgive.
Be first to ship on it
Routebase is launching soon. Join the waitlist and we'll email you the moment it's ready.
One email at launch. No spam, unsubscribe anytime.