Versioning

Versioning

How the API changes without breaking your integration.

The current API version is 2026-10-01. GET /v1/ping, GET /v1/me and every webhook event report it as api_version.

Within /v1 we only make additive changes:

  • new endpoints
  • new optional request fields
  • new fields on response objects
  • new event types
  • new values for enum fields, such as a new status

Build your integration to ignore fields it does not know and to handle unknown enum values gracefully, for example by treating an unfamiliar status as "other".

Anything that would break an existing integration ships as a new dated version, announced in the changelog with time to migrate.