# Bump.sh documentation

> 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 architectures (AsyncAPI).

Bump.sh publishes API documentation from OpenAPI and AsyncAPI documents, and hosts MCP servers built from Flower or Arazzo workflow documents. Related resources: the Bump.sh API references at https://developers.bump.sh/ (MCP server at https://developers.bump.sh/mcp), the CLI at https://github.com/bump-sh/cli and the product at https://bump.sh/.

## Help center
- [Bump.sh Documentation](https://docs.bump.sh/help/)
- [API change management](https://docs.bump.sh/help/api-change-management/)
- [Webhooks](https://docs.bump.sh/help/api-change-management/webhooks/)
- [Changes management](https://docs.bump.sh/help/changes-management/)
- [Changelog](https://docs.bump.sh/help/changes-management/changelog/)
- [Integrations](https://docs.bump.sh/help/changes-management/integrations/)
- [Integrate Bump.sh with your workflow](https://docs.bump.sh/help/continuous-integration/)
- [API](https://docs.bump.sh/help/continuous-integration/api/)
- [Azure DevOps](https://docs.bump.sh/help/continuous-integration/azure-devops/)
- [Circle CI](https://docs.bump.sh/help/continuous-integration/circle-ci/)
- [Bump CLI](https://docs.bump.sh/help/continuous-integration/cli/)
- [GitHub Action](https://docs.bump.sh/help/continuous-integration/github-actions/)
- [Gitlab CI](https://docs.bump.sh/help/continuous-integration/gitlab-ci/)
- [Travis CI](https://docs.bump.sh/help/continuous-integration/travis-ci/)
- [Customization options](https://docs.bump.sh/help/customization-options/)
- [Branding customization](https://docs.bump.sh/help/customization-options/color-logo-meta-images/)
- [Custom domains](https://docs.bump.sh/help/customization-options/custom-domains/)
- [Embedding Bump.sh in your own portal](https://docs.bump.sh/help/customization-options/embed-mode/)
- [Head injection (analytics and tools integration)](https://docs.bump.sh/help/customization-options/head-injection-analytics-tools-integration/)
- [Headless doc portal (API)](https://docs.bump.sh/help/customization-options/headless-doc-portal-api/)
- [Login page](https://docs.bump.sh/help/customization-options/login/)
- [Operations and navigation](https://docs.bump.sh/help/customization-options/operations-navigation/)
- [Custom sections (x-tagGroups)](https://docs.bump.sh/help/customization-options/sections/)
- [Enhance your documentation content](https://docs.bump.sh/help/documentation-experience/)
- [API Explorer](https://docs.bump.sh/help/documentation-experience/api-explorer/)
- [Ask AI capabilities](https://docs.bump.sh/help/documentation-experience/ask-ai-capabilities/)
- [Markdown support](https://docs.bump.sh/help/documentation-experience/markdown-support/)
- [Topics](https://docs.bump.sh/help/documentation-experience/topics/)
- [Frequently asked questions](https://docs.bump.sh/help/faq/)
- [Quick start](https://docs.bump.sh/help/getting-started/)
- [Important concepts](https://docs.bump.sh/help/getting-started/concepts/)
- [Going further](https://docs.bump.sh/help/getting-started/going-further/)
- [Start your first MCP server](https://docs.bump.sh/help/getting-started/start-your-first-mcp-server/)
- [Upload your first API definition](https://docs.bump.sh/help/getting-started/upload-your-first-definition/)
- [Hubs](https://docs.bump.sh/help/hubs/)
- [Create and manage hubs](https://docs.bump.sh/help/hubs/create-and-manage-hubs/)
- [Hub UI customization](https://docs.bump.sh/help/hubs/customize-ui/)
- [General hub settings](https://docs.bump.sh/help/hubs/hub-settings/)
- [MCP servers](https://docs.bump.sh/help/mcp-servers/)
- [Access management](https://docs.bump.sh/help/mcp-servers/access-management/)
- [Agent chat widget and headless client](https://docs.bump.sh/help/mcp-servers/agent-chat-widget-headless-client/)
- [Create and manage MCP servers](https://docs.bump.sh/help/mcp-servers/create-and-manage-mcp-servers/)
- [Custom domains](https://docs.bump.sh/help/mcp-servers/customization-options/custom-domain/)
- [Debug sessions](https://docs.bump.sh/help/mcp-servers/debug-sessions/)
- [Deploy workflows](https://docs.bump.sh/help/mcp-servers/deploy-workflows/)
- [Logs](https://docs.bump.sh/help/mcp-servers/logs/)
- [Runtime expressions](https://docs.bump.sh/help/mcp-servers/runtime-expressions/)
- [Secrets and config](https://docs.bump.sh/help/mcp-servers/secrets-and-config/)
- [Security](https://docs.bump.sh/help/mcp-servers/security/)
- [Arazzo support](https://docs.bump.sh/help/mcp-servers/specification-support/arazzo-support/)
- [Flower support](https://docs.bump.sh/help/mcp-servers/specification-support/flower-support/)
- [Use an MCP server](https://docs.bump.sh/help/mcp-servers/use-mcp-server/)
- [Write your first Flower workflow](https://docs.bump.sh/help/mcp-servers/write-your-first-flower-workflow/)
- [Organizations](https://docs.bump.sh/help/organizations/)
- [Billing](https://docs.bump.sh/help/organizations/billing/)
- [Create and manage organizations](https://docs.bump.sh/help/organizations/create-and-manage-organizations/)
- [Organization access management](https://docs.bump.sh/help/organizations/organization-access-management/)
- [Publish documentation](https://docs.bump.sh/help/publish-documentation/)
- [Branching](https://docs.bump.sh/help/publish-documentation/branching/)
- [Create and manage documentation](https://docs.bump.sh/help/publish-documentation/create-and-manage-documentation/)
- [Deploy and release management](https://docs.bump.sh/help/publish-documentation/deploy-and-release-management/)
- [Documentation access management](https://docs.bump.sh/help/publish-documentation/documentation-access-management/)
- [Provide links to external resources](https://docs.bump.sh/help/publish-documentation/external-links/)
- [Get feedback from users](https://docs.bump.sh/help/publish-documentation/feedback/)
- [SEO & GEO](https://docs.bump.sh/help/publish-documentation/seo-geo/)
- [Specification Support](https://docs.bump.sh/help/specification-support/)
- [AsyncAPI Support](https://docs.bump.sh/help/specification-support/asyncapi-support/)
- [Badges](https://docs.bump.sh/help/specification-support/doc-badges/)
- [Custom code samples](https://docs.bump.sh/help/specification-support/doc-code-samples/)
- [Extensions](https://docs.bump.sh/help/specification-support/extensions/)
- [JSON Schema support](https://docs.bump.sh/help/specification-support/json-schema/)
- [Custom meta tags](https://docs.bump.sh/help/specification-support/meta-tags/)
- [Multiple Servers](https://docs.bump.sh/help/specification-support/multiple-servers/)
- [OpenAPI support](https://docs.bump.sh/help/specification-support/openapi-support/)
- [Webhooks](https://docs.bump.sh/help/specification-support/openapi-support/webhooks/)
- [Change tags display name](https://docs.bump.sh/help/specification-support/openapi-support/x-display-name/)
- [Overlays](https://docs.bump.sh/help/specification-support/overlays/)
- [Polymorphism](https://docs.bump.sh/help/specification-support/polymorphism/)
- [References](https://docs.bump.sh/help/specification-support/references/)
- [Role requirements](https://docs.bump.sh/help/specification-support/roles-requirements/)
- [Support and Service Level Agreement (SLA)](https://docs.bump.sh/help/support-and-sla/)

## Guides
- [Incorporating API Documentation Guidelines Into Your API Style Guide](https://docs.bump.sh/guides/technical-writing/incorporating-api-documentation-guidelines-into-your-api-style-guide/): A look at the importance of incorporating API documentation best practices into your API style guide.
- [Mocking APIs with Beeceptor](https://docs.bump.sh/guides/bump-sh-tutorials/mock-server-with-beeceptor/): Create dynamic, stateful API mocks using Beeceptor. Import OpenAPI specs, simulate real-world workflows, and test with context-aware responses.
- [Generating OpenAPI docs for Java with Spring Boot](https://docs.bump.sh/guides/openapi/code-first-spring/): Learn how to generate OpenAPI documentation for your Spring Boot application using Springdoc and Swagger Annotations.
- [Using OpenAPI to simplify building and testing Java and Spring APIs](https://docs.bump.sh/guides/openapi/design-first-spring/): Dive into the API Design-first workflow with Java and Spring, leveraging OpenAPI to power server-side request validations, and build a contracting test suite using that same API contract.
- [OpenAPI Format: A GUI for Overlays](https://docs.bump.sh/guides/openapi/openapi-format-overlays/): OpenAPI Format is a brilliant tool for helping teams get started with overlays, without forcing them to stare into an empty text-editor and try to learn Overlays and JSONPath all at once.
- [Documenting Multiple API Versions](https://docs.bump.sh/guides/bump-sh-tutorials/documenting-multiple-api-versions/): When you release a new version of an API you’re going to need to keep the old one around for a while, and keep the documentation up to date until it can be retired.
- [API Design Reviews Don’t Have to be Hard](https://docs.bump.sh/guides/api-basics/design-reviews/): Learn how to simplify API design reviews with practical tips, automation tools like Bump.sh so you can focus on building great software.
- [Integrate Stainless with Bump.sh API docs](https://docs.bump.sh/guides/bump-sh-tutorials/stainless-integration/): Accelerate adoption of your API with native SDK examples automatically integrated into your API documentation
- [Leveraging the OpenAPI Specification for API Governance](https://docs.bump.sh/guides/openapi/leveraging-the-openapi-specification-for-api-governance/): By leveraging OpenAPI, organizations can enhance their API governance efforts, streamline design reviews, automate compliance checks, and create a culture of continuous improvement.
- [Unlocking API Discovery with Bump.sh Hubs in Your Platform Engineering Strategy](https://docs.bump.sh/guides/bump-sh-tutorials/api-discovery-using-bump-sh-hubs/): By serving as a unified API catalog, Bump.sh Hubs help enterprises streamline API discovery, governance, and collaboration across teams.
- [Using Smithy to Define Your APIs](https://docs.bump.sh/guides/api-basics/using-smithy-to-define-your-apis/): Smithy is an OpenAPI alternative with an interface definition language that supports modeling, designing, and generating API documentation, client code, and server code.
- [Elevating API Documentation with Developer Workflows Using Docs as Code](https://docs.bump.sh/guides/api-basics/docs-as-code-elevating-api-documentation-with-developer-workflows/): Docs as Code has emerged as a powerful methodology that aligns documentation processes with software development workflows, treating documentation as a first-class citizen in the development lifecycle.
- [API Linting with vacuum](https://docs.bump.sh/guides/bump-sh-tutorials/api-linting-with-vacuum/): Validate API descriptions against rules and policies before releasing new versions in Bump.sh.
- [Generate SDKs with Speakeasy](https://docs.bump.sh/guides/bump-sh-tutorials/generate-sdks-with-speakeasy/): Help users integrate with your API quicker using client-code in their favourite language.
- [AsyncAPI 3.0 - The Cheat Sheet](https://docs.bump.sh/guides/asyncapi/cheatsheet/): Everything you need to keep in mind when writing an AsyncAPI contract, on a one-pager.
- [A Developer's Guide to API Design-First](https://docs.bump.sh/guides/api-basics/dev-guide-api-design-first/): Learn about the principles of API design-first and how it can benefit your organization.
- [Improve Your API with User Feedback](https://docs.bump.sh/guides/bump-sh-tutorials/feedback/): Make your API better by listening to the people who use it probably more than you do.
- [Accelerating your OpenAPI Spec Generation with TypeSpec](https://docs.bump.sh/guides/openapi/accelerating-youropenapi-spec-generation-with-typespec/): Let's explore TypeSpec, an alternative to the OpenAPI Specification for capturing the details of your API definition, with support for OpenAPI, gRPC, and JSON Schema output formats.
- [Writing an OpenAPI Document from the Ground Up](https://docs.bump.sh/guides/openapi/writing-an-openapi-document-from-the-ground-up/): A step-by-step guide for authoring OpenAPI documents, starting from the essentials and expanding upon the details of your API.
- [Contract Testing APIs with Microcks](https://docs.bump.sh/guides/bump-sh-tutorials/testing-with-microcks/): Make sure your APIs are doing what you expect them too with contract testing in Microcks.
- [How API Product Bundling Improves the Developer Experience](https://docs.bump.sh/guides/technical-writing/how-api-product-bundling-improves-the-developer-experience/): How to package API products to empower a specific role or audience while improving the developer experience.
- [Mocking APIs with Microcks](https://docs.bump.sh/guides/bump-sh-tutorials/mocking-with-microcks/): Create powerful API mocks to speed up client development using Microcks.
- [How Our API Docs Can Ease the Pain of API Deprecation](https://docs.bump.sh/guides/technical-writing/how-our-api-docs-can-ease-the-pain-of-api-deprecation/): API become deprecated for a variety of reasons. Discover good practices to plan and communicate about deprecations, and minimize disruptions
- [Migrate from SwaggerHub](https://docs.bump.sh/guides/bump-sh-tutorials/migrate-from-swaggerhub/): Move your OpenAPI out of SwaggerHub and into your own source control, so you can control more of the workflow with all the same benefits.
- [Git Workflows for API Technical Writers](https://docs.bump.sh/guides/technical-writing/git-workflows-for-api-technical-writers/): Explore the challenges and solutions of keeping your docs in sync with an evolving API design using git workflows.
- [Migrate from Redocly](https://docs.bump.sh/guides/bump-sh-tutorials/migrate-from-redocly/): Move your OpenAPI out of Redocly and into your own source control, so you can control more of the workflow with all the same benefits.
- [Try HTTP Requests with Insomnia](https://docs.bump.sh/guides/bump-sh-tutorials/try-requests-in-insomnia/): Integrate your OpenAPI-powered documentation with Insomnia to let customers try your API out, right from the API docs.
- [Make your APIs Discoverable with APIs.json](https://docs.bump.sh/guides/bump-sh-tutorials/make-your-apis-discoverable-with-apisjson/): You've built a brilliant API, and you've taken the time to document it, now leverage API specifications to help share this API on API marketplaces.
- [Using README-style API Documentation to Enhance Your API Design](https://docs.bump.sh/guides/technical-writing/using-readme-style-api-documentation-to-enhance-your-api-design/): Take a user-centric approach to API documentation by leveraging README-style documentation to bridge the gap between individual operations and practical usage scenarios.
- [The Role of Technical Writer in API Documentation](https://docs.bump.sh/guides/technical-writing/the-role-of-technical-writer-in-api-documentation/): Explore the new role of technical writers, the skills they need to participate in writing API documentation, and the challenges they may encounter as they collaborate with development teams.
- [Improving Schema Component Documentation in OpenAPI Documents](https://docs.bump.sh/guides/technical-writing/improving-schema-component-documentation-in-openapi-documents/): Tips and examples on how to effectively document schema components in OpenAPI specification documents.
- [Enriching Your OpenAPI Info Documentation for Understanding](https://docs.bump.sh/guides/technical-writing/enriching-your-openapi-info-documentation-for-understanding/): The importance of a well-crafted OpenAPI info section, including the name, description, and tag description fields.
- [5 Improvements to OpenAPI Operation Documentation](https://docs.bump.sh/guides/technical-writing/5-improvements-to-openapi-operation-documentation/): A look at five operation-specific improvements that you can make to deliver on a great developer experience while reducing the support costs of your API.
- [Try HTTP Requests with Postman](https://docs.bump.sh/guides/bump-sh-tutorials/try-requests-in-postman/): Integrate your OpenAPI-powered documentation with Postman to let customers try your API out, right from the API docs.
- [API Documentation Checklist](https://docs.bump.sh/guides/technical-writing/api-documentation-checklist/): A checklist to help you identify the documentation you will need for launching your API.
- [How to use JSONPath](https://docs.bump.sh/guides/openapi/jsonpath/): JSONPath is a query language that can be used to extract data from JSON documents, powering OpenAPI Overlays amongst other useful functionality in the world of APIs.
- [The Elements of Great API Documentation](https://docs.bump.sh/guides/technical-writing/elements-of-great-api-documentation/): Let’s explore the different types of API documentation and the role each has to play in helping a developer become proficient in consuming your API.
- [OpenAPI v4.0 (A.K.A "Project Moonwalk")](https://docs.bump.sh/guides/openapi/openapi-moonwalk/): What is coming next for OpenAPI, as v4.0 of the OpenAPI Specification gets closer to being released? What major changes are coming, how easy will it be to upgrade, and how do tooling companies feel about it?
- [Deploying docs from FastAPI](https://docs.bump.sh/guides/bump-sh-tutorials/fastapi/): Get started with Bump.sh for FastAPI projects. Learn how to publish and enrich OpenAPI documents, and build great documentation.
- [Deploying docs from API Platform](https://docs.bump.sh/guides/bump-sh-tutorials/api-platform/): Get started with Bump.sh for API Platform projects. Learn how to publish and enrich OpenAPI documents, and build great documentation.
- [Efficient Technical Writing Processes for API Documentation](https://docs.bump.sh/guides/technical-writing/efficient-tech-writing-process/): How can engineering and technical writing teams worth together on creating fantastic API documentation without stepping on each others toes?
- [Creating an API with Express.js using OpenAPI](https://docs.bump.sh/guides/openapi/express-api-openapi/): This tutorial walks you through the creation of a REST API in a Node.JS enviromnent, and its documentation using Bump.sh.
- [Using OpenAPI to simplify building and testing Ruby on Rails APIs](https://docs.bump.sh/guides/openapi/design-first-rails/): In a Design-first approach and RoR API, leverage OpenAPI to verify specific request responses or write a test suite for your complete API contracts.
- [Using OpenAPI to simplify building and testing Laravel APIs](https://docs.bump.sh/guides/openapi/design-first-laravel-php/): Dive into the API Design-first workflow with Laravel PHP, leveraging OpenAPI to power your server-side request validations, and build a contracting test suite based off that same API contract.
- [Deploying docs from Huma](https://docs.bump.sh/guides/bump-sh-tutorials/huma/): Generating OpenAPI for Go APIs
- [An AsyncAPI Example: Building Your First Event-driven API](https://docs.bump.sh/guides/asyncapi/asyncapi-first-event-driven-api/): Follow this walkthrough tutorial and build and Event-driven API along its documentation.
- [AsyncAPI vs. OpenAPI: Which Specification Is Right for Your App?](https://docs.bump.sh/guides/api-basics/asyncapi-vs-openapi/): Learn about the basic differences between AsyncAPI and OpenAPI that will help you pick one of them.
- [Creating Better API Architecture Diagrams](https://docs.bump.sh/guides/api-basics/api-architecture-diagrams/): Learn about the various types of API architecture diagrams and some tips for creating them.
- [Primitive Concepts of Git](https://docs.bump.sh/guides/technical-writing/primitive-concepts-git/): You will learn enough of Git to decide whether you want Git in your toolbox, or perhaps why others in a collaborative project insist on using Git.
- [Augmenting Generated OpenAPI Documents with Filters & Overlays](https://docs.bump.sh/guides/openapi/augmenting-generated-openapi/): Enhance and enrich your OpenAPI descriptions without creating conflicts in the source code using filters and overlays.
- [Generating OpenAPI docs for Ruby on Rails with RSwag](https://docs.bump.sh/guides/openapi/code-first-rails/): This guide describes, in a code-first approach and RoR codebase, how to generate OpenAPI description documents, enhancing it with contextual information and deploying it to Bump.sh.
- [Generating OpenAPI docs for Laravel with Swagger-PHP](https://docs.bump.sh/guides/openapi/code-first-laravel/): This guide describes, in a code-first approach and Laravel codebase, how to generate OpenAPI description documents, enhancing it with contextual information and deploying it to Bump.sh.
- [Code-first: How to Generate OpenAPI from Code](https://docs.bump.sh/guides/openapi/code-first/): Learn how to generate OpenAPI from an existing codebase.
- [API Contracts - an Extended Introduction](https://docs.bump.sh/guides/api-basics/api-contracts-extended-introduction/): This guide explains how API contracts can help your business, the best practices to follow, and gives some practical examples.
- [Building your API: Design Mode](https://docs.bump.sh/guides/openapi/building-your-api-design-mode/): Read a practical example of how to write your first OpenAPI contract, and publish it via Bump.sh.
- [How to use and document polymorphism in APIs](https://docs.bump.sh/guides/api-basics/how-to-use-document-polymorphism-API/): Learn how to use `oneOf`, `anyOf` and `allOf` when writing an OpenAPI or AsyncAPI definition.
- [What are the different API types?](https://docs.bump.sh/guides/api-basics/what-are-the-different-api-types/): This is an introduction to the various API technologies that exist today, and their main use cases.
- [What is AsyncAPI?](https://docs.bump.sh/guides/asyncapi/what-is-asyncapi/): AsyncAPI is the most popular specification for describing asynchronous APIs and Event-Driven Architectures.

## Specifications
- [Arazzo Specification Complete Guide](https://docs.bump.sh/arazzo/v1.0/)
- [Arazzo 1.0 - The Cheat Sheet](https://docs.bump.sh/arazzo/v1.0/cheatsheet/)
- [Benefits of using Arazzo](https://docs.bump.sh/arazzo/v1.0/introduction/benefits/)
- [History and evolution of Arazzo](https://docs.bump.sh/arazzo/v1.0/introduction/history/)
- [What is Arazzo?](https://docs.bump.sh/arazzo/v1.0/introduction/what-is-arazzo/)
- [Basic structure](https://docs.bump.sh/arazzo/v1.0/understanding-structure/basic-structure/)
- [Components & references](https://docs.bump.sh/arazzo/v1.0/understanding-structure/components-and-references/)
- [Defining sources](https://docs.bump.sh/arazzo/v1.0/understanding-structure/defining-sources/)
- [Steps, inputs, and outputs](https://docs.bump.sh/arazzo/v1.0/understanding-structure/steps-inputs-outputs/)
- [Success and failure in API workflows](https://docs.bump.sh/arazzo/v1.0/understanding-structure/success-and-failure/)
- [Workflows](https://docs.bump.sh/arazzo/v1.0/understanding-structure/workflows/)
- [Runtime expressions](https://docs.bump.sh/arazzo/v1.0/working-with-arazzo/runtime-expressions/)
- [OpenAPI 3.1 Specification Complete Guide](https://docs.bump.sh/openapi/v3.1/)
- [Callbacks and Webhooks](https://docs.bump.sh/openapi/v3.1/advanced/callbacks-webhooks/)
- [Handling Error Formats](https://docs.bump.sh/openapi/v3.1/advanced/error-formats/)
- [Uploading a File](https://docs.bump.sh/openapi/v3.1/advanced/file-uploads/)
- [Multipart Form Data](https://docs.bump.sh/openapi/v3.1/advanced/multipart-form-data/)
- [Multiple Content Types with OpenAPI](https://docs.bump.sh/openapi/v3.1/advanced/multiple-content-types/)
- [Security](https://docs.bump.sh/openapi/v3.1/advanced/security/)
- [Splitting OpenAPI Documents with $ref](https://docs.bump.sh/openapi/v3.1/advanced/splitting-documents-with-ref/)
- [OpenAPI 3.1 - The Cheat Sheet](https://docs.bump.sh/openapi/v3.1/cheatsheet/)
- [Examples & Defaults](https://docs.bump.sh/openapi/v3.1/data-models/examples/)
- [JSON Schema in OpenAPI](https://docs.bump.sh/openapi/v3.1/data-models/json-schema/)
- [Representing XML](https://docs.bump.sh/openapi/v3.1/data-models/representing-xml/)
- [Schemas and Data Types](https://docs.bump.sh/openapi/v3.1/data-models/schema-and-data-types/)
- [Schema Composition](https://docs.bump.sh/openapi/v3.1/data-models/schema-composition/)
- [Descriptions and Summaries](https://docs.bump.sh/openapi/v3.1/documentation/descriptions-and-summaries/)
- [External Documentation](https://docs.bump.sh/openapi/v3.1/documentation/external-documentation/)
- [Organize API Endpoints with OpenAPI Tags](https://docs.bump.sh/openapi/v3.1/documentation/grouping-operations-with-tags/)
- [Specification Extensions in OpenAPI](https://docs.bump.sh/openapi/v3.1/extending/extensions/)
- [Extending OpenAPI Documents with Overlays](https://docs.bump.sh/openapi/v3.1/extending/overlays/)
- [OpenAPI Benefits](https://docs.bump.sh/openapi/v3.1/introduction/benefits/)
- [A brief history of OpenAPI](https://docs.bump.sh/openapi/v3.1/introduction/history/)
- [What is OpenAPI?](https://docs.bump.sh/openapi/v3.1/introduction/what-is-openapi/)
- [The Perfect Modern OpenAPI Workflow](https://docs.bump.sh/openapi/v3.1/the-perfect-modern-openapi-workflow/)
- [Defining API Servers](https://docs.bump.sh/openapi/v3.1/understanding-structure/api-servers/)
- [Basic Structure](https://docs.bump.sh/openapi/v3.1/understanding-structure/basic-structure/)
- [OpenAPI Components](https://docs.bump.sh/openapi/v3.1/understanding-structure/components/)
- [HTTP Requests](https://docs.bump.sh/openapi/v3.1/understanding-structure/http-requests/)
- [HTTP Responses](https://docs.bump.sh/openapi/v3.1/understanding-structure/http-responses/)
- [Parameter Serialization](https://docs.bump.sh/openapi/v3.1/understanding-structure/parameter-serialization/)
- [Defining Parameters](https://docs.bump.sh/openapi/v3.1/understanding-structure/parameters/)
- [Paths and Operations](https://docs.bump.sh/openapi/v3.1/understanding-structure/paths-operations/)
- [OpenAPI 3.2 Specification Complete Guide](https://docs.bump.sh/openapi/v3.2/)
- [Callbacks and Webhooks](https://docs.bump.sh/openapi/v3.2/advanced/callbacks-webhooks/)
- [Handling Error Formats](https://docs.bump.sh/openapi/v3.2/advanced/error-formats/)
- [Uploading a File](https://docs.bump.sh/openapi/v3.2/advanced/file-uploads/)
- [JSON Streaming](https://docs.bump.sh/openapi/v3.2/advanced/json-streaming/)
- [Multipart Form Data](https://docs.bump.sh/openapi/v3.2/advanced/multipart-form-data/)
- [Multiple Content Types with OpenAPI](https://docs.bump.sh/openapi/v3.2/advanced/multiple-content-types/)
- [Pagination](https://docs.bump.sh/openapi/v3.2/advanced/pagination/)
- [Security](https://docs.bump.sh/openapi/v3.2/advanced/security/)
- [Splitting OpenAPI Documents with $ref](https://docs.bump.sh/openapi/v3.2/advanced/splitting-documents-with-ref/)
- [OpenAPI 3.1 - The Cheat Sheet](https://docs.bump.sh/openapi/v3.2/cheatsheet/)
- [Examples & Defaults](https://docs.bump.sh/openapi/v3.2/data-models/examples/)
- [JSON Schema in OpenAPI](https://docs.bump.sh/openapi/v3.2/data-models/json-schema/)
- [Representing XML](https://docs.bump.sh/openapi/v3.2/data-models/representing-xml/)
- [Schemas and Data Types](https://docs.bump.sh/openapi/v3.2/data-models/schema-and-data-types/)
- [Schema Composition](https://docs.bump.sh/openapi/v3.2/data-models/schema-composition/)
- [Descriptions and Summaries](https://docs.bump.sh/openapi/v3.2/documentation/descriptions-and-summaries/)
- [External Documentation](https://docs.bump.sh/openapi/v3.2/documentation/external-documentation/)
- [Organize API Endpoints with OpenAPI Tags](https://docs.bump.sh/openapi/v3.2/documentation/grouping-operations-with-tags/)
- [Specification Extensions in OpenAPI](https://docs.bump.sh/openapi/v3.2/extending/extensions/)
- [Extending OpenAPI Documents with Overlays](https://docs.bump.sh/openapi/v3.2/extending/overlays/)
- [OpenAPI Benefits](https://docs.bump.sh/openapi/v3.2/introduction/benefits/)
- [A brief history of OpenAPI](https://docs.bump.sh/openapi/v3.2/introduction/history/)
- [What is OpenAPI?](https://docs.bump.sh/openapi/v3.2/introduction/what-is-openapi/)
- [The Perfect Modern OpenAPI Workflow](https://docs.bump.sh/openapi/v3.2/the-perfect-modern-openapi-workflow/)
- [Defining API Servers](https://docs.bump.sh/openapi/v3.2/understanding-structure/api-servers/)
- [Basic Structure](https://docs.bump.sh/openapi/v3.2/understanding-structure/basic-structure/)
- [OpenAPI Components](https://docs.bump.sh/openapi/v3.2/understanding-structure/components/)
- [HTTP Requests](https://docs.bump.sh/openapi/v3.2/understanding-structure/http-requests/)
- [HTTP Responses](https://docs.bump.sh/openapi/v3.2/understanding-structure/http-responses/)
- [Parameter Serialization](https://docs.bump.sh/openapi/v3.2/understanding-structure/parameter-serialization/)
- [Defining Parameters](https://docs.bump.sh/openapi/v3.2/understanding-structure/parameters/)
- [Paths and Operations](https://docs.bump.sh/openapi/v3.2/understanding-structure/paths-operations/)

## Product updates
- [Shape your doc navigation around your use cases](https://docs.bump.sh/product-updates/2026/09/25/custom-sections-x-taggroups/) (2026-09-25)
- [MCP server logs](https://docs.bump.sh/product-updates/2026/09/11/mcp-servers-logs/) (2026-09-11)
- [API changelog now accessible from your docs MCP servers](https://docs.bump.sh/product-updates/2026/07/15/mcp-server-changelog/) (2026-07-15)
- [Custom OAuth server and custom domain for your MCP servers](https://docs.bump.sh/product-updates/2026/07/06/mcp-servers-custom-oauth-custom-domain/) (2026-07-06)
- [API docs up to 5 times faster](https://docs.bump.sh/product-updates/2026/06/23/doc-performance-enhancement/) (2026-06-23)
- [Introducing Bump.sh Portal API and MCP server](https://docs.bump.sh/product-updates/2026/06/10/portal-api-mcp-server/) (2026-06-10)
- [Run Arazzo workflows on your MCP servers](https://docs.bump.sh/product-updates/2026/04/17/mcp-server-arazzo-support/) (2026-04-17)
- [Roles requirements](https://docs.bump.sh/product-updates/2026/04/07/roles-requirements/) (2026-04-07)
- [Search in all APIs](https://docs.bump.sh/product-updates/2026/03/31/search-in-all-apis/) (2026-03-31)
- [Introducing Bump.sh MCP platform](https://docs.bump.sh/product-updates/2026/03/26/introducing-bump-mcp-platform/) (2026-03-26)
- [OpenAPI 3.2: partial support](https://docs.bump.sh/product-updates/2025/12/22/openapi-3-2-partial-support/) (2025-12-22)
- [Ask AI, Markdown rendering & llms.txt](https://docs.bump.sh/product-updates/2025/12/08/ask-ai-markdown-rendering/) (2025-12-08)
- [New search experience](https://docs.bump.sh/product-updates/2025/11/19/new-search-experience-10-times-faster/) (2025-11-19)
- [Dark mode customization](https://docs.bump.sh/product-updates/2025/10/16/dark-mode-customization/) (2025-10-16)
- [Documentation enhancements and fixes](https://docs.bump.sh/product-updates/2025/09/29/documentation-enhancements-and-fixes/) (2025-09-29)
- [Custom meta tags](https://docs.bump.sh/product-updates/2025/09/17/custom-meta-tags/) (2025-09-17)
- [API Explorer - OAuth2 implicit flow support](https://docs.bump.sh/product-updates/2025/09/08/api-explorer-oauth2-implicit-flow/) (2025-09-08)
- [API Explorer - Server variables](https://docs.bump.sh/product-updates/2025/08/14/api-explorer-server-variables/) (2025-08-14)
- [Introducing Embed mode](https://docs.bump.sh/product-updates/2025/07/25/embed-mode/) (2025-07-25)
- [Documentation fixes and improvements](https://docs.bump.sh/product-updates/2025/07/15/documentation-fixes-and-improvements/) (2025-07-15)
- [API Explorer - Better response experience](https://docs.bump.sh/product-updates/2025/05/20/api-explorer-better-response-experience/) (2025-05-20)
- [Love cycle - April 25](https://docs.bump.sh/product-updates/2025/04/10/love-cycle-april-25/) (2025-04-10)
- [Introducing state badges for operations and properties](https://docs.bump.sh/product-updates/2025/03/07/badges/) (2025-03-07)
- [API Explorer - Authentication support](https://docs.bump.sh/product-updates/2025/02/13/api-explorer-auth/) (2025-02-13)
- [Mermaid support](https://docs.bump.sh/product-updates/2025/01/29/mermaid-support/) (2025-01-29)
- [Introducing the API Explorer](https://docs.bump.sh/product-updates/2025/01/09/api-explorer/) (2025-01-09)
- [Get feedback from users](https://docs.bump.sh/product-updates/2024/08/10/feedbacks-gathering/) (2024-08-10)
- [Access management](https://docs.bump.sh/product-updates/2024/07/25/access-management/) (2024-07-25)
- [Love Cycle - July 24](https://docs.bump.sh/product-updates/2024/07/10/love-cycle/) (2024-07-10)
- [Changelog entry page](https://docs.bump.sh/product-updates/2024/06/10/changelog-entry-page/) (2024-06-10)
- [APIs.json support](https://docs.bump.sh/product-updates/2024/06/03/apis-json/) (2024-06-03)
- [Love Cycle - April 24](https://docs.bump.sh/product-updates/2024/04/05/love-cycle/) (2024-04-05)
- [New dashboard experience](https://docs.bump.sh/product-updates/2024/02/19/new-dashboard-experience/) (2024-02-19)
- [API keys](https://docs.bump.sh/product-updates/2024/01/06/api-keys/) (2024-01-06)
- [Help Center Remastered](https://docs.bump.sh/product-updates/2023/12/15/help-center-remastered/) (2023-12-15)
- [Beta property](https://docs.bump.sh/product-updates/2023/11/25/x-beta/) (2023-11-25)
- [Search Engine Performances Enhancement](https://docs.bump.sh/product-updates/2023/11/15/seach-engine-performances-enhancement/) (2023-11-15)
- [Changelog Diff](https://docs.bump.sh/product-updates/2023/11/02/changelog-diff/) (2023-11-02)
- [Editable Change Release](https://docs.bump.sh/product-updates/2023/10/05/editable-release/) (2023-10-05)
- [Introducing Manual Release Mode](https://docs.bump.sh/product-updates/2023/09/28/manual-release/) (2023-09-28)
- [Comparison between (any) API changes](https://docs.bump.sh/product-updates/2023/08/30/change-comparison/) (2023-08-30)
- [Improved Changelog](https://docs.bump.sh/product-updates/2023/08/09/changelog-layout/) (2023-08-09)
- [Custom code samples](https://docs.bump.sh/product-updates/2023/08/01/custom-code-samples/) (2023-08-01)
- [Managing Branches from your API](https://docs.bump.sh/product-updates/2023/06/16/api-branch-management/) (2023-06-16)
- [Bump.sh CLI v2.7.0](https://docs.bump.sh/product-updates/2023/06/14/bump-cli-2-7-0/) (2023-06-14)
- [Lightning-fast API documentation rendering](https://docs.bump.sh/product-updates/2023/06/03/lightning-fast-api-documentation-rendering/) (2023-06-03)
- [Enhanced Specifications Support](https://docs.bump.sh/product-updates/2023/01/27/enhanced-specifications-support/) (2023-01-27)
- [Improved Access Management](https://docs.bump.sh/product-updates/2022/12/07/improved-access-management/) (2022-12-07)
- [Polymorphism](https://docs.bump.sh/product-updates/2022/11/14/polymorphism/) (2022-11-14)
- [Automated Image Generation](https://docs.bump.sh/product-updates/2022/09/05/automated-image-generation/) (2022-09-05)
- [Branching](https://docs.bump.sh/product-updates/2022/07/08/branching/) (2022-07-08)
- [Search!](https://docs.bump.sh/product-updates/2022/06/13/search/) (2022-06-13)
- [Multiple types for properties](https://docs.bump.sh/product-updates/2022/06/04/multiple-types-for-properties-copie/) (2022-06-04)
- [COLORS](https://docs.bump.sh/product-updates/2022/05/07/colors/) (2022-05-07)
- [Webhooks](https://docs.bump.sh/product-updates/2022/04/02/webhooks/) (2022-04-02)
- [Documentation Access](https://docs.bump.sh/product-updates/2022/03/20/documentation-access/) (2022-03-20)
- [Organization support](https://docs.bump.sh/product-updates/2022/03/10/organization-support/) (2022-03-10)
- [Changelog update](https://docs.bump.sh/product-updates/2022/01/15/changelog-update/) (2022-01-15)
- [Bump diff navigation](https://docs.bump.sh/product-updates/2021/11/14/bump-diff-navigation/) (2021-11-14)
- [Multiple examples support](https://docs.bump.sh/product-updates/2021/11/08/multiple-examples-support/) (2021-11-08)
- [Bump live preview](https://docs.bump.sh/product-updates/2021/10/12/bump-live-preview/) (2021-10-12)
- [Automatic breaking change detection](https://docs.bump.sh/product-updates/2021/10/03/automatic-breaking-change-detection/) (2021-10-03)
- [Changelog makeover 💄](https://docs.bump.sh/product-updates/2021/09/21/changelog-makeover/) (2021-09-21)
- [RSS feed for your changelog](https://docs.bump.sh/product-updates/2021/09/20/rss-feed-for-your-changelog/) (2021-09-20)
- [Bindings support for AsyncAPI](https://docs.bump.sh/product-updates/2021/09/16/bindings-support-for-asyncapi/) (2021-09-16)
- [Share and highlight anything inside your API documentation](https://docs.bump.sh/product-updates/2021/09/11/share-and-highlight-anything-inside-your-api-documentation/) (2021-09-11)
- [Markdown support](https://docs.bump.sh/product-updates/2021/09/07/markdown-support/) (2021-09-07)
- [Receive API changelog in your mailbox 🔔](https://docs.bump.sh/product-updates/2021/07/18/receive-api-changelog-in-your-mailbox/) (2021-07-18)
- [Download source from your documentation](https://docs.bump.sh/product-updates/2021/07/13/download-source-from-your-documentation/) (2021-07-13)
- [Bump diff from your Command Line Interface or your Continuous Integration platform](https://docs.bump.sh/product-updates/2021/07/02/bump-diff-from-your-cli/) (2021-07-02)
- [Nested properties get a make up 🎀](https://docs.bump.sh/product-updates/2021/06/09/nested-properties-get-a-make-up/) (2021-06-09)
- [New Command Line Interface era](https://docs.bump.sh/product-updates/2021/05/29/new-command-line-interface-era/) (2021-05-29)
- [Ease your sight with dark mode ☾](https://docs.bump.sh/product-updates/2021/05/23/ease-your-sight-with-dark-mode/) (2021-05-23)
- [Documentations in your pocket](https://docs.bump.sh/product-updates/2021/05/20/documentation-in-your-pocket/) (2021-05-20)
- [Global support of external references](https://docs.bump.sh/product-updates/2021/03/16/global-support-of-external-references/) (2021-03-16)
- [Hello, OpenAPI webhooks](https://docs.bump.sh/product-updates/2021/02/04/hello-openapi-webhooks/) (2021-02-04)
- [Customize operation URL](https://docs.bump.sh/product-updates/2021/01/10/customize-operation-url/) (2021-01-10)
- [Custom domain for everyone](https://docs.bump.sh/product-updates/2020/12/01/custom-domain-for-everyone/) (2020-12-01)
- [Depreciation Support](https://docs.bump.sh/product-updates/2020/11/22/depreciation-support/) (2020-11-22)
- [Show verbs in navigation](https://docs.bump.sh/product-updates/2020/11/18/show-verbs-in-navigation/) (2020-11-18)
- [Add a favicon to your documentation](https://docs.bump.sh/product-updates/2020/11/12/add-a-favicon-to-your-documentation/) (2020-11-12)
- [Better change summaries](https://docs.bump.sh/product-updates/2020/07/02/better-change-summaries/) (2020-07-02)
- [Documentation examples for lazy people](https://docs.bump.sh/product-updates/2020/06/12/enhanced-examples/) (2020-06-12)
- [Your whole ecosystem on a single page](https://docs.bump.sh/product-updates/2020/04/24/introducing-hubs/) (2020-04-24)
- [Introducing our GitHub action](https://docs.bump.sh/product-updates/2020/02/20/introducing-our-github-action/) (2020-02-20)