Bump.sh APIs changelog

16 days ago

Change #c6c0d861

1.0

3 structure changes including:

3 Modifications

Modified 3

GET /versions/{version_id}

Response
200 response Modified
- application/json content type Modified
  - doc_name property Added

POST /mcp-servers/{mcp_server_id_or_slug}/deploy

Response
201 response Modified
- application/json content type Modified
  - mcp_server_name property Added

POST /versions

Response
201 response Modified
- application/json content type Modified
  - doc_name property Added

20 days ago

Change #5b912314

1.0

Since introduce of Bump.sh APIs hub URL of the workspace API has been modified to https://developers.bump.sh/doc/workspace/.

Let's be consistent in every example of this documentation, for example for the webhook Structure Change

23 days ago

Change #e8e439b8

1.0

Breaking

1 structure change including:

1 Modification

Modified 1 Breaking

GET /fetch

Response
200 response Modified
- application/json content type Modified
  - data property Modified
    - examples property Added
Query
include_examples query parameter Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking

24 days ago

Change #b86715b8

1.0

Endpoint to deploy a new MCP server document:

Improve syntax consistency with other endpoints, favor kebab-case (hyphens).

And while here, add a link to our help center about MCP servers

2 structure changes including:

1 Addition

1 Removal

Removed 1

POST /mcp_servers/{mcp_server_id_or_slug}/deploy

Added 1

POST /mcp-servers/{mcp_server_id_or_slug}/deploy

May 27, 2026

Change #c275f380

1.0

Breaking

1 structure change including:

1 Modification

Modified 1 Breaking

GET /fetch

Query
urls query parameter Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
url query parameter Added

May 12, 2026

Change #4c1b2a45

1.0

Breaking

3 structure changes including:

3 Modifications

Modified 3 Breaking

GET /fetch

Header
X-Portal-Url header Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
Portal-Url header Added

GET /list

Header
X-Portal-Url header Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
Portal-Url header Added

GET /search

Header
X-Portal-Url header Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
Portal-Url header Added

May 12, 2026

Change #d3b9fba0

1.0

Breaking

2 structure changes including:

2 Modifications

Modified 2 Breaking

GET /fetch

Response
200 response Modified
- application/json content type Modified
  - data property Modified
    - body property Removed
      - Removing a resource is always breaking unless it was deprecated before
        Breaking
    - content property Added

GET /list

Query
url query parameter Modified
- Query parameter is no longer required

Apr 29, 2026

Change #df0222fd

1.0

Breaking

2 structure changes including:

2 Modifications

Modified 2 Breaking

GET /list

Query
url query parameter Modified
- Query parameter is now required
  Breaking

GET /search

Query
url, type query parameters Modified
- Type is now string

Apr 23, 2026

Change #56a6086f

1.0

Breaking

3 structure changes including:

3 Modifications

Modified 3 Breaking

GET /fetch

Response
200 response Modified
- application/json content type Modified
  - data property Modified
    - includes_examples property Removed
      - Removing a resource is always breaking unless it was deprecated before
        Breaking
    - url property Added

GET /list

Response
200 response Modified
- application/json content type Modified
  - data property Modified
    - description property Added

GET /search

Response
200 response Modified
- application/json content type Modified
  - metadata property Modified
    - page, per_page, next_page properties Removed
      - Removing a resource is always breaking unless it was deprecated before
        Breaking
Query
per_page, page query parameters Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
url query parameter Added

Apr 21, 2026

Change #3f4e44f9

1.0

3 structure changes including:

3 Additions

Added 3

GET /fetch

GET /list

GET /search

Apr 21, 2026

Change #b6bfc319

1.0

In endpoint Deploy a new MCP server document, allow deployment of Arazzo workflow definition file, via the new property references (aka Arazzo sourcesDescriptions)

More details about Arazzo and sourcesDescriptions in the Arazzo documentation.

1 structure change including:

1 Modification

Modified 1

POST /mcp_servers/{mcp_server_id_or_slug}/deploy

Body
application/json content type Modified
- references property Added

Apr 14, 2026

Change #2a2895f2

1.0

Feb 26, 2026

Change #59ae5f28

1.0

New endpoint: deploy a workflow document on your MCP server ✨

This feature is currently in closed beta. Request an early access at hello@bump.sh

1 structure change including:

1 Addition

Added 1

POST /mcp_servers/{mcp_server_id_or_slug}/deploy

Feb 3, 2026

Change #5d023d25

1.0

Favor HTTP token authentication to access this endpoint and list hubs for a given organization.

1 structure change including:

1 Modification

Modified 1

GET /hubs

Authentication
Basic token authentication method Removed

Nov 28, 2025

Change #dc4f8f6d

1.0

Bump OpenAPI document to version 3.2, with related improvements:

Authentication scheme Basic token is identified as deprecated.
Production server has a name

9 structure changes including:

9 Modifications

Modified 9

DELETE /docs/{doc_id_or_slug}/branches/{slug}

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

GET /docs/{doc_id_or_slug}/branches

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

GET /hubs

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

GET /hubs/{hub_id_or_slug}

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

GET /versions/{version_id}

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

PATCH /docs/{doc_id_or_slug}/branches/{slug}/set_default

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

POST /docs/{doc_id_or_slug}/branches

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

POST /validations

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

POST /versions

Authentication
Basic token authentication method Modified
- Basic token authentication method Modified
  - Authentication method is now deprecated

Mar 18, 2025

Change #2b59336f

1.0

This change adds a new API endpoint to list all hubs of an organization. This new endpoint requires authentication with an organization API token.

1 structure change including:

1 Addition

Added 1

GET /hubs

Dec 9, 2024

Change #6234cec9

1.0

In operation Promote branch as the default one, add a new response 200 when branch was already the default branch.

1 structure change including:

1 Modification

Modified 1

PATCH /docs/{doc_id_or_slug}/branches/{slug}/set_default

Response
200 response Added

Oct 29, 2024

Change #fc4f818c

1.0

1 structure change including:

1 Modification

Modified 1

GET /versions/{version_id}

Query
formats query parameter Added

Sep 13, 2024

Change #2d5e1857

1.0

1 structure change including:

1 Modification

Modified 1

PATCH /docs/{doc_id_or_slug}/branches/{slug}/set_default

Response
422 response Added

Sep 5, 2024

Change #57f51c1b

1.0

Clarify endpoints about branches:

Use Branch#slug only, remove mention to uuid.

Do not miss any Bump.sh APIs Hub changes, ever again

Changelog

API structure has changed

Documentation content has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API documentation has been created

API structure has changed

API structure has changed

API structure has changed

New endpoint to list all the hubs of an organization

API structure has changed

API structure has changed

API structure has changed

Documentation content has changed