attio-interaction

# Attio Interaction (Read + Write) Use this skill to read and write your Attio CRM through the REST API v2. Every read or write is a direct API call; agent-swarm does not maintain a separate Attio sync. ## TL;DR 1. Resolve `ATTIO_API_KEY` from swarm config before making calls. 2. Base URL: `https://api.attio.com/v2/` 3. Use `Authorization: Bearer $ATTIO_API_KEY`, `Content-Type: application/json`, and `Accept: application/json`. 4. Prefer upsert over create for People, Companies, and Deals: `PUT /v2/objects/{slug}/records` with `matching_attribute`. 5. Rate limits: 100 reads/sec, 25 writes/sec. Pace write bursts to roughly 15-20/sec. 6. Attribute values are arrays, even for scalar values: `[{ "value": 42 }]`, never `42`. ## Authentication ```bash ATTIO_API_KEY=$(get-config key="ATTIO_API_KEY" includeSecrets=true) curl -sS "https://api.attio.com/v2/objects" \ -H "Authorization: Bearer $ATTIO_API_KEY" \ -H "Accept: application/json" ``` If calls return `401`, re-fetch the key from config. If it still fails, notify the Lead; the key may need rotation. Do not retry silently. ## Core object slugs | Object | API slug | Primary matching attribute | |---|---|---| | Companies | `companies` | `domains` | | People | `people` | `email_addresses` | | Deals | `deals` | Usually no global dedupe key; link to company/person records | Custom objects use their configured API slug. Discover them with `GET /v2/objects`. ## Common operations ### 1. Discover objects and slugs ```bas...