canva-upgrade-migration

# Canva Upgrade & Migration ## Overview Guide for handling Canva Connect API changes. Canva uses a single REST API version (`/rest/v1/`) but evolves endpoints over time. Monitor the [changelog](https://www.canva.dev/docs/connect/changelog/) for breaking changes. ## Known Migrations ### Brand Template ID Migration (September 2025) Canva migrated brand templates to a new ID format. Old IDs accepted for 6 months. ```typescript // Check if your stored template IDs need updating async function migrateBrandTemplateIds( db: Database, token: string ): Promise<{ migrated: number; failed: string[] }> { const stored = await db.getBrandTemplateIds(); let migrated = 0; const failed: string[] = []; // Fetch current templates from Canva const { items } = await canvaAPI('/brand-templates', token); const currentIds = new Set(items.map((t: any) => t.id)); for (const oldId of stored) { if (!currentIds.has(oldId)) { // Old ID — try to find matching template by title const match = items.find((t: any) => t.title === await db.getTemplateName(oldId)); if (match) { await db.updateTemplateId(oldId, match.id); migrated++; } else { failed.push(oldId); } } } return { migrated, failed }; } ``` ### Comment API Migration The Comment API endpoints were refactored — `Create Comment` and `Create Reply` are deprecated in favor of `Create Thread` and `Create Reply (v2)`. ```typescript // OLD (deprecated) // POST /v1/des...