With growing adoption and undeniable strengths, OpenAPI continues to evolve, and version 3.2 is set to be released in the coming weeks. What can we expect in terms of new features? Should we be preparing for compatibility issues?
07/22/2025
Over the past few years, I’ve spent a lot of time exploring how companies build and present their API documentation. And there’s one pattern that consistently stands out among the best dev portals: the API docs feel fully integrated into the rest of the company’s website.
07/18/2025
You may have known it already, but Bump.sh was born from a disaster that could have been avoided: an API evolving without any updates to its documentation. The unsuspecting developer, completely unaware, led inevitably to the dramatic fall of our story: an e-commerce site with a million users, freezing at checkout.
07/10/2025
Today we say farewell to a legend in the API documentation space: Apiary.io is shutting its doors.
07/04/2025
API Code-first is the art of building an API, and then popping some annotations or metadata in there to output API documentation in an API description format like OpenAPI.
06/19/2025
This year, for Pride Month, we’ve taken a slightly different approach.
06/11/2025
Without documentation nobody knows an API exists or how to use it, so it’s worth investing the time in creating clear, useful, understandable documentation. This will help customers integrate with their applications quicker, cut down on support calls, and allow coworkers to onboard quicker as they join the company or move teams.
06/10/2025
An API Design Review is one of a few parts of a larger API Governance program, where various people review changes to an API to make sure its a good choice for the architecture and wider ecosystem. This often involves a wide variety of persona, including API designers, API developers, technical writers, system architects, and maybe even a dedicated governance team.
05/15/2025
Versioning an API can be incredibly difficult, but working out how to handle documentation for multiple API versions can be even more of a challenge. When you release a new version of an API you’re going to need to keep the old one around for a while, and manage it as its own project until it can be retired. Thankfully Bump.sh makes it as simple and flexible as you could hope for.
05/13/2025
Docs as code is a powerful methodology that aligns documentation processes with software development workflows. It treats documentation as a first-class citizen in the development lifecycle by applying a similar approach to the standard development process. Let’s explore what it is, how it works, and how you can get started.
03/25/2025
API governance is critical for ensuring consistency, security, and quality in enterprise API programs. However, maintaining governance across a distributed organization can be challenging, especially as teams grow and APIs proliferate. In some cases, organizations opt to define guidelines rather than API governance in an attempt to reduce the work required day-to-day.
03/18/2025
It all started with a PR on OpenAI’s open-source repository.
03/13/2025
When I started as a Product Manager, I felt like a great integration between SaaS products would involve some UI elements. Something like buttons with the other tool’s logo on it. Then I realized the importance of “APIs” behind the scene, whether there would be a button or not.
03/11/2025
APIs are at the core of modern enterprise architectures, powering integrations, automation, and digital products. Yet, API sprawl remains a persistent challenge—APIs are often scattered across different teams, tools, and repositories, making discovery and governance difficult.
02/27/2025
Whether just starting to build an API and looking for feedback, or improving auditing an old API to see if it’s secure, consistent, and up to scratch, the approach is likely the same: API linting.
01/30/2025
API Design-First, also known as “schema-first” or “contract-first”, is all about designing the interface of an API before writing any code. It’s about planning the API contract first, and defining what the API does and how it works so everyone’s on the same page before implementation starts. This approach has been around for a while, and over time, it’s evolved to meet the needs of different technologies. These days, OpenAPI has become the defacto standard for designing REST APIs, and AsyncAPI has become the defacto standard for describing event-driven APIs. This workflow can make life easier for everyone the whole way through the lifecycle of an API.
01/27/2025
It’s been a while since we chatted with the Speakeasy folks. What’s more natural? Bump.sh and Speakeasy are the first two vendors ever to officially support OpenAPI Overlays.
01/23/2025
Older posts
CORS-ing the Boundaries: How We Built a Secure Open-Source Proxy Solution for Our API Explorer
Tech
01/10/2025
How BigID enhanced processes and boosted satisfaction by upgrading their API documentation portal
Customers
11/05/2024
