Schema / Version Change Incident Playbook
Handle provider API or feed schema changes with version gates, quarantine, compatibility checks, shadow parsing and rollback.
A schema/version incident occurs when a provider contract change breaks parsing or normalization.
Trigger
Parser errors, unknown enums, missing fields, rejection spikes or provider deprecation notices.
Triage
Diff the last successful and first failing payload, check version markers, identify field/type/enum changes and determine whether bad data reached downstream storage.
Containment
Quarantine the new shape behind a version gate. Roll back to the old parser or degrade the affected provider when necessary.
Migration
Keep old/new DTOs explicit, version the mapper and run shadow parsing to compare normalized output.
Stop condition and metrics
Error rates return to baseline, sampled payloads normalize correctly and no corrupted data remains. Track schema rejects, unknown enums, parser versions, quarantine size and migration mismatch.
Prevention
Maintain contract fixtures, schema snapshots, deprecation calendars and provider-version inventories.
Are you facing this in production?
We can review the symptom, data flow and integration behavior technically.
Related content
Feed Ingestion Failure Troubleshooting
Diagnose travel feed failures systematically across transport, schema, parsing, validation, persistence and downstream publishing.
Explore →Supplier Timeout Incident Playbook
Handle travel-search supplier timeouts with containment, retry budgets, fallbacks, circuit breakers and controlled recovery.
Explore →Google Hotel Feeds vs Meta Catalog vs Criteo Catalog
Compare Google Hotel Feeds, Meta Travel Catalog and Criteo Catalog across identity, price freshness, event matching and advertising workflows.
Explore →Google Hotels Integration: Developer Guide
Implement Google Hotels from a developer perspective with Hotel Lists, property mapping, Pull/Changed Pricing/ARI, Transaction XML, landing pages, OAuth2, request/response models, error handling and monitoring.
Explore →Google Hotels: Platform, Booking Flow and Operations
Understand Google Hotels ownership, pricing delivery choices, offer equivalence and operational metrics, with practical failure scenarios.
Explore →Google Hotel Feeds: Data Contracts and Recovery
Separate Google Hotel List, pricing, ARI, POI and landing contracts; diagnose stale updates and design publication, recovery and monitoring workflows.
Explore →