attio-upgrade-migration

# Attio Upgrade & Migration ## Overview Attio has two API generations: v1 (legacy, deprecated) and v2 (current). This skill covers the v1-to-v2 migration, community SDK upgrade paths, and how to detect and adapt to API changes since Attio does not publish a traditional SDK changelog. ## V1 to V2 Migration Reference ### Endpoint Changes | Operation | V1 Endpoint | V2 Endpoint | |-----------|------------|------------| | List objects | `GET /v1/objects` | `GET /v2/objects` | | Query records | `GET /v1/objects/{id}/records` | `POST /v2/objects/{slug}/records/query` | | Create record | `POST /v1/objects/{id}/records` | `POST /v2/objects/{slug}/records` | | Get record | `GET /v1/objects/{id}/records/{rid}` | `GET /v2/objects/{slug}/records/{rid}` | | List entries | `GET /v1/lists/{id}/entries` | `POST /v2/lists/{slug}/entries/query` | | Create webhook | `POST /v1/webhooks` | `POST /v2/webhooks` | | Search | N/A | `POST /v2/records/search` | ### Key Differences | Aspect | V1 | V2 | |--------|----|----| | Identifiers | UUIDs only | Slugs (preferred) or UUIDs | | Record query | GET with query params | POST with JSON body (filters, sorts) | | Filtering | Basic query params | Rich operators (`$eq`, `$contains`, `$gt`, `$and`, `$or`) | | Pagination | `page` + `per_page` | `limit` + `offset` or cursor-based | | Webhook payloads | Custom format | Consistent with v2 response shapes | | Webhook filtering | None | Event-type and attribute-level filters | ### Step 1: Update Base URL `...