Doc 0217
Harbor & Lane · July 2026 · Doc 0217
API migration — monthly update
Covering 16 June – 15 July 2026 · prepared by Meridian Studio
TL;DR
- Orders read path fully on v2 — 100% of read traffic, p95 down 410ms → 240ms, zero rollbacks.
- Decision: keep the v1 gateway through Q4 rather than the 1 September hard stop.
- Watch: partner sandbox parity — two webhook event shapes still differ; fix lands early August.
1What we shipped
| Item | Status |
|---|
|
Orders read path migrated to v2; 100% of read traffic since 7 July |
Shipped |
|
Idempotency keys on all v2 write endpoints; duplicate orders eliminated |
Shipped |
|
Webhook redelivery live behind a flag for 20% of partners |
Partial |
|
Legacy-ID backfill at 94% of rows; pre-2021 long tail remains |
In progress |
2Decisions & rationale
-
Cut over reads before writes, not endpoint-by-endpoint.
Reads are 88% of volume and trivially reversible; a month of production soak before any write carries real risk.
-
Extend the v1 gateway to 31 December.
Three partners can’t certify by September; ~$1.8k/mo carrying cost against ~$40k of manual-handling exposure.