List documentation changes Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developers.bump.sh/doc/portal/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Bump.sh Portal MCP server": {
    "url": "https://developers.bump.sh/doc/portal/mcp"
  }
}
Close
GET /changes/list

List visible documentation changes for a given resource.

Supported resource types are a Hub, an API documentation, a specific version.

Headers

  • Portal-Url string Required

    A url of public portal:

    • E.g. for a Documentation https://developers.bump.sh
    • E.g. for a Hub https://www.elastic.co/docs/api
    • E.g. for an Organization https://apidocs.lastminute.com/

Query parameters

  • url string

    Use a target page URL returned by either the GET /search or GET /list operations.

  • page integer

    Page number (1-based).

    Minimum value is 1. Default value is 1.

  • limit integer

    Maximum number of results per page.

    Minimum value is 1, maximum value is 20. Default value is 20.

Responses

  • 200 application/json

    Returns the list of visible documentation changes for the target resource, ordered from most recent to oldest.

    Hide response attributes Show response attributes object
    • data array[object]
      Hide data attributes Show data attributes object
      • id string(uuid) Required

        Unique identifier of the documentation change

      • title string Required

        Title of the change

      • url string Required

        Public URL of the change

      • description string

        Optional description of the change

      • content string Required

        Markdown representation of the diff

      • created_at string(date-time) Required

        Date when the change was created

    • metadata object
      Hide metadata attributes Show metadata attributes object
      • total integer Required

        Total number of available results.

      • page integer Required

        Current page number (1-based).

      • limit integer Required

        Maximum number of results per page.
  • 404

    The resource was not found

GET /changes/list 
curl \
 --request GET 'https://bump.sh/api/portal/v1/changes/list' \
 --header "Portal-Url: https://developers.bump.sh/doc/workspace/"
Response examples (200) 
{
  "data": [
    {
      "id": "f5b88339-01fa-4b6c-b45e-81d40b0ca94a",
      "title": "API structure has changed",
      "url": "https://developers.bump.sh/doc/workspace/changes/abc123",
      "description": "Added a new endpoint to manage versions",
      "content": "## Added\n- POST /versions\n\n## Modified\n- GET /versions",
      "created_at": "2026-06-23T13:14:50.138Z"
    }
  ],
  "metadata": {
    "total": 1,
    "page": 1,
    "limit": 20
  }
}