Evidence-linked playbook

Breaking API change migration

Use this guide when an endpoint, request field, response shape, SDK method, or platform behavior changes upstream.

  1. 1

    Compare official contracts

  2. 2

    Update request and response handling

  3. 3

    Run integration tests

  4. 4

    Deploy behind a rollback boundary

Migration principles

Start from the provider's current contract, test representative workloads, and keep a rollback boundary until the new behavior is observed in production.

The evidence list below is refreshed from approved public events. It links each guide to the official source observations available today.

Current official evidence

Loading official evidence…

Apply this to your stack