Hubs

Easily create APIs catalogs to help your developers discover and synchronize with your entire APIs ecosystem. Only available with the Business plan.

Deploying inside a hub

Hubs provide their own authentication token. You can deploy an existing hub documentation using either its own authentication token, or the hub one.

bump deploy your/doc.yml --doc my-doc --hub hub-slug-or-id --token my-doc-token
bump deploy your/doc.yml --doc my-doc --hub hub-slug-or-id --token hub-token

Default settings

You can define default settings at the hub level. These settings will be then used by the hub's documentations. You can define:

  • logo

  • color scheme

  • grouping strategy (group by tag or by path)

  • navigation mode (1 or 2 levels navigation)

The default settings can be overridden at the documentation level by selecting specific values in the documentation settings tab.

Group documentations by tag

You can display hub's documentations grouped by tag instead of a global list. Select "Group documentations by tag" in your hub's UI settings, and fill tags for each documentation.

You can add multiple tags to a documentation. It will be displayed under each associated tag on the hub.

Auto create the documentation

You can create a documentation on the fly by using the --auto-create option: when deploying, if the documentation doesn't already exist, a new one will be created with your hub defaults, and the given slug (--doc) and name (--doc-name).

bump deploy your/doc.yml --auto-create --doc my-doc --hub hub-slug-or-id --token hub-token

In this case, you have to provide the following parameters:

  • --auto-create : activate the auto-creation mode

  • --doc : the documentation slug (url) you want to use

  • --doc-name (optional) : the documentation name you want to use. Automatically generated from documentation's slug if missing.

  • --hub : the hub slug (or id)

  • --token : the hub token