Bump.sh
banner
bumpsh.bsky.social
Bump.sh
@bumpsh.bsky.social
API doc platform for tech writers & engineers.
Bump.sh helps you build a branded single source of truth, documenting and cataloging all your APIs. Teams and customers now have a reference point for building and consuming APIs whether with OpenAPI, Swagger
To accompany the release of #OpenAPI 3.2, we’ve updated our complete OpenAPI guide. Whether you’re looking to get started with the popular standard or explore its latest features in detail, it’s a valuable resource to keep close at hand.

docs.bump.sh/guides/opena...
October 9, 2025 at 1:34 PM
Reposted by Bump.sh
Are you coming to the @bumpsh.bsky.social meetup in Paris this evening? I am!

Come learn how to stop building APIs like a 2003 frontend developer. We’re talking about image sprites. We’re talking about CSS combination. We’re talking modern HTTP. It’s gonna be fun!

bump.sh/blog/meetup-...
Paris Meetup - Scaling API workflows with OpenAPI: from docs to AI, SDKs, and beyond · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
October 8, 2025 at 8:47 AM
On Friday, the brand-new OpenAPI update was released, moving to 3.2.
It brings a whole range of new features that will make life much easier: sub-tags, JSON streaming, and more…

Among all these new features, was there one in particular you’d been waiting for?
bump.sh/blog/openapi...
OpenAPI 3.2 - What to expect? · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
September 22, 2025 at 9:37 AM
JSON Streaming is one of the main upcoming features in #OpenAPI 3.2, and as the name suggests, it allows you to send lots of small pieces of data to a browser (like pins on a map). Get ahead of this release: @philsturgeon.com has prepared a great guide on the topic!

bump.sh/blog/json-st...
JSON Streaming in OpenAPI v3.2.0 · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
August 28, 2025 at 10:55 AM
We’re very proud that #RedPanda chose Bump.sh for their API #documentation, to provide the most comfortable experience for their users
With the aim of fully integrating into their existing site, they’re making the most of our new embed mode.
Go check it out!

docs.redpanda.com/redpanda-clo...
August 27, 2025 at 8:04 AM
Revamping your #API docs is no small task. Here are a few key tips to help you dive in with confidence and prepare as best you can for what lies ahead.

bump.sh/blog/how-to-...
How to prepare for your API documentation revamp? · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
August 6, 2025 at 12:01 PM
Integrating your API #documentation naturally into your existing resources, that’s exactly what our newly released Embed mode offers. Sébastien, our CEO, shares a few thoughts on how it came to be, right here:

www.linkedin.com/posts/sebast...
We’ve always had one clear goal at Bump.sh: to help you deliver great API documentation, and to help your users explore and understand your APIs effortlessly. | Sébastien Charrier
We’ve always had one clear goal at Bump.sh: to help you deliver great API documentation, and to help your users explore and understand your APIs effortlessly. Today, we're making a big leap toward tha...
www.linkedin.com
July 23, 2025 at 9:15 AM
SpringDoc is a really cool tool that lets you generate #OpenAPI 3.1 specification files from any #Spring app, all you need to do is add annotations. To help you get started, @philsturgeon.com has put together this excellent guide:

bump.sh/blog/generat...
Generating OpenAPI docs for Java with Spring Boot · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
June 20, 2025 at 12:49 PM
To make it easier to get started with overlays in #OpenAPI and #AsyncAPI, the maintainers of OpenAPI Format have created a web interface for working through a visual UI. And @philsturgeon.com has even put together a practical guide to help you dive in!

docs.bump.sh/guides/opena...
June 17, 2025 at 3:57 PM
This year, we decided to do things differently to show our support for #Pride Month. 🏳️‍🌈

bump.sh/blog/pride-s...
Our approach to Pride Month · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
June 12, 2025 at 1:47 PM
To help you make the right choice and find the #API documentation tool that fits your needs, @philsturgeon.com has put together a Top 5 of the best on the market. You can check it out right here:

bump.sh/blog/top-5-a...
The 5 Best API Docs Tools in 2025 · Bump.sh
From API contract to documentation portal: streamline your workflow and deliver the best API experience. Built for engineers and tech writers.
bump.sh
June 11, 2025 at 2:58 PM
We wanted to dress in our finest for the summer: the new Bump.sh website is live!

It's designed to help you get the very best out of your API documentation and to support you with guides and tips written by experts.
June 3, 2025 at 2:49 PM
From New York to Los Angeles, Arnaud spent nearly 10 years tirelessly optimizing extreme supply chains. Gripped by the urge for new adventures, he returned to Europe to shift into Business Development before joining us.

Welcome, Arnaud Bourgin!
June 2, 2025 at 3:31 PM
Since the launch of its beta, our #API Explorer has continued to evolve based on user feedback. Discover the latest improvements in our newest product update:

docs.bump.sh/product-upda...
API Explorer - Better response experience
This site contains the Bump.sh documentation, product updates descriptions, examples of how to use Bump.sh, as well as guides to help you build better REST APIs (OpenAPI) and event-driven architecture...
docs.bump.sh
May 20, 2025 at 7:48 AM
Dreading #API design reviews?
What if we made them actually useful?
@philsturgeon.com shows you how to integrate API design reviews into your #Git workflows and pull requests, without the friction.

📘 Read the full article: bump.sh/blog/api-des...
API Design Reviews Don’t Have to be Hard · Bump.sh
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. Th...
bump.sh
May 15, 2025 at 11:22 AM
Publishing a new version of your #API doesn't necessarily mean abandoning the previous ones, and maintaining them can quickly become complex. To make things easier for you, here’s a guide by @philsturgeon.com to help you better manage multiple versions of your APIs.

bump.sh/blog/multipl...
Documenting Multiple API Versions · Bump.sh
Versioning an API can be incredibly difficult, but working out how to handle documentation for multiple APIs can be even more of a challenge. When you release a new version of an API you’re going to n...
bump.sh
May 14, 2025 at 11:09 AM
At @bumpsh.bsky.social, we often take the time to work on small but impactful enhancements between two larger project cycles, in moments called "Love cycles".

See the changelog in our last Product Update: docs.bump.sh/product-upda...
April 10, 2025 at 8:54 AM
Forgetting to update API docs is like committing code without a message—technically it works, but future-you won’t be happy.
Docs as Code helps you make sure your documentation evolves with your API.
James Higginbotham lists a couple of cool perks you get with it.
bump.sh/blog/docs-as...
March 25, 2025 at 2:22 PM
If your API guidelines feel more like "suggestions" than rules, OpenAPI can help. Automate standards, enforce consistency, and make governance a breeze. Less firefighting, more shipping.
James Higginbotham has some key tips for you about that: bump.sh/blog/leverag...
March 19, 2025 at 10:56 AM
Talking about #OpenAPI and integrations, here's one that nails it: @stainless.com x Bump.sh.
Centered on API definitions, like a perfect modern workflow.
All activated through a GitHub Action.
And all about improving API onboarding and adoption for your users.
bump.sh/blog/bump-st...
March 13, 2025 at 7:54 AM
@philsturgeon.com’s Modern #OpenAPI Workflow breakdown is the API guide you didn’t know you needed. After speaking with hundreds of teams, we can confirm this is how it’s done. Prepare to streamline your workflow and maybe even save a few headaches along the way.
docs.bump.sh/guides/opena...
March 11, 2025 at 3:46 PM
We've been busy 🚀

You can now easily inform your users about the state of your APIs by adding custom badges to your operations and properties.

Learn more about it in our last Product Update: docs.bump.sh/product-upda...
March 7, 2025 at 9:06 AM
📞 Your APIs called—they’re tired of being "discovered" only after a 12-tab deep dive.
Bump.sh Hubs gives your APIs the spotlight they deserve. No more hide-and-seek.
📝 Insights by James Higginbotham.
#APIDiscovery #DeveloperTools
bump.sh/blog/api-dis...
Unlocking API Discovery with Bump.sh Hubs in Your Platform Engineering Strategy · Bump.sh
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 differe...
bump.sh
February 28, 2025 at 9:12 AM
We've been busy at Bump.sh 🚀

I'm glad to announce that authentication is now supported in our API Explorer, to help your users easily connect to your APIs.

Learn more about it in our last Product Update!

You can request an access to the API Explorer Beta here: survey.typeform.com/to/RRACql9G
API Explorer - Authentication support
This site contains the Bump.sh documentation, product updates descriptions, examples of how to use Bump.sh, as well as guides to help you build better REST APIs (OpenAPI) and event-driven architecture...
docs.bump.sh
February 13, 2025 at 10:44 AM
API Linting is an excellent practice that fits into a Design-First approach: it helps save a lot of time when verifying your definition files. @philsturgeon.bsky.social has put together a guide on vacuum (@quobix.bsky.social): it’s one of the best linters on the market.

bump.sh/blog/api-lin...
API Linting with vacuum · Bump.sh
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.
bump.sh
January 30, 2025 at 3:47 PM