Skip to content

Changelog

This file tracks meaningful changes to this guide and the published external contract.

Versioning and deprecation policy

Guide updates

Editorial changes, clarifications, new examples, and navigation changes land here with no API-version bump.

API contract changes

  • The public API is versioned through Accept: application/vnd.revento.v1+json.
  • Breaking response-shape or behavior changes land in a new version, not silently inside v1.
  • When a new version is announced, the previous version remains supported for at least 6 months.
  • Deprecation notice is published in this changelog and in Revento's integration-management notices.

Non-breaking changes inside a version

The following may change inside v1 without a version bump:

  • Clarified prose, examples, and setup guidance in this guide
  • Additional webhook event examples or endpoint examples that do not alter the underlying contract
  • New optional fields clearly documented as additive

What requires explicit notice

The following always get an explicit announcement:

  • New API version availability
  • Deprecation of an existing version
  • Scope-consent changes that require existing connections to re-consent
  • Webhook-delivery behavior changes that affect verification, retry, or payload interpretation

Unreleased

  • Removed the remaining separate-environment language. There is no second OAuth host, no second API host, and no separate sandbox organization model in the public contract.
  • Added the Connecting section covering publisher registration, organizer install, and participant authorization/revocation.
  • Added the machine-readable OpenAPI bundle and the public Schemas & tooling page.
  • Expanded the public contract around secret rotation, token lifetimes, cursor stability, webhook operations, and developer tooling endpoints.

Initial release

  • Initial release of the external integrations developer guide.