https://routebase.dev/blog/ Practical writing on API design, mocking, testing, and agent-ready APIs from the team building Routebase. en https://routebase.dev/icon.png https://routebase.dev/blog/ Tue, 01 Sep 2026 00:00:00 GMT https://routebase.dev/blog/what-belongs-in-an-api-style-guide/ https://routebase.dev/blog/what-belongs-in-an-api-style-guide/ Tue, 01 Sep 2026 00:00:00 GMT The Routebase Team Most style guides fail with too many rules, not too few. The work is not collecting rules — it is deciding which ones stop a build, which ones only leave a note, and which ones you were never going to enforce anyway. API Design Governance OpenAPI https://routebase.dev/blog/api-descriptions-llms-can-use/ https://routebase.dev/blog/api-descriptions-llms-can-use/ Tue, 25 Aug 2026 00:00:00 GMT The Routebase Team A linter can tell you a description is missing. It cannot tell you the description is useless — and that is the one an agent chokes on. What belongs in a description, what to leave out, and how to check whether it worked. AI Agents OpenAPI API Design https://routebase.dev/blog/migrating-from-postman-to-openapi-first/ https://routebase.dev/blog/migrating-from-postman-to-openapi-first/ Fri, 14 Aug 2026 00:00:00 GMT The Routebase Team The migration everyone postpones is almost entirely mechanical — and mechanical work is what agents are for. How an AI with an MCP connection imports your collections, rebuilds your assertions, and verifies its own work against your real API. OpenAPI Postman Migration https://routebase.dev/blog/why-openapi-specs-drift/ https://routebase.dev/blog/why-openapi-specs-drift/ Fri, 24 Jul 2026 00:00:00 GMT The Routebase Team Every API contract decays the moment it stops being enforced. The four ways specs drift from reality, why code generation doesn't save you, and how to turn your spec back into a source of truth. OpenAPI Contract Testing API Design https://routebase.dev/blog/consistent-error-handling-rfc-9457/ https://routebase.dev/blog/consistent-error-handling-rfc-9457/ Wed, 08 Jul 2026 00:00:00 GMT The Routebase Team Why every API needs exactly one error shape, how RFC 9457 Problem Details provides it, and the conventions — stable type URIs, validation extensions, safe detail fields — that make it stick. API Design Error Handling REST https://routebase.dev/blog/api-design-principles/ https://routebase.dev/blog/api-design-principles/ Tue, 07 Jul 2026 00:00:00 GMT The Routebase Team The six design decisions that make or break an API: resource modeling, naming, idempotency, pagination, error formats, and versioning — with concrete examples. API Design REST Guide https://routebase.dev/blog/designing-agent-ready-apis/ https://routebase.dev/blog/designing-agent-ready-apis/ Mon, 06 Jul 2026 00:00:00 GMT The Routebase Team 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. AI Agents MCP API Design https://routebase.dev/blog/design-first-vs-code-first/ https://routebase.dev/blog/design-first-vs-code-first/ Fri, 03 Jul 2026 00:00:00 GMT The Routebase Team Two workflows for building APIs, and why the order you write the contract in changes everything downstream: parallel work, review quality, and drift. API Design Workflow OpenAPI https://routebase.dev/blog/api-versioning-without-breaking-consumers/ https://routebase.dev/blog/api-versioning-without-breaking-consumers/ Wed, 01 Jul 2026 00:00:00 GMT The Routebase Team What actually counts as a breaking change, why additive evolution beats version bumps, and how to run a deprecation your consumers will forgive. API Design Versioning Breaking Changes