Fetch information of an existing Hub

GET /hubs/{hub_id_or_slug}

Fetch information of an existing Hub including the list of APIs it contains. The response follows the APIs.json specification.

Path parameters

  • hub_id_or_slug string Required

    UUID or slug of a Hub which can be CI deployment settings page of your hub

Responses

  • 200 application/json

    Hub successfully retrieved

    Hide response attributes Show response attributes object
    • name string

      The name of the Hub

    • The description of the Hub

    • url string

      The public URL of the hub

    • Creation date of this Hub

    • Last udpate date of this Hub

    • version of the APIs.json specification specification in use.

    • apis array[object]

      The list of APIs belonging to this Hub

      Hide apis attributes Show apis attributes object
      • id string

        UUID of this API

      • name string

        Name of this API

      • Description of this API from the latest definition

      • slug string

        Slug of this API

      • url string Deprecated
      • humanUrl string

        public documentation URL

      • tags array[string]

        a list of descriptive strings which identify the API within a Hub

      • version string

        Version of this API taken from the latest definition

      • properties array[object]

        Extra properties attached to this API

        Hide properties attributes Show properties attributes object
        • type string

          Type of the extra property

          Values are OpenAPI, AsyncAPI, x-access-level, or x-definition-type.

        • data string

          Content of the extra property (data or url)

        • url string

          Content of the extra property (data or url)

      • Creation date of this API

      • Last udpate date of this API

  • 400 application/json

    Bad request

    Hide response attribute Show response attribute object
    • message string

      Human readable error message for status 400.

  • Hub not found

GET /hubs/{hub_id_or_slug}
curl \
 -X GET https://bump.sh/api/v1/hubs/{hub_id_or_slug} \
 -H "Authorization: Token $ACCESS_TOKEN"
Response examples (200)
{
  "name": "My train company hub",
  "description": "# Welcome to my train company\n\nThis hub contains all APIs belonging to [my train company](https://demo.bump.sh/).\nFeel free to visit the documentation or changes of our APIs lifecycle.\n",
  "url": "https://demo.bump.sh/",
  "created": "2022-01-07",
  "modified": "2022-04-07",
  "specificationVersion": "0.16",
  "apis": [
    {
      "id": "3ef8f52f-9056-4113-840e-2f7183b90e06",
      "name": "Bump.sh",
      "description": "This is the official Bump.sh API documentation. Obviously created with Bump.sh",
      "slug": "bump",
      "url": "string",
      "humanUrl": "https://developers.bump.sh/",
      "tags": [
        "string"
      ],
      "version": "1.0",
      "properties": [
        {
          "url": "https://developers.bump.sh/source.json",
          "type": "OpenAPI"
        }
      ],
      "created": "2022-01-07",
      "modified": "2022-04-07"
    }
  ]
}
Response examples (400)
{
  "message": "You need to upgrade to a paid plan to perform this request. Please go to https://bump.sh/account/billing"
}