apollo-upgrade-migration

name	apollo-upgrade-migration
description	Manage Apollo.io API upgrades and endpoint migrations. Use when upgrading Apollo API versions, migrating to new endpoints, or updating deprecated API usage. Trigger with phrases like "apollo upgrade", "apollo migration", "update apollo api", "apollo breaking changes", "apollo deprecation".
allowed-tools	Read, Grep, Bash(curl:*)
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
compatible-with	claude-code, codex, openclaw
tags	["saas","apollo","api","migration"]

Apollo Upgrade Migration

Current State

!npm list axios 2>/dev/null | head -5

Overview

Plan and execute safe upgrades for Apollo.io API integrations. Apollo has made several breaking changes historically (query param auth to header auth, endpoint URL changes, new search endpoints). This covers auditing current usage, building compatibility layers, and migrating safely.

Prerequisites

• Valid Apollo API key
• Node.js 18+

Instructions

Step 1: Audit Current API Usage

// src/scripts/api-audit.ts
import { execSync } from 'child_process';

interface EndpointUsage { endpoint: string; files: string[]; status: 'current' | 'deprecated'; }

const ENDPOINT_MAP = [
  // Current endpoints
  { pattern: '/mixed_people/api_search', status: 'current' as const },
  { pattern: '/mixed_companies/search', status: 'current' as const },
  { pattern: '/people/match', status: 'current' as const },
  { pattern: '/people/bulk_match', status: 'current' as const },
  { pattern: , :    },
  { : , :    },
  { : , :    },
  { : , :    },
  { : , :    },
  
  { : , :    },  
  { : , :    },
  { : , :    },  
  { : , :    },  
];

 (): [] {
   : [] = [];
   ( ep  ) {
     {
       files = (
        ,
        { :  },
      ).().().();
       (files. > ) results.({ : ep., files, : ep. });
    }  {  }
  }

  .();
   ( r  results) {
     icon = r. ===  ?  : ;
    .();
    r..( .());
  }
   deprecated = results.( r. === );
   (deprecated. > ) {
    .();
  }
   results;
}