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


  • 200 object

    Hub successfully retrieved

    • 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

    • apis array[object]

      The list of APIs belonging to this Hub

      • 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

        public documentation URL

      • version string

        Version of this API taken from the latest definition

      • properties array[object]

        Extra properties attached to this API

        • type string

          Type of the extra property

          Values are x-access-level or x-definition-type.

        • data string

          Content of the extra property

      • Creation date of this API

      • Last udpate date of this API

  • 404

    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 example (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",
  "apis": [
      "id": "3ef8f52f-9056-4113-840e-2f7183b90e06",
      "name": "Bump",
      "description": "This is the official Bump API documentation. Obviously created with Bump.",
      "slug": "bump",
      "url": "https://developers.bump.sh/",
      "version": "1.0",
      "properties": [
          "type": "x-access-level",
          "data": "string"
      "created": "2022-01-07",
      "modified": "2022-04-07"