Skip to content

Developer platform

Migration guides

The current public contract is v1. Additive fields and operations do not require client migration. Breaking changes ship under a new version with a published overlap window.

Notice

Breaking changes receive at least 90 days of public notice unless an active security issue requires faster retirement.

Overlap

Old and new contract versions run together during the migration window. Webhook schemas remain versioned and replayable.

Verification

OpenAPI/live-route parity, TypeScript compilation, Python sync/async parity, and production canaries gate every contract release.

v1.0 migration status

No client migration is required. Additive action fields now bind each approval to an exact connector and expose signed-webhook and allowlisted bearer-API destinations alongside GitHub and CMS. Existing unbound, unused approvals are revoked and returned for explicit reapproval.