Skip to main content
Augmentation is the automated process of enriching leads with AI-generated insights, scores, and analysis.

​
Augmentation Pipeline

The augmentation process runs through these steps: 
QUEUED → CHECKING_DATA → CLASSIFYING_ARCHITECTS → AUTO_TAGGING
       → GENERATING_SIGNALS → MATCHING_PEOPLE → ANALYZING_GONOGO
       → CALCULATING_SCORE → FINISHED
Each step can be individually enabled or disabled.

​
Augmentation Steps

StepDescription
CHECKING_DATAValidate and normalize lead data
CLASSIFYING_ARCHITECTSCategorize project type
AUTO_TAGGINGApply relevant tags automatically
GENERATING_SIGNALSCreate AI insights
MATCHING_PEOPLEFind relevant contacts
ANALYZING_GONOGORun Go/No-Go analysis
CALCULATING_SCOREGenerate strategic score

​
Triggering Augmentation

Start enrichment for a lead: 
curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/augmentation" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "steps": ["signals", "scoring", "gonogo", "people"]
  }'

​
Available Steps

Step KeyDescription
signalsGenerate AI signals
scoringCalculate strategic score
gonogoRun Go/No-Go analysis
peopleMatch key people
tagsAuto-apply tags
architectClassify architecture type

​
Checking Status

Poll for augmentation status: 
curl "https://api.adaptengine.com/api/v1/leads/{leadId}/augmentation/status" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response: 
{
  "ok": true,
  "data": {
    "status": "GENERATING_SIGNALS",
    "progress": 45,
    "startedAt": 1706623200000,
    "completedSteps": ["CHECKING_DATA", "CLASSIFYING_ARCHITECTS"],
    "currentStep": "GENERATING_SIGNALS",
    "error": null
  }
}

​
Augmentation Job

interface AugmentationJob {
  id: string;
  leadId: string;
  status: AugmentationStatus;
  progress: number;           // 0-100
  steps: string[];            // Requested steps
  completedSteps: string[];
  currentStep: string | null;
  error: string | null;
  startedAt: number;
  completedAt: number | null;
  triggeredBy: string;        // User ID
}

type AugmentationStatus =
  | 'QUEUED'
  | 'CHECKING_DATA'
  | 'CLASSIFYING_ARCHITECTS'
  | 'AUTO_TAGGING'
  | 'GENERATING_SIGNALS'
  | 'MATCHING_PEOPLE'
  | 'ANALYZING_GONOGO'
  | 'CALCULATING_SCORE'
  | 'FINISHED'
  | 'ERROR';

​
Bulk Augmentation

Enrich multiple leads: 
curl -X POST "https://api.adaptengine.com/api/v1/leads/augmentation/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "leadIds": ["lead_1", "lead_2", "lead_3"],
    "steps": ["signals", "scoring"]
  }'

​
Best Practices

Selective enrichment - Only run the steps you need. Full augmentation uses significant AI credits.
Rate limits - Augmentation jobs are queued and processed sequentially to manage AI API costs.

​
API Endpoints

MethodEndpointDescription
POST/api/v1/leads/{leadId}/augmentationStart augmentation
GET/api/v1/leads/{leadId}/augmentation/statusCheck status
POST/api/v1/leads/augmentation/bulkBulk augmentation