# Bump Api

> This is version `1.0` of this API documentation. Last update on Apr 13, 2023.
> This is the official Bump.sh API documentation. Obviously created with Bump.sh.
> 
> The Bump.sh API is a REST API. It enables you to [create, update](#operation-post-versions) or [preview](#operation-post-previews) your API(s) documentation, [create stand-alone documentation diffs](#operation-post-diffs) or [validate a documentation definition](#operation-post-validations) (currently in OpenAPI or AsyncAPI).
> Our [webhook](#webhook-documentation-change) also lets you get notifications every time a change is introduced in your API.

[Documentation](https://bump.sh/demo/doc/bump.md)

OpenAPI file: https://bump.sh/demo/doc/bump.yaml

## MCP server

Connect AI agents to this documentation with the Bump.sh MCP server (Model Context Protocol, no authentication, Streamable HTTP transport):

- URL: `https://bump.sh/demo/doc/bump/mcp`

## [Servers](https://bump.sh/demo/doc/bump/servers.md)
- https://bump.sh/api/v1: https://bump.sh/api/v1


## Topics

### [Authentication](https://bump.sh/demo/doc/bump/authentication.md)


## Endpoints

### [Diffs](https://bump.sh/demo/doc/bump/group/endpoint-diffs.md)

- [Create a diff](https://bump.sh/demo/doc/bump/operation/operation-post-diffs.md)

- [Fetch detailed information from an existing diff](https://bump.sh/demo/doc/bump/operation/operation-get-diffs-parameter.md)


### [Versions](https://bump.sh/demo/doc/bump/group/endpoint-versions.md)

- [Create a new version](https://bump.sh/demo/doc/bump/operation/operation-post-versions.md)

- [Fetch a full documentation version including diff summary](https://bump.sh/demo/doc/bump/operation/operation-get-versions-parameter.md)


### [Validations](https://bump.sh/demo/doc/bump/group/endpoint-validations.md)

- [Validate a documentation definition](https://bump.sh/demo/doc/bump/operation/operation-post-validations.md)


### [Hubs](https://bump.sh/demo/doc/bump/group/endpoint-hubs.md)

- [Fetch information of an existing Hub](https://bump.sh/demo/doc/bump/operation/operation-get-hubs-parameter.md)


### [Previews](https://bump.sh/demo/doc/bump/group/endpoint-previews.md)

- [Create a preview](https://bump.sh/demo/doc/bump/operation/operation-post-previews.md)

- [Update an existing preview](https://bump.sh/demo/doc/bump/operation/operation-put-previews-parameter.md)


### [Ping](https://bump.sh/demo/doc/bump/group/endpoint-ping.md)

- [Check the API status](https://bump.sh/demo/doc/bump/operation/operation-get-ping.md)



## Webhooks

### [Documentation change](https://bump.sh/demo/doc/bump/group/webhook-documentation-change.md)

- [Structure change](https://bump.sh/demo/doc/bump/operation/operation-webhookdocstructurechange.md)




## Changelog

- [Changelog](https://bump.sh/demo/doc/bump/changes.md)
- [Changelog index (llms.txt)](https://bump.sh/demo/doc/bump/changes/llms.txt)

[Powered by Bump.sh](https://bump.sh)
