Skip to content
The Docs Report
Tuesday, November 17, 2026NewsletterRSS

Bump.sh Lets Teams Group API Docs by Business Use Case

Bump.sh's Sept. 25 x-tagGroups extension adds a custom section level to API docs navigation, for OpenAPI and AsyncAPI documents of any version.

2 min read

Bump.shOpenAPIAPI reference

Product photo of a white filing box on a cobalt blue, teal and violet gradient

Bump.sh now lets teams add their own section level to API documentation navigation with an x-tagGroups vendor extension, according to its Sept. 25 product update. Operations can be grouped around business use cases such as “journeys,” “bookings” and “account” instead of only by endpoint tag.

How x-tagGroups works

The extension “lets you add a level to your navigation by defining your own sections,” Bump.sh said. A team declares each section in the API description and lists the tags that belong under it. Operations whose tags aren’t assigned to any section stay in their default place in the navigation, so a team can group part of an API without reorganizing all of it.

Which specs it covers

Bump.sh said x-tagGroups works on OpenAPI and AsyncAPI documents regardless of version. OpenAPI 3.2 offers a native route through the parent property of tags, which Bump.sh named as an alternative. The extension gives teams on older OpenAPI versions the same nested navigation without upgrading their spec.

An earlier MCP change

Bump.sh added persistent logging for its MCP servers in its Sept. 11 product update. The logs record each tool call, when and from where it was made, whether it succeeded and how long it took. Bump.sh said authentication details are excluded and the logs are stored anonymously.

The take

We think use-case sections fix a problem with tag-based navigation. Tags usually mirror how a backend team split its endpoints, and that’s not how a developer approaches an API. A reader who wants to book a trip shouldn’t need to know which service owns reservations. The grouping lives in the spec, so a team can try it with one edit. The trade-off is portability. x-tagGroups is a vendor extension, which means other tools may ignore it, and the OpenAPI 3.2 parent tag property is the standard way to do the same thing. We’d use the extension now and move to parent once a team adopts 3.2.