Bump.sh website screenshot

Bump.sh

Bump.sh is "the modern API doc platform" — automatic, diff-aware documentation for OpenAPI and AsyncAPI specifications, plus a managed Model Context Protocol (MCP) platform that compiles Flower or Arazzo workflow documents into deterministic, observable MCP servers for AI agents. Customers include Aviobook, MongoDB, Elastic, Lightspeed, and BigID.

Bump.sh publishes 8 APIs on the APIs.io network, including Branches API, Diffs API, Hubs API, and 5 more. Tagged areas include API Changelog, API Documentation, API Hub, API Governance, and Arazzo.

The Bump.sh catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Bump.sh’s developer surface includes authentication, documentation, API reference, engineering blog, pricing, changelog, signup flow, and 16 more developer resources.

56.8/100 strong ▬ flat Agent 41/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
8 APIs
API ChangelogAPI DocumentationAPI HubAPI GovernanceArazzoAsyncAPICI/CDFlowerMCPOpenAPIWorkflows

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 56.8/100 · strong
Contract Quality 15.6 / 25
Developer Ergonomics 6.5 / 20
Commercial Clarity 12.6 / 20
Operational Transparency 8.9 / 13
Governance 5.7 / 12
Discoverability 7.4 / 10
Agent readiness — 41/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/bump-sh: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Bump.sh Branches API

Manage branches of a given documentation

Bump.sh Diffs API

The Diffs API from Bump.sh — 2 operation(s) for diffs.

Bump.sh Hubs API

The Hubs API from Bump.sh — 2 operation(s) for hubs.

Bump.sh MCP servers API

The MCP servers API from Bump.sh — 1 operation(s) for mcp servers.

Bump.sh Ping API

The Ping API from Bump.sh — 1 operation(s) for ping.

Bump.sh Previews API

The Previews API from Bump.sh — 2 operation(s) for previews.

Bump.sh Validations API

The Validations API from Bump.sh — 1 operation(s) for validations.

Bump.sh Versions API

The Versions API from Bump.sh — 2 operation(s) for versions.

Scroll for all 8

Postman Collections 8

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 8

Pricing Plans 1

Published pricing tiers and plan structures.

Bump Sh Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Bump Sh Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Bump Sh Context

23 classes · 8 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Bump.sh API Rules

12 rules · 1 errors 7 warnings 4 info

SPECTRAL

Bump.sh API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 8

Standalone JSON Schema definitions for this provider's data models.

Branch

4 properties

JSON SCHEMA

Diff

9 properties

JSON SCHEMA

DocStructureChangeEvent

4 properties

JSON SCHEMA

Hub

6 properties

JSON SCHEMA

McpDeployment

4 properties

JSON SCHEMA

Preview

3 properties

JSON SCHEMA

Validation

3 properties

JSON SCHEMA

Version

7 properties

JSON SCHEMA

Scroll for all 8

JSON Structure 4

JSON Structure definitions describing this provider's data shapes.

Bump Sh Diff Structure

6 properties

JSON STRUCTURE

Bump Sh Hub Structure

6 properties

JSON STRUCTURE

Bump Sh Mcp Deployment Structure

4 properties

JSON STRUCTURE

Bump Sh Version Structure

7 properties

JSON STRUCTURE

Examples 16

Example request and response payloads for these APIs.

Bump Sh Fetch Hub Example

5 fields

EXAMPLE

Bump Sh List Hubs Example

5 fields

EXAMPLE

Bump Sh Ping Example

5 fields

EXAMPLE

Bump Sh Validate Example

5 fields

EXAMPLE

Scroll for all 16

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Bump Sh Authentication

http · 2 schemes

SECURITY

Bump Sh Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Bump Sh Vulnerability Disclosure

disclosure policy published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Bump Sh Agentic Access

15 operations · 9 acting

15 operations · 9 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Build 7

SDKs, sample code, and the tooling you integrate with

Scroll for all 7

Access & Security 3

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: bump-sh
name: Bump.sh
description: Bump.sh is "the modern API doc platform" — automatic, diff-aware documentation for OpenAPI and AsyncAPI specifications,
  plus a managed Model Context Protocol (MCP) platform that compiles Flower or Arazzo workflow documents into deterministic,
  observable MCP servers for AI agents. Customers include Aviobook, MongoDB, Elastic, Lightspeed, and BigID.
type: Index
kind: company
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bump-sh.png
tags:
- API Changelog
- API Documentation
- API Hub
- API Governance
- Arazzo
- AsyncAPI
- CI/CD
- Flower
- MCP
- OpenAPI
- Workflows
url: https://raw.githubusercontent.com/api-evangelist/bump-sh/refs/heads/main/apis.yml
created: '2026-03-16'
modified: '2026-05-22'
specificationVersion: '0.19'
apis:
- aid: bump-sh:bump-sh-branches-api
  name: Bump.sh Branches API
  description: Manage branches of a given documentation
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Branches
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-branches-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-diffs-api
  name: Bump.sh Diffs API
  description: The Diffs API from Bump.sh — 2 operation(s) for diffs.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Diffs
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-diffs-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-hubs-api
  name: Bump.sh Hubs API
  description: The Hubs API from Bump.sh — 2 operation(s) for hubs.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Hubs
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-hubs-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-mcp-servers-api
  name: Bump.sh MCP servers API
  description: The MCP servers API from Bump.sh — 1 operation(s) for mcp servers.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - MCP servers
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-mcp-servers-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-ping-api
  name: Bump.sh Ping API
  description: The Ping API from Bump.sh — 1 operation(s) for ping.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Ping
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-ping-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-previews-api
  name: Bump.sh Previews API
  description: The Previews API from Bump.sh — 2 operation(s) for previews.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Previews
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-previews-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-validations-api
  name: Bump.sh Validations API
  description: The Validations API from Bump.sh — 1 operation(s) for validations.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Validations
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-validations-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
- aid: bump-sh:bump-sh-versions-api
  name: Bump.sh Versions API
  description: The Versions API from Bump.sh — 2 operation(s) for versions.
  humanURL: https://bump.sh
  baseURL: https://bump.sh/api/v1
  tags:
  - Versions
  properties:
  - type: OpenAPI
    url: openapi/bump-sh-versions-api-openapi.yml
  - type: Documentation
    url: https://docs.bump.sh
  - type: GettingStarted
    url: https://docs.bump.sh/help/getting-started/
  - type: APIReference
    url: https://developers.bump.sh
  - type: GitHubRepository
    url: https://github.com/bump-sh
  - type: SpectralRules
    url: https://github.com/api-evangelist/bump-sh/blob/main/rules/bump-sh-api-rules.yml
  - type: JSONSchema
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-schema
  - type: JSONStructure
    url: https://github.com/api-evangelist/bump-sh/tree/main/json-structure
  - type: JSONLD
    url: https://github.com/api-evangelist/bump-sh/blob/main/json-ld/bump-sh-context.jsonld
  - type: Examples
    url: https://github.com/api-evangelist/bump-sh/tree/main/examples
  - type: Vocabulary
    url: https://github.com/api-evangelist/bump-sh/blob/main/vocabulary/bump-sh-vocabulary.yml
  - type: Plans
    url: https://github.com/api-evangelist/bump-sh/blob/main/plans/bump-sh-plans-pricing.yml
  - type: RateLimits
    url: https://github.com/api-evangelist/bump-sh/blob/main/rate-limits/bump-sh-rate-limits.yml
  - type: FinOps
    url: https://github.com/api-evangelist/bump-sh/blob/main/finops/bump-sh-finops.yml
  - type: Webhooks
    url: https://docs.bump.sh
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/bumpsh/overview
- type: AgenticAccess
  url: agentic-access/bump-sh-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/bump-sh-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/bump-sh-domain-security.yml
- type: Authentication
  url: authentication/bump-sh-authentication.yml
- type: Website
  url: https://bump.sh
- type: Documentation
  url: https://docs.bump.sh
- type: APIReference
  url: https://developers.bump.sh
- type: OpenAPI
  url: https://developers.bump.sh/source.yaml
- type: GitHubOrganization
  url: https://github.com/bump-sh
- type: GitHubRepository
  description: Open-source Bump.sh CLI (TypeScript, MIT).
  url: https://github.com/bump-sh/cli
- type: GitHubRepository
  description: GitHub Action to deploy API docs from CI.
  url: https://github.com/bump-sh/github-action
- type: GitHubRepository
  description: Flower workflow specification (powers MCP servers).
  url: https://github.com/bump-sh/flower-spec
- type: GitHubRepository
  description: CI integration examples (GitHub Actions, Travis, CircleCI, GitLab CI).
  url: https://github.com/bump-sh/bump-ci-example
- type: GitHubRepository
  description: Curated public OpenAPI / AsyncAPI example specs.
  url: https://github.com/bump-sh/examples
- type: Blog
  url: https://bump.sh/blog
- type: Pricing
  url: https://bump.sh/pricing
- type: ChangeLog
  url: https://bump.sh/changelog
- type: Signup
  url: https://bump.sh/users/sign_up
- type: Login
  url: https://bump.sh/users/sign_in
- type: StatusPage
  url: https://bumpsh.statuspage.io/
- type: LinkedIn
  url: https://www.linkedin.com/company/bump-sh
- type: LlmsText
  url: https://developers.bump.sh/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com