Partner API V1

Changelog

This page records public contract and documentation changes for approved Bolt channel-manager partners. It does not announce uncommitted roadmap work.

August 5, 2026 — V1 documentation baseline

Published the V1 Partner API contract at https://www.boltlabs.app/partner-api/v1.

  • Added manually provisioned partner credentials and 3,600-second bearer-token authentication.
  • Added partner-scoped connection discovery, cursor pagination, and the PENDING, ACTIVE, REJECTED, PAUSED, and DISCONNECTED lifecycle.
  • Added connection accept and reject operations, active-property room listing, and transactional room-mapping upserts.
  • Added individual-date and inclusive-range availability updates, withavailable: 0 representing closed inventory.
  • Added partial item failures, a 730-day horizon, and a 5,000 expanded room-date entry limit per request.
  • Added required availability idempotency with canonical-payload replay, conflict protection, and no automatic V1 record expiry.
  • Added versioned reservation.created, reservation.modified, and reservation.cancelled inventory events with pending recovery polling.
  • Added partner-level signed webhooks, delivery retries, dead-letter visibility, immutable inventory snapshots, and idempotent acknowledgement.
  • Documented default rate limits of 20 authentication requests per IP per minute and 120 availability requests per partner per minute. Bolt can configure these limits.
  • Added a stable request-level error envelope and partial-success error indexes that refer to the original updates array.

Documentation baseline, not a release promise

Partner access and test provisioning remain manual. Confirm onboarding, credentials, designated property data, and operational sync cadence with Bolt before sending live inventory.

V1 boundary

The following capabilities are not part of the V1 Partner API contract:

  • Pricing, rate plans, and minimum-stay rules.
  • Stop-sell, closed-to-arrival, and closed-to-departure as independent restrictions.
  • Partner-created reservations or guest-profile synchronization.
  • Guest, payment, content, image, or photo exchange.
  • OAuth or self-service sandbox access.

September 10, 2026 — V2 reservations and rate push

Added the V2 contract at https://www.boltlabs.app/partner-api/v2 while keeping all V1 endpoints available.

  • Added idempotent Booking.com-style JSON rate push at PUT /connections/:connectionId/rates with inclusive dates, occupancy rates, currency, and partial-success reporting.
  • Added booking revision feed, single-revision retrieval, latest-reservation retrieval, and idempotent acknowledgement.
  • Added signed webhook resources for booking_new, booking_modification, and booking_cancellation while preserving V1 event fields and signature headers.
  • Added the connection-scoped rate persistence table and expanded reservation snapshots with mapped rooms, guests, amounts, currency, and cancellation state.

Compatibility guidance

  • Ignore unknown response fields so additive fields do not break your integration.
  • Branch on documented error codes and HTTP statuses, not message text.
  • Treat cursors as opaque and status values as case-sensitive.
  • Keep the versioned base URL in configuration. A future incompatible contract would use a new version rather than silently changing V1.
Changelog | Bolt Partner API