webflow-upgrade-migration

# Webflow Upgrade & Migration ## Overview Guide for upgrading the `webflow-api` SDK and migrating from Webflow Data API v1 to v2. Covers breaking changes, endpoint mapping, import updates, and rollback. ## Prerequisites - Current `webflow-api` SDK installed - Git for version control (create upgrade branch) - Test suite available - Staging environment for validation ## Instructions ### Step 1: Assess Current Version ```bash # Check installed version npm list webflow-api # Check latest available npm view webflow-api version # View changelog npm view webflow-api --json | jq '.versions[-5:]' ``` ### Step 2: SDK Version History | SDK Version | API Version | Node.js | Key Changes | |-------------|-------------|---------|-------------| | 3.x | Data API v2 | 18+ | Current. `WebflowClient`, auto-retry, bulk ops | | 2.x | Data API v1/v2 | 16+ | Transitional. Mixed v1/v2 endpoints | | 1.x | Data API v1 | 14+ | Legacy. `Webflow` class, no types | **v1 endpoints deprecation: late 2026.** Migrate before then. ### Step 3: API v1 to v2 Migration Map #### Base URL Change ``` v1: https://api.webflow.com v2: https://api.webflow.com/v2 ``` #### Authentication Change ```typescript // v1 (old) — API key import Webflow from "webflow-api"; const webflow = new Webflow({ token: "your-api-key" }); // v2 (current) — Access token import { WebflowClient } from "webflow-api"; const webflow = new WebflowClient({ accessToken: "your-access-token" }); ``` #### Endpoint Migration Map | Opera...