{"items":[{"type":"link","label":"Lantern API docs","link":"/openapi","routeSlug":"/openapi","content":{"contentType":"overview","meta":{"name":"Lantern API docs"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Lantern API docs (1.4.1)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[]}],"sectionId":"/openapi"}],"sectionId":"/openapi"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Lantern API provides two major processing modes to enhance your contact and business data:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔄 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Real-time Processing ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/enrich/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process individual records and get immediate responses. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Real-time user interfaces"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single record processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate validation workflows"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Find phone numbers for contacts"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Discover professional email addresses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Company Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Get comprehensive firmographics and website-verified data"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Person Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enrich person records with contact and professional data"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Generate insights, analysis, and structured data using advanced language models"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deep Research"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Comprehensive research using advanced language models with real-time search capabilities"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🎯 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Object Matching ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/match/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match Account/Contact/Lead objects with sophisticated matching logic. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CRM data deduplication"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead-to-account matching"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact matching and merging"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account Matching"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Match company records with exact, fuzzy, and AI-assisted logic"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact Matching"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Match contact records with grouped boolean logic"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead Matching"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Match lead records with confidence scoring and explanations"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔗 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Salesforce API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Lead Conversion ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/salesforce/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Convert Salesforce Leads to Contacts and Accounts with intelligent matching. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automated lead conversion workflows"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CRM data management"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead-to-contact merging"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead Conversion"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Convert leads to contacts and accounts with duplicate prevention"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Auto-Merge"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Intelligent merging with configurable policies"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Round-Robin Assignment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Automatic owner assignment from pools"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🎯 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Routing API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Round Robin Assignment ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/routing/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assign Salesforce objects to users using intelligent round-robin logic. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fair distribution of leads and opportunities"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automated user assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pool-based routing management"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Round Robin Assignment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Assign objects to users with sequence tracking"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pool Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Organize users into assignment pools"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reset Rules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Support for resetting rotation with specific reasons"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚡ "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Triggers API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Instant Enrichment ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/triggers/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trigger instant enrichment on Salesforce record creation/updates. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Real-time data enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automated workflow triggers"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Near real-time processing"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Salesforce Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Real-time trigger processing via Platform Events"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Polling Fallback"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": SOQL-based polling every 2 minutes for comprehensive coverage"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Automatic enrichment workflows on record changes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"📊 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Logs API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Audit & Reporting ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/logs/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comprehensive audit trails and reporting for all routing actions. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Compliance and audit requirements"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Performance analysis and monitoring"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User activity tracking"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Route Log Export"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Export logs with filtering and multiple formats (JSON/CSV)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Log Statistics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Statistical analysis of log data for reporting"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retention Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Configurable retention policies and cleanup schedules"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🚀 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Async API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Batch Processing ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process multiple records (1-1000) asynchronously with results stored in S3. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Large-scale bulk processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Background processing workflows"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cost breakdown results on s3 too"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone Enrichment Batch"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Bulk phone number enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Enrichment Batch"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Bulk email address enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deep Research Batch"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Bulk AI-powered research with specialized agents"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"💳 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Credit Management ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/credits/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monitor and manage your credit usage and availability. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tracking credit consumption across time periods"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checking remaining credit balance"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Get detailed usage statistics for specific date ranges"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Remaining Credits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Check current credit balance"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"🔄 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workflow Trigger API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - External System Integration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/workflows/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trigger enrichment and routing workflows from external systems. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Eloqua, CDP, and Data Lake integrations"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marketing automation platform triggers"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High-volume bursty event processing"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workflow Trigger"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Generic interface for initiating workflows from any external system"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Logging"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Complete request/response logging for compliance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retry Logic"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Automatic retries with exponential backoff"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"📝 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Form Submit API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Direct Form Processing ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/forms/"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accept form submissions and immediately enrich and disposition data. Perfect for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marketing automation platform integrations"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Website form processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Real-time lead enrichment"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available Services:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Form Submission"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Accept form data with validation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Sub-5 second processing with GDPR compliance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flexible Output"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Return enriched data or push to external systems"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/overview"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/processing-mode-comparison"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing Mode Comparison"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Feature"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Salesforce API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Routing API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Triggers API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Logs API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Async API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workflow API"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Form API"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records per request"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1-100"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1-100"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1-10000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1-1000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"N/A"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response time"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Asynchronous"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Result delivery"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"S3 storage"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Direct response"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use case"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Real-time processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Object matching"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead conversion"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit reporting"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bulk operations"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit monitoring"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"External system triggers"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Form processing"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate limits"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lower frequency limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-minute limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High burst support"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High burst support"},"children":[]}]}]}]}]}]}]}],"sectionId":"/openapi/section/processing-mode-comparison"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/base-url"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"https://api-gateway.agenthq.withlantern.com\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"https://api-gateway.agenthq.withlantern.com\n"},"children":[]}]}]}],"sectionId":"/openapi/section/base-url"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All requests must include your API key in the Authorization header:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"Authorization: Bearer YOUR_API_KEY\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Authorization: Bearer YOUR_API_KEY\n"},"children":[]}]}]}],"sectionId":"/openapi/section/authentication"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/rate-limiting-and-credits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate Limiting & Credits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API Rate Limit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 50 requests per minute per API key. Can be lifted on request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Async API Rate Limit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 batch request per minute per API key. Can be lifted on request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits API Rate Limit"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 10 requests per minute per API key. Can be lifted on request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Headers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Rate limit and credit information is returned in response headers:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"X-RateLimit-Limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The rate limit ceiling for your API key"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"X-Credits-Remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Credits remaining in your account"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"429 Too Many Requests"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Rate limit exceeded"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"402 Payment Required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Credit limit exceeded"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/rate-limiting-and-credits"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/best-practices"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Best Practices"},"children":[]}]}]}]}],"sectionId":"/openapi/section/best-practices"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/general-guidelines"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"General Guidelines"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API Key Security"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Keep your API key secure and never expose it in client-side code"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate Limit Handling"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Implement exponential backoff when receiving 429 responses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Handling"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Always check the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field before processing results"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Monitor your credit usage and remaining balance through response headers"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/general-guidelines"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/sync-api-guidelines"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API Guidelines"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use Unique Record IDs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Always provide unique record IDs to enable caching and prevent duplicate processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set Credit Limits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to control spending per request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cache Awareness"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Check the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field to understand if fresh data was retrieved"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monitor Confidence Levels"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Use confidence scores to determine data quality for your use case"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/sync-api-guidelines"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/async-api-guidelines"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Async API Guidelines"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Sizing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Submit 100-1000 records per batch for optimal performance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Result Monitoring"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Get submission details from API call when batch is accepted, then poll results from S3 until completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Planning"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Set appropriate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" limits for large batches"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Handling"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Handle batch-level errors and individual record failures within results"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/async-api-guidelines"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/credits-api-guidelines"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits API Guidelines"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Proactive Monitoring"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Check remaining credits before large operations"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Usage Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Use date range filtering to analyze spending patterns"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Budget Planning"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Monitor usage trends to forecast credit needs"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/credits-api-guidelines"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/ai-enrichment"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI Enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Clear Queries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Be specific and provide context for better responses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enable JSON formatting for structured data extraction tasks"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monitor Confidence"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Pay attention to confidence scores for quality assessment"},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/ai-enrichment"}]}]}},{"type":"link","label":"Overview","link":"/openapi/section/overview","routeSlug":"/openapi/section/overview","content":null},{"type":"link","label":"Processing Mode Comparison","link":"/openapi/section/processing-mode-comparison","routeSlug":"/openapi/section/processing-mode-comparison","content":null},{"type":"link","label":"Base URL","link":"/openapi/section/base-url","routeSlug":"/openapi/section/base-url","content":null},{"type":"link","label":"Authentication","link":"/openapi/section/authentication","routeSlug":"/openapi/section/authentication","content":null},{"type":"link","label":"Rate Limiting & Credits","link":"/openapi/section/rate-limiting-and-credits","routeSlug":"/openapi/section/rate-limiting-and-credits","content":null},{"type":"link","label":"Best Practices","link":"/openapi/section/best-practices","routeSlug":"/openapi/section/best-practices","content":null},{"type":"link","label":"General Guidelines","link":"/openapi/section/general-guidelines","routeSlug":"/openapi/section/general-guidelines","content":null},{"type":"link","label":"Sync API Guidelines","link":"/openapi/section/sync-api-guidelines","routeSlug":"/openapi/section/sync-api-guidelines","content":null},{"type":"link","label":"Async API Guidelines","link":"/openapi/section/async-api-guidelines","routeSlug":"/openapi/section/async-api-guidelines","content":null},{"type":"link","label":"Credits API Guidelines","link":"/openapi/section/credits-api-guidelines","routeSlug":"/openapi/section/credits-api-guidelines","content":null},{"type":"link","label":"AI Enrichment","link":"/openapi/section/ai-enrichment","routeSlug":"/openapi/section/ai-enrichment","content":null},{"type":"group","label":"Enrichment","link":"/openapi/enrichment","routeSlug":"/openapi/enrichment","items":[{"label":"Phone Enrichment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/enrich_phone_v1_enrich_phone_post","routeSlug":"/openapi/enrichment/enrich_phone_v1_enrich_phone_post","metadata":{"seo":{"title":"Phone Enrichment","description":"Enriches contact records with phone number data using multiple data sources."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"enrich_phone_v1_enrich_phone_post","name":"Phone Enrichment","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1phone/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Phone Enrichment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enriches contact records with phone number data using multiple data sources."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_phone_v1_enrich_phone_post/request/overview","deepLinkHash":"/enrichment/enrich_phone_v1_enrich_phone_post#enrichment/enrich_phone_v1_enrich_phone_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Phone Enrichment API enriches contact records with phone number data using multiple data sources. The service intelligently cascades through different lookup methods to maximize success rates."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_phone_v1_enrich_phone_post/request/request-body","deepLinkHash":"/enrichment/enrich_phone_v1_enrich_phone_post#enrichment/enrich_phone_v1_enrich_phone_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Your unique identifier for this record (required) - used for caching and duplicate detection"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's first name (optional) - required for name-based enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's last name (optional) - required for name-based enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company name or website URL (optional) - required for name-based enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's email address (optional) - can be used standalone for enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's linkedin profile identifier/slug (optional) - can be used standalone for enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company domain (optional) - enhances name/company enrichment method"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_phone_v1_enrich_phone_post/request/request-constraints","deepLinkHash":"/enrichment/enrich_phone_v1_enrich_phone_post#enrichment/enrich_phone_v1_enrich_phone_post/request/request-constraints"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Constraints"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single record per request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be unique per contact record in your system"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must provide at least one of the following data combinations:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name + Company/Domain"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optionally enhanced with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"LinkedIn Profile Only"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Only"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enrichment prioritizes data in this order:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name + Company/Domain"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Primary method when available"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"LinkedIn Profile"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Fallback when name/company data is incomplete"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Only"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Final fallback when other data is insufficient"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_phone_v1_enrich_phone_post/request/response-fields","deepLinkHash":"/enrichment/enrich_phone_v1_enrich_phone_post#enrichment/enrich_phone_v1_enrich_phone_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the input record ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input first name (or null if not provided)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input last name (or null if not provided)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input company (or null if not provided)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input email or email found during enrichment (or null if not found)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input LinkedIn ID or LinkedIn profile found during enrichment (or null if not found)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": International format phone number (E.164) or null if not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Time taken to process the request in milliseconds"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichmentRequest"}},"schemaId":"components/schemas/PhoneEnrichmentRequest","pointer":"/paths/~1v1~1enrich~1phone/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/phone","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PhoneEnrichmentRequest"}},"responseCodes":["200","400","401","422","429","500"],"pointer":"/v1/enrich/phone","href":"enrichment/enrich_phone_v1_enrich_phone_post","openApiOperationId":"enrich_phone_v1_enrich_phone_post","summary":"Phone Enrichment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/PhoneEnrichmentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichmentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PhoneEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/PhoneEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1phone/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PhoneEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PhoneEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/enrich_phone_v1_enrich_phone_post"}],"panels":[]}]},"httpPath":"/v1/enrich/phone"},{"label":"Email Enrichment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/enrich_email_v1_enrich_email_post","routeSlug":"/openapi/enrichment/enrich_email_v1_enrich_email_post","metadata":{"seo":{"title":"Email Enrichment","description":"Enriches contact records with email address data using multiple data sources."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"enrich_email_v1_enrich_email_post","name":"Email Enrichment","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1email/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Email Enrichment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enriches contact records with email address data using multiple data sources."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_email_v1_enrich_email_post/request/overview","deepLinkHash":"/enrichment/enrich_email_v1_enrich_email_post#enrichment/enrich_email_v1_enrich_email_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Email Enrichment API enriches contact records with email address data using multiple data sources. The service uses various lookup methods to find professional email addresses for contacts based on their name and company information."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_email_v1_enrich_email_post/request/request-body","deepLinkHash":"/enrichment/enrich_email_v1_enrich_email_post#enrichment/enrich_email_v1_enrich_email_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Your unique identifier for this record (required) - used for caching and duplicate detection"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's first name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's last name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company name or website URL where the contact works (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company domain (optional) - if not provided, will be extracted from company field"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact's linkedin url (optional) - improves lookup accuracy when available"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits to spend on this request (optional, defaults to your account limit)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_email_v1_enrich_email_post/request/request-constraints","deepLinkHash":"/enrichment/enrich_email_v1_enrich_email_post#enrichment/enrich_email_v1_enrich_email_post/request/request-constraints"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Constraints"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single record per request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be unique per contact record in your system"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is optional but improves accuracy when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is optional but improves accuracy when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be a positive integer if provided"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_email_v1_enrich_email_post/request/response-fields","deepLinkHash":"/enrichment/enrich_email_v1_enrich_email_post#enrichment/enrich_email_v1_enrich_email_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the input record ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input first name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input last name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of input company"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Professional email address or null if not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confidence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Confidence level ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"high"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"medium"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"low"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or null"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used for this request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (int | null): Approximate remaining credit balance. Use GET /v1/credits/remaining for precise value."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Time taken to process the request in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating if this result was returned from cache (no credits consumed if true)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_email_v1_enrich_email_post/request/credit-usage","deepLinkHash":"/enrichment/enrich_email_v1_enrich_email_post#enrichment/enrich_email_v1_enrich_email_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email enrichment consumes credits based on the data sources queried:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cached Result"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 0 credits (if same record_id queried recently)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Search: 5 credits"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailEnrichmentRequest"}},"schemaId":"components/schemas/EmailEnrichmentRequest","pointer":"/paths/~1v1~1enrich~1email/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/email","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/EmailEnrichmentRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/enrich/email","href":"enrichment/enrich_email_v1_enrich_email_post","openApiOperationId":"enrich_email_v1_enrich_email_post","summary":"Email Enrichment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/EmailEnrichmentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailEnrichmentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmailEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/EmailEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1email/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EmailEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EmailEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/enrich_email_v1_enrich_email_post"}],"panels":[]}]},"httpPath":"/v1/enrich/email"},{"label":"Company Enrichment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/enrich_company_v1_enrich_company_post","routeSlug":"/openapi/enrichment/enrich_company_v1_enrich_company_post","metadata":{"seo":{"title":"Company Enrichment","description":"Enriches company records with firmographics and website-verified data."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"enrich_company_v1_enrich_company_post","name":"Company Enrichment","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1company/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Company Enrichment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enriches company records with firmographics and website-verified data."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_company_v1_enrich_company_post/request/overview","deepLinkHash":"/enrichment/enrich_company_v1_enrich_company_post#enrichment/enrich_company_v1_enrich_company_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Company Enrichment API enriches company records with comprehensive firmographics data including company details, location information, industry classification, size range, and geographic coordinates."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_company_v1_enrich_company_post/request/request-body","deepLinkHash":"/enrichment/enrich_company_v1_enrich_company_post#enrichment/enrich_company_v1_enrich_company_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for this enrichment request (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company name (optional) - improves accuracy when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company domain (optional) - improves accuracy when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Country code or name (optional) - helps with geographic targeting"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"external_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": External system IDs (optional) - for integration with CRM systems"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"effort"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enrichment effort level (optional, default: low)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits to spend on this request (optional, defaults to your account limit)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_company_v1_enrich_company_post/request/request-constraints","deepLinkHash":"/enrichment/enrich_company_v1_enrich_company_post#enrichment/enrich_company_v1_enrich_company_post/request/request-constraints"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Constraints"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are optional but improves accuracy when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"external_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" should be a dictionary of key-value pairs (e.g., {\"sf_account_id\": \"001xx000...\"})"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be a positive integer if provided"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_company_v1_enrich_company_post/request/response-fields","deepLinkHash":"/enrichment/enrich_company_v1_enrich_company_post#enrichment/enrich_company_v1_enrich_company_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the input record ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enriched company data object containing:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company domain"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": LinkedIn company page URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Headquarters location (city, state, country, postal_code)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"size_range"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Employee size range (e.g., \"500+\")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"industry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Industry classification"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"geo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Geographic coordinates and location details (lat, lon, county)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_verified_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp of last verification"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confidence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Confidence score (0.0-1.0) or null if disabled/not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used for this request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (int | null): Approximate remaining credit balance. Use GET /v1/credits/remaining for precise value."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Time taken to process the request in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating if this result was returned from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_company_v1_enrich_company_post/request/credit-usage","deepLinkHash":"/enrichment/enrich_company_v1_enrich_company_post#enrichment/enrich_company_v1_enrich_company_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Company enrichment consumes credits based on the data sources queried:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cached Result"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 0 credits (if same company queried recently)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Company Lookup: 5 credits"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyEnrichmentRequest"}},"schemaId":"components/schemas/CompanyEnrichmentRequest","pointer":"/paths/~1v1~1enrich~1company/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/company","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CompanyEnrichmentRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/enrich/company","href":"enrichment/enrich_company_v1_enrich_company_post","openApiOperationId":"enrich_company_v1_enrich_company_post","summary":"Company Enrichment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/CompanyEnrichmentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyEnrichmentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/CompanyEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1company/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/enrich_company_v1_enrich_company_post"}],"panels":[]}]},"httpPath":"/v1/enrich/company"},{"label":"Person Enrichment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/enrich_person_v1_enrich_person_post","routeSlug":"/openapi/enrichment/enrich_person_v1_enrich_person_post","metadata":{"seo":{"title":"Person Enrichment","description":"Enriches person records with comprehensive contact and professional data."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"enrich_person_v1_enrich_person_post","name":"Person Enrichment","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1person/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Person Enrichment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enriches person records with comprehensive contact and professional data."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/overview","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Person Enrichment API enriches person records with comprehensive contact information, professional details, and verification status. This service provides detailed person data including contact information, job titles, seniority levels, and email/phone verification status."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/request-body","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for this enrichment request (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Person's first name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Person's last name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company_domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company domain where the person works (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Person's email address (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": LinkedIn ID or profile URL (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"effort"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enrichment effort level (optional, default: low)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits to spend on this request (optional, defaults to your account limit)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/request-constraints","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/request-constraints"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Constraints"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company_domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company_domain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" should be a valid domain format"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" should be a valid email format when provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be a positive integer if provided"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/response-fields","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the input record ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"person"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enriched person data object containing:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Person's full name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Person's email address"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email_confidence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email confidence score (0.0-1.0)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email verification status (valid, accept_all, risky, invalid, unknown)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Phone number"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job title"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"linkedin_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": LinkedIn profile URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"job_last_seen_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp when job information was last verified"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confidence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Confidence score (0.0-1.0) or null if disabled/not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used for this request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (int | null): Approximate remaining credit balance. Use GET /v1/credits/remaining for precise value."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Time taken to process the request in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating if this result was returned from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/email-status-values","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/email-status-values"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email Status Values"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email address is valid and deliverable"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accept_all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email server accepts all emails (catch-all)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"risky"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email address may be risky or temporary"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email address is invalid or undeliverable"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unknown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email status could not be determined"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_person_v1_enrich_person_post/request/credit-usage","deepLinkHash":"/enrichment/enrich_person_v1_enrich_person_post#enrichment/enrich_person_v1_enrich_person_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Person enrichment consumes credits based on the data sources queried:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cached Result"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 0 credits (if same person queried recently)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Person Lookup: 4 credits"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PersonEnrichmentRequest"}},"schemaId":"components/schemas/PersonEnrichmentRequest","pointer":"/paths/~1v1~1enrich~1person/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/person","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PersonEnrichmentRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/enrich/person","href":"enrichment/enrich_person_v1_enrich_person_post","openApiOperationId":"enrich_person_v1_enrich_person_post","summary":"Person Enrichment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/PersonEnrichmentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PersonEnrichmentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PersonEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/PersonEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1person/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PersonEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PersonEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/enrich_person_v1_enrich_person_post"}],"panels":[]}]},"httpPath":"/v1/enrich/person"},{"label":"AI Enrichment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/enrich_ai_v1_enrich_ai_post","routeSlug":"/openapi/enrichment/enrich_ai_v1_enrich_ai_post","metadata":{"seo":{"title":"AI Enrichment","description":"AI Enrichment API"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"enrich_ai_v1_enrich_ai_post","name":"AI Enrichment","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1ai/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"AI Enrichment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/ai-enrichment-api","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/ai-enrichment-api"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI Enrichment API"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/overview","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The AI Enrichment API allows you to enrich data or generate insights using advanced language models. Send a query or prompt and receive AI-generated responses that can include analysis, summaries, recommendations, or structured data extraction."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/request-body","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"query\": \"string (required)\",\n  \"options\": {\n    \"format_json\": \"boolean (optional)\"\n  },\n  \"effort\": \"string (optional, default: low)\"\n  \"max_credits\": \"integer (optional)\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"query\": \"string (required)\",\n  \"options\": {\n    \"format_json\": \"boolean (optional)\"\n  },\n  \"effort\": \"string (optional, default: low)\"\n  \"max_credits\": \"integer (optional)\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/field-descriptions","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/field-descriptions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field Descriptions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The main prompt or question to send to the AI model (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optional): Additional configuration options"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"format_json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether to return response in structured JSON format (defaults to false)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"effort"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optional): Specifies the level of enrichment effort to apply, by default is low"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be a positive integer if provided"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/request-constraints","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/request-constraints"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Constraints"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required and must be non-empty"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options.format_json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when provided must be a boolean value"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"effort"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when provided accepted values are: low, medium, high"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query length should not exceed 8000 characters"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/response-fields","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the input query"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"response"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": AI-generated response (string or structured object based on format_json setting)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confidence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": AI confidence score in the response (0.0-1.0)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used for this request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (int | null): Approximate remaining credit balance. Use GET /v1/credits/remaining for precise value."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"token_usage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Token consumption details"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"prompt_tokens"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Tokens used in the input"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completion_tokens"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Tokens used in the response"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_tokens"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Total tokens consumed"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Time taken to process the request in milliseconds"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/confidence-levels","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/confidence-levels"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Confidence Levels"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.9-1.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Very high confidence - factual, well-supported responses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.7-0.9"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": High confidence - good quality responses with minor uncertainty"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.5-0.7"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Medium confidence - reasonable responses but may need verification"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.0-0.5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Low confidence - speculative or uncertain responses"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/common-use-cases","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/common-use-cases"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Common Use Cases"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Data Analysis & Insights"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Analyze trends, patterns, and generate business insights"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Content Generation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Create marketing copy, emails, summaries, and reports"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Data Extraction"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Parse unstructured text and extract structured information"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Research & Summarization"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Synthesize information and provide comprehensive overviews"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Decision Support"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Generate recommendations and evaluate options"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text Enhancement"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Improve, rewrite, or optimize existing content"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"enrichment/enrich_ai_v1_enrich_ai_post/request/credit-usage","deepLinkHash":"/enrichment/enrich_ai_v1_enrich_ai_post#enrichment/enrich_ai_v1_enrich_ai_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI enrichment consumes credits based on the complexity and length of the response:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Simple Queries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1-3 credits (short responses, basic analysis)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Standard Queries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 3-6 credits (medium-length responses, data extraction)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Complex Analysis"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 6-12 credits (detailed analysis, research, long-form content)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Structured Output"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +1-2 credits additional (for formatting and validation)"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AIEnrichmentRequest"}},"schemaId":"components/schemas/AIEnrichmentRequest","pointer":"/paths/~1v1~1enrich~1ai/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/ai","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AIEnrichmentRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/enrich/ai","href":"enrichment/enrich_ai_v1_enrich_ai_post","openApiOperationId":"enrich_ai_v1_enrich_ai_post","summary":"AI Enrichment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/AIEnrichmentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AIEnrichmentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AIEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response","paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response"]}},"schemaId":"components/schemas/AIEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response","paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1ai/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AIEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response","paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AIEnrichmentResponse","exampleIds":["paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response","paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/enrich_ai_v1_enrich_ai_post"}],"panels":[]}]},"httpPath":"/v1/enrich/ai"},{"label":"Deep Research","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/enrichment/deep_research_v1_enrich_research_post","routeSlug":"/openapi/enrichment/deep_research_v1_enrich_research_post","metadata":{"seo":{"title":"Deep Research","description":"Conducts comprehensive research using advanced language models with real-time search capabilities."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deep_research_v1_enrich_research_post","name":"Deep Research","isWebhook":false,"pointer":"/paths/~1v1~1enrich~1research/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deep Research","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Conducts comprehensive research using advanced language models with real-time search capabilities."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeepResearchRequest"}},"schemaId":"components/schemas/DeepResearchRequest","pointer":"/paths/~1v1~1enrich~1research/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/enrich/research","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/DeepResearchRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/enrich/research","href":"enrichment/deep_research_v1_enrich_research_post","openApiOperationId":"deep_research_v1_enrich_research_post","summary":"Deep Research"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/DeepResearchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeepResearchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DeepResearchResponse"}},"schemaId":"components/schemas/DeepResearchResponse"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1enrich~1research/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/DeepResearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DeepResearchResponse"}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/enrichment/deep_research_v1_enrich_research_post"}],"panels":[]}]},"httpPath":"/v1/enrich/research"}],"content":{"contentType":"group","meta":{"name":"Enrichment"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Enrichment","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/enrich/phone","summary":"Phone Enrichment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/enrich_phone_v1_enrich_phone_post","deprecated":false},{"title":"/v1/enrich/email","summary":"Email Enrichment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/enrich_email_v1_enrich_email_post","deprecated":false},{"title":"/v1/enrich/company","summary":"Company Enrichment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/enrich_company_v1_enrich_company_post","deprecated":false},{"title":"/v1/enrich/person","summary":"Person Enrichment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/enrich_person_v1_enrich_person_post","deprecated":false},{"title":"/v1/enrich/ai","summary":"AI Enrichment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/enrich_ai_v1_enrich_ai_post","deprecated":false},{"title":"/v1/enrich/research","summary":"Deep Research","prefix":{"name":"post","color":"post"},"badges":[],"link":"/enrichment/deep_research_v1_enrich_research_post","deprecated":false}]}]}]}]}},{"type":"group","label":"Match","link":"/openapi/match","routeSlug":"/openapi/match","items":[{"label":"Match API","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/match/match_objects_v1_match_post","routeSlug":"/openapi/match/match_objects_v1_match_post","metadata":{"seo":{"title":"Match API","description":"Supports exact, fuzzy, and AI-assisted matching with grouped boolean logic."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"match_objects_v1_match_post","name":"Match API","isWebhook":false,"pointer":"/paths/~1v1~1match/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Match API","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports exact, fuzzy, and AI-assisted matching with grouped boolean logic."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/overview","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Match API provides sophisticated matching capabilities for Account, Contact, and Lead objects. It supports multiple matching modes including simple field matching, grouped boolean logic, and AI-assisted matching with natural language explanations."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/request-body","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Object type to match (account, contact, lead)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"candidates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of candidates to match against Salesforce records"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Matching rules configuration"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"context"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional context information (Salesforce instance, org ID, etc.)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits to spend on this request"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/matching-modes","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/matching-modes"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Matching Modes"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"match/match_objects_v1_match_post/request/simple-mode","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/simple-mode"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Simple Mode"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic field-by-field matching with exact and fuzzy rules."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"match/match_objects_v1_match_post/request/grouped-mode","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/grouped-mode"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Grouped Mode"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Advanced boolean logic with grouped rules:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"groups"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of rule groups"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"all"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Rules within a group that must all match"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"any"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether any group needs to be true"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"threshold"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Overall confidence cutoff"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"match/match_objects_v1_match_post/request/ai-mode","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/ai-mode"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI Mode"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI-assisted matching using LLM scoring:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Natural language explanations"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Context-aware matching"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use when structured rules fail"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/field-rules","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/field-rules"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field Rules"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field:exact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Exact string match"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field:fuzzy0.x"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Fuzzy match with 0.x threshold"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field:eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Equality match"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"field:contains"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contains match"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/response-fields","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of candidate results with matches"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (approximate balance; use GET /v1/credits/remaining for precise value)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"match/match_objects_v1_match_post/request/credit-usage","deepLinkHash":"/match/match_objects_v1_match_post#match/match_objects_v1_match_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match API consumes credits based on complexity:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Simple Mode"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 credit per candidate"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Grouped Mode"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 2 credits per candidate"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI Mode"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 5 credits per candidate"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/MatchRequest"}},"schemaId":"components/schemas/MatchRequest","pointer":"/paths/~1v1~1match/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/match","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/MatchRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/match","href":"match/match_objects_v1_match_post","openApiOperationId":"match_objects_v1_match_post","summary":"Match API"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/MatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/MatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MatchResponse","exampleIds":["paths/~1v1~1match/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/MatchResponse","exampleIds":["paths/~1v1~1match/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1match/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MatchResponse","exampleIds":["paths/~1v1~1match/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MatchResponse","exampleIds":["paths/~1v1~1match/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/match/match_objects_v1_match_post"}],"panels":[]}]},"httpPath":"/v1/match"}],"content":{"contentType":"group","meta":{"name":"Match"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Match","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/match","summary":"Match API","prefix":{"name":"post","color":"post"},"badges":[],"link":"/match/match_objects_v1_match_post","deprecated":false}]}]}]}]}},{"type":"group","label":"Salesforce","link":"/openapi/salesforce","routeSlug":"/openapi/salesforce","items":[{"label":"Lead → Contact Auto-Convert & Merge","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/salesforce/convert_lead_v1_salesforce_convert_post","routeSlug":"/openapi/salesforce/convert_lead_v1_salesforce_convert_post","metadata":{"seo":{"title":"Lead → Contact Auto-Convert & Merge","description":"Converts Salesforce Leads to Contacts and Accounts with sophisticated matching and merging logic."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"convert_lead_v1_salesforce_convert_post","name":"Lead → Contact Auto-Convert & Merge","isWebhook":false,"pointer":"/paths/~1v1~1salesforce~1convert/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Lead → Contact Auto-Convert & Merge","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Converts Salesforce Leads to Contacts and Accounts with sophisticated matching and merging logic."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/overview","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Salesforce Conversion API provides automated Lead-to-Contact conversion with intelligent matching,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"duplicate prevention, and merge policies. It uses Salesforce Lead.Convert under the hood with batch API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and includes duplicate protection via pre-check matching."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/request-body","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lead_sf_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce Lead ID to convert (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"match_policy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Match policy configuration for contact and account matching"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merge_policy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Merge policy configuration for handling matches"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"set_owner_round_robin_pool"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional round-robin pool for owner assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"logs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Logging configuration for conversion process"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/match-policy","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/match-policy"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match Policy"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact matching rules and creation policy"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Account matching rules and creation policy"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"by"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of field rules for matching (e.g., [\"email:eq\", \"name_company:fuzzy0.8\"])"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"create_if_no_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether to create new record if no match found"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/merge-policy","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/merge-policy"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merge Policy"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"on_contact_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Action when contact match is found"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merge_lead_into_contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Moves notes/activities, preserves owner history"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"create_separate_contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Creates separate contact record"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"on_account_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Action when account match is found"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"attach_to_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Attaches lead to existing account"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"create_separate_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Creates separate account record"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/response-fields","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Conversion status (converted, failed, duplicate)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Created or matched Account ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Created or matched Contact ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"owner_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Assigned Owner ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"actions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of actions performed during conversion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/features","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/features"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Features"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Duplicate Protection"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Pre-check via /v1/match to avoid duplicate contacts/accounts"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idempotent"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Same Idempotency-Key repeats return prior result"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Processing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Uses Salesforce Lead.Convert with batch API"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Round-Robin Assignment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional owner assignment from specified pools"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comprehensive Logging"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Route logs and enrichment differences"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"salesforce/convert_lead_v1_salesforce_convert_post/request/credit-usage","deepLinkHash":"/salesforce/convert_lead_v1_salesforce_convert_post#salesforce/convert_lead_v1_salesforce_convert_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Salesforce conversion consumes credits based on complexity:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic Conversion"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 3 credits per lead"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Matching"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +2 credits for duplicate checking"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Round-Robin"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +1 credit for owner assignment"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConvertRequest"}},"schemaId":"components/schemas/ConvertRequest","pointer":"/paths/~1v1~1salesforce~1convert/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/salesforce/convert","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ConvertRequest"}},"responseCodes":["200","400","401","402","409","422","429","500"],"pointer":"/v1/salesforce/convert","href":"salesforce/convert_lead_v1_salesforce_convert_post","openApiOperationId":"convert_lead_v1_salesforce_convert_post","summary":"Lead → Contact Auto-Convert & Merge"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/ConvertRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ConvertRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConvertResponse","exampleIds":["paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ConvertResponse","exampleIds":["paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"409","description":"Conflict - Duplicate record detected","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}],"pointer":"/paths/~1v1~1salesforce~1convert/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ConvertResponse","exampleIds":["paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConvertResponse","exampleIds":["paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"409","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/salesforce/convert_lead_v1_salesforce_convert_post"}],"panels":[]}]},"httpPath":"/v1/salesforce/convert"}],"content":{"contentType":"group","meta":{"name":"Salesforce"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Salesforce","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/salesforce/convert","summary":"Lead → Contact Auto-Convert & Merge","prefix":{"name":"post","color":"post"},"badges":[],"link":"/salesforce/convert_lead_v1_salesforce_convert_post","deprecated":false}]}]}]}]}},{"type":"group","label":"Routing","link":"/openapi/routing","routeSlug":"/openapi/routing","items":[{"label":"Round Robin Assignment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/routing/assign_object_v1_routing_assign_post","routeSlug":"/openapi/routing/assign_object_v1_routing_assign_post","metadata":{"seo":{"title":"Round Robin Assignment","description":"Assigns Salesforce objects to users using round-robin logic with pool management."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assign_object_v1_routing_assign_post","name":"Round Robin Assignment","isWebhook":false,"pointer":"/paths/~1v1~1routing~1assign/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Round Robin Assignment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assigns Salesforce objects to users using round-robin logic with pool management."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/overview","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Round Robin Assignment API provides intelligent assignment of Salesforce objects (leads, contacts,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"opportunities, accounts) to users based on configurable pools and rotation rules. It supports"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"inactive user exclusion, reset rules, and maintains sequence tracking for fair distribution."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/request-body","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce object type to assign (lead, contact, opportunity, account)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sf_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce ID of the object to assign"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pool"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Round-robin pool identifier"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"exclude_inactive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether to exclude inactive users from assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reset_rules"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional reset rules for the assignment"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/reset-rules","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/reset-rules"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reset Rules"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Reason for reset (e.g., 'bad_fit', 'user_request')"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"place_user_at_top"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional user ID to place at top of rotation"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/response-fields","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"assigned_to"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": User ID that was assigned"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Current sequence number in the rotation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pool_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Total number of active users in the pool"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp of the assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/features","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/features"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Features"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pool Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Organize users into assignment pools"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sequence Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maintains rotation sequence for fair distribution"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Inactive User Exclusion"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Automatically excludes inactive users"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reset Rules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Support for resetting rotation with specific reasons"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fair Distribution"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Ensures equal distribution across active users"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Trail"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Timestamps and sequence tracking for compliance"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"routing/assign_object_v1_routing_assign_post/request/credit-usage","deepLinkHash":"/routing/assign_object_v1_routing_assign_post#routing/assign_object_v1_routing_assign_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Round Robin assignment consumes credits based on complexity:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic Assignment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 credit per assignment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Reset Rules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +1 credit for reset operations"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pool Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +0.5 credits for pool size calculation"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AssignRequest"}},"schemaId":"components/schemas/AssignRequest","pointer":"/paths/~1v1~1routing~1assign/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/routing/assign","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AssignRequest"}},"responseCodes":["200","400","401","402","404","422","429","500"],"pointer":"/v1/routing/assign","href":"routing/assign_object_v1_routing_assign_post","openApiOperationId":"assign_object_v1_routing_assign_post","summary":"Round Robin Assignment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/AssignRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AssignRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AssignResponse","exampleIds":["paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/AssignResponse","exampleIds":["paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"404","description":"Not Found - Pool or user not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}],"pointer":"/paths/~1v1~1routing~1assign/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AssignResponse","exampleIds":["paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AssignResponse","exampleIds":["paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"404","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/routing/assign_object_v1_routing_assign_post"}],"panels":[]}]},"httpPath":"/v1/routing/assign"}],"content":{"contentType":"group","meta":{"name":"Routing"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Routing","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/routing/assign","summary":"Round Robin Assignment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/routing/assign_object_v1_routing_assign_post","deprecated":false}]}]}]}]}},{"type":"group","label":"Triggers","link":"/openapi/triggers","routeSlug":"/openapi/triggers","items":[{"label":"Salesforce Trigger Webhook","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/triggers/salesforce_trigger_v1_triggers_salesforce_post","routeSlug":"/openapi/triggers/salesforce_trigger_v1_triggers_salesforce_post","metadata":{"seo":{"title":"Salesforce Trigger Webhook","description":"Handles instant enrichment on Salesforce record creation/updates via webhook."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"salesforce_trigger_v1_triggers_salesforce_post","name":"Salesforce Trigger Webhook","isWebhook":false,"pointer":"/paths/~1v1~1triggers~1salesforce/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Salesforce Trigger Webhook","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handles instant enrichment on Salesforce record creation/updates via webhook."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/overview","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Salesforce Trigger API provides instant enrichment capabilities for Salesforce records through"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"webhook-based triggers. It supports both real-time webhook processing and polling-based enrichment"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for comprehensive coverage of record changes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/request-body","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce object type that triggered the event (Lead, Contact, Account, Opportunity)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of Salesforce record IDs that changed"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"event"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce trigger event type (after_insert, after_update, after_undelete)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"org_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce organization ID"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/trigger-events","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/trigger-events"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trigger Events"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"after_insert"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Triggered when new records are created"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"after_update"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Triggered when existing records are updated"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"after_undelete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Triggered when records are undeleted"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/response-fields","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processed_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of records processed"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enrichment_jobs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": List of enrichment job IDs created"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"workflow_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Status of the enrichment workflow (started, queued, failed)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (approximate balance; use GET /v1/credits/remaining for precise value)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/enrichment-options","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/enrichment-options"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enrichment Options"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/webhook-processing-(real-time)","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/webhook-processing-(real-time)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhook Processing (Real-time)"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Immediate Processing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Records are processed immediately upon webhook receipt"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Platform Events"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Uses Salesforce Platform Events for reliable delivery"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apex Callouts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Triggered via Apex callouts from Salesforce triggers"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Low Latency"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Near real-time enrichment with minimal delay"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/polling-processing-(fallback)","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/polling-processing-(fallback)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Polling Processing (Fallback)"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SOQL Queries"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Polls Salesforce every 2 minutes for new/changed records"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Watermark Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Uses SystemModstamp and Id for efficient filtering"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Processing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processes records in batches for optimal performance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reliable Coverage"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Ensures no records are missed even if webhooks fail"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/features","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/features"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Features"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dual Processing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Both webhook and polling support for comprehensive coverage"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automatic Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Triggers enrichment workflows based on object type"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Job Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Creates enrichment jobs for monitoring and debugging"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Management"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Tracks credit consumption per enrichment job"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Handling"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Robust error handling with retry mechanisms"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Trail"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Comprehensive logging for compliance and debugging"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/salesforce_trigger_v1_triggers_salesforce_post/request/credit-usage","deepLinkHash":"/triggers/salesforce_trigger_v1_triggers_salesforce_post#triggers/salesforce_trigger_v1_triggers_salesforce_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trigger processing consumes credits based on enrichment type:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lead Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 2 credits per lead"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 credit per contact"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 3 credits per account"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Opportunity Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 credit per opportunity"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TriggerRequest"}},"schemaId":"components/schemas/TriggerRequest","pointer":"/paths/~1v1~1triggers~1salesforce/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/triggers/salesforce","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TriggerRequest"}},"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/triggers/salesforce","href":"triggers/salesforce_trigger_v1_triggers_salesforce_post","openApiOperationId":"salesforce_trigger_v1_triggers_salesforce_post","summary":"Salesforce Trigger Webhook"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/TriggerRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TriggerRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TriggerResponse","exampleIds":["paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/TriggerResponse","exampleIds":["paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1triggers~1salesforce/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TriggerResponse","exampleIds":["paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TriggerResponse","exampleIds":["paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/triggers/salesforce_trigger_v1_triggers_salesforce_post"}],"panels":[]}]},"httpPath":"/v1/triggers/salesforce"},{"label":"Polling Status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/triggers/get_polling_status_v1_triggers_polling_status_get","routeSlug":"/openapi/triggers/get_polling_status_v1_triggers_polling_status_get","metadata":{"seo":{"title":"Polling Status","description":"Get the current status of polling-based enrichment."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_polling_status_v1_triggers_polling_status_get","name":"Polling Status","isWebhook":false,"pointer":"/paths/~1v1~1triggers~1polling~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Polling Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the current status of polling-based enrichment."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/get_polling_status_v1_triggers_polling_status_get/request/overview","deepLinkHash":"/triggers/get_polling_status_v1_triggers_polling_status_get#triggers/get_polling_status_v1_triggers_polling_status_get/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint provides information about the current polling status, including"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"last poll time, records processed, watermark value, and next scheduled poll."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/get_polling_status_v1_triggers_polling_status_get/request/response-fields","deepLinkHash":"/triggers/get_polling_status_v1_triggers_polling_status_get#triggers/get_polling_status_v1_triggers_polling_status_get/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_poll_time"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp of last poll"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"records_processed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of records processed in last poll"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"watermark_value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Current watermark value"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_poll_time"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp of next scheduled poll"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"triggers/get_polling_status_v1_triggers_polling_status_get/request/use-cases","deepLinkHash":"/triggers/get_polling_status_v1_triggers_polling_status_get#triggers/get_polling_status_v1_triggers_polling_status_get/request/use-cases"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use Cases"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monitor polling performance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Debug enrichment issues"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify watermark progression"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check polling schedule"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/triggers/polling/status","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"responseCodes":["200","401","500"],"pointer":"/v1/triggers/polling/status","href":"triggers/get_polling_status_v1_triggers_polling_status_get","openApiOperationId":"get_polling_status_v1_triggers_polling_status_get","summary":"Polling Status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PollingStatus"}},"schemaId":"components/schemas/PollingStatus"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}],"pointer":"/paths/~1v1~1triggers~1polling~1status/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PollingStatus","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PollingStatus"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__enrichment__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/triggers/get_polling_status_v1_triggers_polling_status_get"}],"panels":[]}]},"httpPath":"/v1/triggers/polling/status"}],"content":{"contentType":"group","meta":{"name":"Triggers"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Triggers","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/triggers/salesforce","summary":"Salesforce Trigger Webhook","prefix":{"name":"post","color":"post"},"badges":[],"link":"/triggers/salesforce_trigger_v1_triggers_salesforce_post","deprecated":false},{"title":"/v1/triggers/polling/status","summary":"Polling Status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/triggers/get_polling_status_v1_triggers_polling_status_get","deprecated":false}]}]}]}]}},{"type":"group","label":"Logs","link":"/openapi/logs","routeSlug":"/openapi/logs","items":[{"label":"Export Route Logs","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/logs/export_route_logs_v1_logs_routing_get","routeSlug":"/openapi/logs/export_route_logs_v1_logs_routing_get","metadata":{"seo":{"title":"Export Route Logs","description":"Export route logs for audit and reporting purposes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"export_route_logs_v1_logs_routing_get","name":"Export Route Logs","isWebhook":false,"pointer":"/paths/~1v1~1logs~1routing/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Export Route Logs","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Export route logs for audit and reporting purposes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/overview","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Route Logs API provides comprehensive audit trails for all routing, conversion, merging,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and enrichment actions performed on Salesforce objects. It supports filtering, export formats,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and configurable retention policies."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/query-parameters","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/query-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query Parameters"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Start date for log export (ISO format, required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": End date for log export (ISO format, required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pool"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by specific pool name (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by specific object type (Lead, Contact, Account, Opportunity) (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Filter by specific action type (assign, convert, merge, enrich) (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"format"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Export format (json, csv) (optional, default: json)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include_diff"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Include diff data in export (optional, default: true)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum number of records to return (optional, default: 1000, max: 10000)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/response-fields","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each log entry includes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"timestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ISO timestamp of the action"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce object type"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"object_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce ID of the object"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Action performed (assign, convert, merge, enrich)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pool"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Round-robin pool name (for assign actions)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"assigned_to"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Salesforce ID of assigned user (for assign actions)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"prev_owner"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Previous owner ID (for assign/convert actions)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Round-robin sequence number (for assign actions)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Reason for the action"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Request ID for tracking"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"idempotency_key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Idempotency key for duplicate prevention"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"diff"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Field changes for enrichment/merge actions"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/export-formats","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/export-formats"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Export Formats"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"logs/export_route_logs_v1_logs_routing_get/request/json-format-(default)","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/json-format-(default)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Format (Default)"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns structured JSON data with full field information."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"logs/export_route_logs_v1_logs_routing_get/request/csv-format","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/csv-format"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CSV Format"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns comma-separated values suitable for spreadsheet applications."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Headers: timestamp, object, object_id, action, pool, assigned_to, prev_owner, sequence, reason, request_id, idempotency_key, diff"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Diff data is JSON-encoded in the diff column"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/use-cases","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/use-cases"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use Cases"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Compliance"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Track all actions for regulatory compliance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Performance Analysis"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Analyze routing patterns and efficiency"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User Activity"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Monitor user assignments and activity"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enrichment Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Track data enrichment changes and sources"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Troubleshooting"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Debug routing issues and user assignments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/retention-policy","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/retention-policy"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retention Policy"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Retention"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 365 days"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum Retention"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1095 days (3 years)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Auto Cleanup"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enabled by default (daily at 2 AM)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configurable"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Retention can be adjusted per organization"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"logs/export_route_logs_v1_logs_routing_get/request/rate-limits","deepLinkHash":"/logs/export_route_logs_v1_logs_routing_get#logs/export_route_logs_v1_logs_routing_get/request/rate-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Standard Export"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 10 requests per minute"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Large Exports"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 2 requests per minute (for exports > 5000 records)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Statistics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 20 requests per minute"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"from_date","in":"query","schemaId":"schema_17","description":"Start date for log export (ISO format)","required":true},{"name":"to_date","in":"query","schemaId":"schema_18","description":"End date for log export (ISO format)","required":true},{"name":"pool","in":"query","schemaId":"schema_19","description":"Filter by specific pool name"},{"name":"object","in":"query","schemaId":"schema_20","description":"Filter by specific object type"},{"name":"action","in":"query","schemaId":"schema_21","description":"Filter by specific action type"},{"name":"format","in":"query","schemaId":"schema_22","description":"Export format (json, csv)"},{"name":"include_diff","in":"query","schemaId":"schema_23","description":"Include diff data in export"},{"name":"limit","in":"query","schemaId":"schema_24","description":"Maximum number of records to return"}],"pointer":"/paths/~1v1~1logs~1routing/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/logs/routing","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[{"name":"from_date","in":"query","required":true,"schemaId":"schema_17"},{"name":"to_date","in":"query","required":true,"schemaId":"schema_18"},{"name":"pool","in":"query","required":false,"schemaId":"schema_19"},{"name":"object","in":"query","required":false,"schemaId":"schema_20"},{"name":"action","in":"query","required":false,"schemaId":"schema_21"},{"name":"format","in":"query","required":false,"schemaId":"schema_22"},{"name":"include_diff","in":"query","required":false,"schemaId":"schema_23"},{"name":"limit","in":"query","required":false,"schemaId":"schema_24"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"responseCodes":["200","400","401","402","422","429","500"],"pointer":"/v1/logs/routing","href":"logs/export_route_logs_v1_logs_routing_get","openApiOperationId":"export_route_logs_v1_logs_routing_get","summary":"Export Route Logs"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_25","exampleIds":["paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid query parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}],"pointer":"/paths/~1v1~1logs~1routing/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_25","exampleIds":["paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"402","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__logs__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/logs/export_route_logs_v1_logs_routing_get"}],"panels":[]}]},"httpPath":"/v1/logs/routing"}],"content":{"contentType":"group","meta":{"name":"Logs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Logs","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/logs/routing","summary":"Export Route Logs","prefix":{"name":"get","color":"get"},"badges":[],"link":"/logs/export_route_logs_v1_logs_routing_get","deprecated":false}]}]}]}]}},{"type":"group","label":"Batch Agents","link":"/openapi/batch-agents","routeSlug":"/openapi/batch-agents","items":[{"label":"Phone Enrichment Batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/batch-agents/phone_enrich_batch_v1_agents_phone_post","routeSlug":"/openapi/batch-agents/phone_enrich_batch_v1_agents_phone_post","metadata":{"seo":{"title":"Phone Enrichment Batch","description":"Process multiple records for phone enrichment in batch mode."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"phone_enrich_batch_v1_agents_phone_post","name":"Phone Enrichment Batch","isWebhook":false,"pointer":"/paths/~1v1~1agents~1phone/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Phone Enrichment Batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process multiple records for phone enrichment in batch mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/overview","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Phone Enrichment Batch API allows you to submit multiple person records for phone number enrichment processing asynchronously."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key Differences from Sync API:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/enrich/phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process one record at a time, get immediate response with phone number"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Submit 1-1000 records, get job ID, results stored in S3 when complete"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint accepts a batch of records and processes them asynchronously using workflow orchestration, making it ideal for bulk processing operations."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/request-body","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"Choose **one** of the following options:"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Submit IDs for processing:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Array of person IDs to process (1-1000 IDs)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"**Option 2: Submit record objects**\n- `records`: Array of person record objects to process (1-1000 records)\n  - `id`: Unique identifier for the record (required)\n  - `first_name`: Person's first name (optional)\n  - `last_name`: Person's last name (optional)\n  - `company`: Company name or website URL (optional)\n  - `email`: Person's email address (optional)\n  - `linkedin`: LinkedIn profile URL or identifier (optional)"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required fields:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Type of entity being processed (must be 'person' for phone enrichment) (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits this batch operation is allowed to consume (required)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/response","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for the batch run"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where results will be stored upon completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_csv_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where credit usage report will be stored upon completion"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/credit-usage","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits are consumed based on the number of records processed and the success rate of phone number lookups. The batch will stop processing if the credit limit is reached."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/batch-limits","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/batch-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum: 1 record"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum: 1000 records per batch"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records with missing required fields will be skipped"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/examples","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/examples"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Examples"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/example:-submit-ids-for-processing","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/example:-submit-ids-for-processing"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: Submit IDs for processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"ids\": [\"550e8400-e29b-41d4-a716-446655440001\", \"550e8400-e29b-41d4-a716-446655440002\", \"550e8400-e29b-41d4-a716-446655440003\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"ids\": [\"550e8400-e29b-41d4-a716-446655440001\", \"550e8400-e29b-41d4-a716-446655440002\", \"550e8400-e29b-41d4-a716-446655440003\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"### Example 2: Submit record objects\n```json\n{\n  \"records\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440001\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Smith\",\n      \"company\": \"Acme Corp\",\n      \"email\": \"john@acme.com\",\n      \"linkedin\": \"https://linkedin.com/in/johnsmith\"\n    },\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"company\": \"TechCorp\"\n    }\n  ],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n```"},"children":[]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/output","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/output"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Output"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The results CSV will contain the following columns:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"phone_number\": \"string | Phone number (E.164 format when available)\",\n  \"phone_found\": \"boolean | Phone enrichment success flag\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"phone_number\": \"string | Phone number (E.164 format when available)\",\n  \"phone_found\": \"boolean | Phone enrichment success flag\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/phone_enrich_batch_v1_agents_phone_post/request/example-output-csv","deepLinkHash":"/batch-agents/phone_enrich_batch_v1_agents_phone_post#batch-agents/phone_enrich_batch_v1_agents_phone_post/request/example-output-csv"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Output CSV"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"id,first_name,last_name,company_name,company_url,linkedin,phone_number,phone_found\n550e8400-e29b-41d4-a716-446655440001,John,Smith,Acme Corp,acme.com,john-smith-123456789,+1-555-123-4567,true\n550e8400-e29b-41d4-a716-446655440002,Jane,Doe,TechCorp,techcorp.com,jane-doe-987654321,,false\n","language":"csv"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"id,first_name,last_name,company_name,company_url,linkedin,phone_number,phone_found\n550e8400-e29b-41d4-a716-446655440001,John,Smith,Acme Corp,acme.com,john-smith-123456789,+1-555-123-4567,true\n550e8400-e29b-41d4-a716-446655440002,Jane,Doe,TechCorp,techcorp.com,jane-doe-987654321,,false\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"schemaId":"components/schemas/PhoneEnrichBatchRequest","pointer":"/paths/~1v1~1agents~1phone/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/agents/phone","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"responseCodes":["202","400","401","402","422","429","500"],"pointer":"/v1/agents/phone","href":"batch-agents/phone_enrich_batch_v1_agents_phone_post","openApiOperationId":"phone_enrich_batch_v1_agents_phone_post","summary":"Phone Enrichment Batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/PhoneEnrichBatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Batch processing started successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example"]}},"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits available","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"}],"pointer":"/paths/~1v1~1agents~1phone/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example"]}}},{"code":"400"},{"code":"401","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"402","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"500","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-agents/phone_enrich_batch_v1_agents_phone_post"}],"panels":[]}]},"httpPath":"/v1/agents/phone"},{"label":"Email Enrichment Batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/batch-agents/email_enrich_batch_v1_agents_email_post","routeSlug":"/openapi/batch-agents/email_enrich_batch_v1_agents_email_post","metadata":{"seo":{"title":"Email Enrichment Batch","description":"Process multiple records for email enrichment in batch mode."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"email_enrich_batch_v1_agents_email_post","name":"Email Enrichment Batch","isWebhook":false,"pointer":"/paths/~1v1~1agents~1email/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Email Enrichment Batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process multiple records for email enrichment in batch mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/overview","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Email Enrichment Batch API allows you to submit multiple person records for email address enrichment processing asynchronously."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key Differences from Sync API:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/enrich/email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process one record at a time, get immediate response with email address"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Submit 1-1000 records, results stored in S3 when complete"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint accepts a batch of records and processes them asynchronously using workflow orchestration, making it ideal for bulk processing operations."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/request-body","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"Choose **one** of the following options:"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Submit IDs for processing:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Array of person IDs to process (1-1000 IDs)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"**Option 2: Submit record objects**\n- `records`: Array of person record objects to process (1-1000 records)\n  - `id`: Unique identifier for the record (required)\n  - `first_name`: Person's first name (optional)\n  - `last_name`: Person's last name (optional)\n  - `company`: Company name (optional)\n  - `company_domain`: Company domain or website URL (optional)\n  - `linkedin`: LinkedIn profile URL or identifier (optional)"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required fields:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Type of entity being processed (must be 'person' for email enrichment) (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits this batch operation is allowed to consume (required)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/response","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for the batch run"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where results will be stored upon completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_csv_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where credit usage report will be stored upon completion"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/credit-usage","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits are consumed based on the number of records processed and the success rate of email address lookups. The batch will stop processing if the credit limit is reached."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/batch-limits","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/batch-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum: 1 record"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum: 1000 records per batch"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records with missing required fields will be skipped"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/examples","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/examples"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Examples"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/example:-submit-ids-for-processing","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/example:-submit-ids-for-processing"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: Submit IDs for processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"ids\": [\"6ba7b810-9dad-11d1-80b4-00c04fd430c8\", \"6ba7b811-9dad-11d1-80b4-00c04fd430c8\", \"6ba7b812-9dad-11d1-80b4-00c04fd430c8\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"ids\": [\"6ba7b810-9dad-11d1-80b4-00c04fd430c8\", \"6ba7b811-9dad-11d1-80b4-00c04fd430c8\", \"6ba7b812-9dad-11d1-80b4-00c04fd430c8\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"comment","attributes":{"content":"### Example 2: Submit record objects\n```json\n{\n  \"records\": [\n    {\n      \"id\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Smith\",\n      \"company\": \"Acme Corp\",\n      \"company_domain\": \"acme.com\",\n      \"linkedin\": \"https://linkedin.com/in/johnsmith\"\n    },\n    {\n      \"id\": \"6ba7b811-9dad-11d1-80b4-00c04fd430c8\",\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"company\": \"TechCorp\"\n    }\n  ],\n  \"entity_type\": \"person\",\n  \"max_credits\": 100\n}\n```"},"children":[]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/output","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/output"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Output"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The results CSV will contain the following columns:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"email\": \"string | Email address\",\n  \"email_found\": \"boolean | Email enrichment success flag\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"email\": \"string | Email address\",\n  \"email_found\": \"boolean | Email enrichment success flag\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/email_enrich_batch_v1_agents_email_post/request/example-output-csv","deepLinkHash":"/batch-agents/email_enrich_batch_v1_agents_email_post#batch-agents/email_enrich_batch_v1_agents_email_post/request/example-output-csv"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Output CSV"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"id,first_name,last_name,company_name,company_url,linkedin,email,email_found\n6ba7b810-9dad-11d1-80b4-00c04fd430c8,John,Smith,Acme Corp,acme.com,john-smith-123456789,john.smith@acme.com,true\n6ba7b811-9dad-11d1-80b4-00c04fd430c8,Jane,Doe,TechCorp,techcorp.com,jane-doe-987654321,,false\n","language":"csv"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"id,first_name,last_name,company_name,company_url,linkedin,email,email_found\n6ba7b810-9dad-11d1-80b4-00c04fd430c8,John,Smith,Acme Corp,acme.com,john-smith-123456789,john.smith@acme.com,true\n6ba7b811-9dad-11d1-80b4-00c04fd430c8,Jane,Doe,TechCorp,techcorp.com,jane-doe-987654321,,false\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailEnrichBatchRequest"}},"schemaId":"components/schemas/EmailEnrichBatchRequest","pointer":"/paths/~1v1~1agents~1email/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/agents/email","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/EmailEnrichBatchRequest"}},"responseCodes":["202","400","401","402","422","429","500"],"pointer":"/v1/agents/email","href":"batch-agents/email_enrich_batch_v1_agents_email_post","openApiOperationId":"email_enrich_batch_v1_agents_email_post","summary":"Email Enrichment Batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/EmailEnrichBatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EmailEnrichBatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Batch processing started successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example"]}},"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits available","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"}],"pointer":"/paths/~1v1~1agents~1email/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example"]}}},{"code":"400"},{"code":"401","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"402","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"500","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-agents/email_enrich_batch_v1_agents_email_post"}],"panels":[]}]},"httpPath":"/v1/agents/email"},{"label":"Deep Research Batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/batch-agents/deep_research_batch_v1_agents_deep_research_post","routeSlug":"/openapi/batch-agents/deep_research_batch_v1_agents_deep_research_post","metadata":{"seo":{"title":"Deep Research Batch","description":"Process multiple records for AI deep research in batch mode."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deep_research_batch_v1_agents_deep_research_post","name":"Deep Research Batch","isWebhook":false,"pointer":"/paths/~1v1~1agents~1deep-research/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deep Research Batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process multiple records for AI deep research in batch mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/overview","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Deep Research Batch API allows you to submit multiple records for AI-powered deep research processing asynchronously."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key Differences from Sync API:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/enrich/research"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process one query at a time, get immediate response with research results"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/deep-research"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Submit 1-1000 IDs, get job ID, comprehensive research results stored in S3 when complete"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint accepts a batch of IDs and processes them asynchronously using specialized research agents and workflow orchestration, making it ideal for large-scale research operations."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/request-body","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Array of IDs to process for deep research (1-1000 IDs) (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query_hint"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Query hint for research context (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Type of entity being processed (company or person) (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"effort"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Effort level for deep research processing (low, medium, high) - defaults to medium"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"agent_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Type of specialized agent to use for deep research (defaults to 'general')"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits this batch operation is allowed to consume (required)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/response","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for the batch run"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where results will be stored upon completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_csv_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where credit usage report will be stored upon completion"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/processing","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/processing"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IDs are converted to CSV format with entity type, agent type, and query hint enrichment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CSV is uploaded to S3 storage"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deep research workflow is triggered for batch processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are stored in the specified S3 location"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/entity-types","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/entity-types"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Entity Types"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported entity types for deep research:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Business organizations and companies"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"person"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Individual contacts and people"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/agent-types","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/agent-types"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agent Types"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Different agent types specialize in different research domains:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"general"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": General purpose research agent (default)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"funding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Research funding opportunities, investors, grants"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"legal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Legal research, compliance, regulatory information"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/credit-usage","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits are consumed based on the effort level, number of records processed, and research complexity. Higher effort levels consume more credits but provide more comprehensive results."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/batch-limits","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/batch-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum: 1 ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum: 1000 IDs per batch"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid or empty IDs will be skipped"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/deep_research_batch_v1_agents_deep_research_post/request/example","deepLinkHash":"/batch-agents/deep_research_batch_v1_agents_deep_research_post#batch-agents/deep_research_batch_v1_agents_deep_research_post/request/example"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"ids\": [\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\", \"a1b2c3d4-e5f6-7890-abcd-ef1234567891\", \"a1b2c3d4-e5f6-7890-abcd-ef1234567892\"],\n  \"query_hint\": \"Research funding opportunities for AI startups\",\n  \"entity_type\": \"company\",\n  \"effort\": \"medium\",\n  \"agent_type\": \"funding\",\n  \"max_credits\": 200\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"ids\": [\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\", \"a1b2c3d4-e5f6-7890-abcd-ef1234567891\", \"a1b2c3d4-e5f6-7890-abcd-ef1234567892\"],\n  \"query_hint\": \"Research funding opportunities for AI startups\",\n  \"entity_type\": \"company\",\n  \"effort\": \"medium\",\n  \"agent_type\": \"funding\",\n  \"max_credits\": 200\n}\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeepResearchBatchRequest"}},"schemaId":"components/schemas/DeepResearchBatchRequest","pointer":"/paths/~1v1~1agents~1deep-research/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/agents/deep-research","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/DeepResearchBatchRequest"}},"responseCodes":["202","400","401","402","422","429","500"],"pointer":"/v1/agents/deep-research","href":"batch-agents/deep_research_batch_v1_agents_deep_research_post","openApiOperationId":"deep_research_batch_v1_agents_deep_research_post","summary":"Deep Research Batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/DeepResearchBatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/DeepResearchBatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Batch processing started successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example"]}},"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits available","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"}],"pointer":"/paths/~1v1~1agents~1deep-research/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example"]}}},{"code":"400"},{"code":"401","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"402","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"500","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-agents/deep_research_batch_v1_agents_deep_research_post"}],"panels":[]}]},"httpPath":"/v1/agents/deep-research"},{"label":"Phone & Email Enrichment Batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post","routeSlug":"/openapi/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post","metadata":{"seo":{"title":"Phone & Email Enrichment Batch","description":"Process multiple records for combined phone and email enrichment in batch mode."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"phone_email_enrich_batch_v1_agents_phone_email_post","name":"Phone & Email Enrichment Batch","isWebhook":false,"pointer":"/paths/~1v1~1agents~1phone-email/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Phone & Email Enrichment Batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Process multiple records for combined phone and email enrichment in batch mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/overview","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Phone & Email Enrichment Batch API allows you to submit multiple person records for both phone number and email address enrichment processing asynchronously in a single operation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key Differences from Individual APIs:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process records for phone enrichment only"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process records for email enrichment only"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone & Email API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/agents/phone-email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): Process records for both phone and email enrichment simultaneously"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint accepts a batch of records and processes them asynchronously using workflow orchestration for both phone and email enrichment, making it ideal for comprehensive contact enrichment operations."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/request-body","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Submit IDs for processing:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Array of person IDs to process (1-1000 IDs)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required fields:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Type of entity being processed (must be 'person' for phone & email enrichment) (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Maximum credits this batch operation is allowed to consume (required)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/response","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique identifier for the batch run"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where results will be stored upon completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_csv_path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": S3 bucket path where credit usage report will be stored upon completion"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/credit-usage","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credits are consumed based on the number of records processed and the success rate of both phone and email lookups. The batch will stop processing if the credit limit is reached."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/batch-limits","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/batch-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Batch Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum: 1 record"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum: 1000 records per batch"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Records with missing required fields will be skipped"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example:-submit-ids-for-processing","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example:-submit-ids-for-processing"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: Submit IDs for processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"ids\": [\"550e8400-e29b-41d4-a716-446655440001\", \"550e8400-e29b-41d4-a716-446655440002\", \"550e8400-e29b-41d4-a716-446655440003\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 200\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"ids\": [\"550e8400-e29b-41d4-a716-446655440001\", \"550e8400-e29b-41d4-a716-446655440002\", \"550e8400-e29b-41d4-a716-446655440003\"],\n  \"entity_type\": \"person\",\n  \"max_credits\": 200\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/output","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/output"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Output"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The results CSV will contain the following columns:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"email\": \"string | Email address\",\n  \"email_found\": \"boolean | Email enrichment success flag\",\n  \"phone_number\": \"string | Phone number (E.164 format when available)\",\n  \"phone_found\": \"boolean | Phone enrichment success flag\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"id\": \"string | Unique record identifier\",\n  \"first_name\": \"string | Person's given name\",\n  \"last_name\": \"string | Person's surname\",\n  \"company_name\": \"string | Organization name\",\n  \"company_url\": \"string | Company website domain\",\n  \"linkedin\": \"string | LinkedIn profile URL or username\",\n  \"email\": \"string | Email address\",\n  \"email_found\": \"boolean | Email enrichment success flag\",\n  \"phone_number\": \"string | Phone number (E.164 format when available)\",\n  \"phone_found\": \"boolean | Phone enrichment success flag\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example-output-csv","deepLinkHash":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post#batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post/request/example-output-csv"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Output CSV"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"company_name,company_url,first_name,id,last_name,linkedin,email,email_found,phone_number,phone_found\nAcme Corp,acme.com,John,550e8400-e29b-41d4-a716-446655440001,Smith,john-smith-123456789,john.smith@acme.com,true,+1-555-123-4567,true\nTechCorp,techcorp.com,Jane,550e8400-e29b-41d4-a716-446655440002,Doe,jane-doe-987654321,,false,,false\nGlobal Solutions,globalsolutions.com,Michael,550e8400-e29b-41d4-a716-446655440003,Johnson,michael-johnson-345678901,michael.johnson@globalsolutions.com,true,,false\n","language":"csv"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"company_name,company_url,first_name,id,last_name,linkedin,email,email_found,phone_number,phone_found\nAcme Corp,acme.com,John,550e8400-e29b-41d4-a716-446655440001,Smith,john-smith-123456789,john.smith@acme.com,true,+1-555-123-4567,true\nTechCorp,techcorp.com,Jane,550e8400-e29b-41d4-a716-446655440002,Doe,jane-doe-987654321,,false,,false\nGlobal Solutions,globalsolutions.com,Michael,550e8400-e29b-41d4-a716-446655440003,Johnson,michael-johnson-345678901,michael.johnson@globalsolutions.com,true,,false\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"schemaId":"components/schemas/PhoneEnrichBatchRequest","pointer":"/paths/~1v1~1agents~1phone-email/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/agents/phone-email","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"responseCodes":["202","400","401","402","422","429","500"],"pointer":"/v1/agents/phone-email","href":"batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post","openApiOperationId":"phone_email_enrich_batch_v1_agents_phone_email_post","summary":"Phone & Email Enrichment Batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/PhoneEnrichBatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PhoneEnrichBatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Batch processing started successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example"]}},"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits available","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}},"schemaId":"components/schemas/BatchErrorResponse"}],"pointer":"/paths/~1v1~1agents~1phone-email/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchResponse","exampleIds":["paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example"]}}},{"code":"400"},{"code":"401","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"402","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}},{"code":"500","schemaId":"components/schemas/BatchErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post"}],"panels":[]}]},"httpPath":"/v1/agents/phone-email"},{"label":"Get Run Status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get","routeSlug":"/openapi/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get","metadata":{"seo":{"title":"Get Run Status","description":"Retrieve the current status of a run by its ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_workflow_run_status_v1_agents_runs__run_id__status_get","name":"Get Run Status","isWebhook":false,"pointer":"/paths/~1v1~1agents~1runs~1{run_id}~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Run Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve the current status of a run by its ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/overview","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint allows you to quickly check the status of a run without retrieving all the detailed information."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/path-parameters","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/path-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Path Parameters"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The unique identifier of the batch run (UUID format)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/response","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the run ID and its current status."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/examples","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/examples"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Examples"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/example-response","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/example-response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"run_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"status\": \"completed\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"run_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"status\": \"completed\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/possible-status-values","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/possible-status-values"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Possible Status Values"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The run is queued"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The run has completed successfully"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The run has failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/http-status-codes","deepLinkHash":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get#batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get/request/http-status-codes"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTP Status Codes"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Meaning"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"200 OK"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Run status retrieved successfully"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid run ID format"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"404 Not Found"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Run not found"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500 Internal Server Error"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Server error occurred while retrieving status"},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"run_id","in":"path","schemaId":"schema_26","required":true}],"pointer":"/paths/~1v1~1agents~1runs~1{run_id}~1status/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/agents/runs/{run_id}/status","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[{"name":"run_id","in":"path","required":true,"schemaId":"schema_26"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"responseCodes":["200","400","401","404","422","500"],"pointer":"/v1/agents/runs/{run_id}/status","href":"batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get","openApiOperationId":"get_workflow_run_status_v1_agents_runs__run_id__status_get","summary":"Get Run Status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Run status retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunStatusResponse","exampleIds":["paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/RunStatusResponse","exampleIds":["paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Invalid run ID format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}},"schemaId":"components/schemas/RunErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}},"schemaId":"components/schemas/RunErrorResponse"},{"code":"404","description":"Run not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}},"schemaId":"components/schemas/RunErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}},"schemaId":"components/schemas/RunErrorResponse"}],"pointer":"/paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/RunStatusResponse","exampleIds":["paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunStatusResponse","exampleIds":["paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/RunErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}}},{"code":"401","schemaId":"components/schemas/RunErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}}},{"code":"404","schemaId":"components/schemas/RunErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"500","schemaId":"components/schemas/RunErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RunErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get"}],"panels":[]}]},"httpPath":"/v1/agents/runs/{run_id}/status"}],"content":{"contentType":"group","meta":{"name":"Batch Agents"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Batch Agents","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/agents/phone","summary":"Phone Enrichment Batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/batch-agents/phone_enrich_batch_v1_agents_phone_post","deprecated":false},{"title":"/v1/agents/email","summary":"Email Enrichment Batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/batch-agents/email_enrich_batch_v1_agents_email_post","deprecated":false},{"title":"/v1/agents/deep-research","summary":"Deep Research Batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/batch-agents/deep_research_batch_v1_agents_deep_research_post","deprecated":false},{"title":"/v1/agents/phone-email","summary":"Phone & Email Enrichment Batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/batch-agents/phone_email_enrich_batch_v1_agents_phone_email_post","deprecated":false},{"title":"/v1/agents/runs/{run_id}/status","summary":"Get Run Status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/batch-agents/get_workflow_run_status_v1_agents_runs__run_id__status_get","deprecated":false}]}]}]}]}},{"type":"group","label":"Credits","link":"/openapi/credits","routeSlug":"/openapi/credits","items":[{"label":"Get Credit Usage","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/credits/get_credit_usage_v1_credits_usage_get","routeSlug":"/openapi/credits/get_credit_usage_v1_credits_usage_get","metadata":{"seo":{"title":"Get Credit Usage","description":"Get credit usage for a tenant within a specified date range."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_credit_usage_v1_credits_usage_get","name":"Get Credit Usage","isWebhook":false,"pointer":"/paths/~1v1~1credits~1usage/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Credit Usage","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get credit usage for a tenant within a specified date range."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/overview","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint retrieves credit usage information for a tenant within a specified date range. It supports optional filtering by workflow ID, workflow run ID, and custom key-value pairs."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/query-parameters","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/query-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query Parameters"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Start date for the calculation period (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": End date for the calculation period (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"workflow_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional workflow ID for filtering results"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"workflow_run_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional workflow run ID for filtering results"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional custom key for filtering results"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional custom value for filtering results"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/response-fields","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tenant_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The tenant ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the start date"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Echo of the end date"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_used"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Total credits used in the specified period"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/authentication","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint requires authentication via Bearer token. The tenant ID is automatically extracted from the authenticated user's token."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/example-request","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/example-request"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Request"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/credits/usage?start_date=2024-01-01T00:00:00Z&end_date=2024-12-31T23:59:59Z&workflow_id=workflow-123\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/credits/usage?start_date=2024-01-01T00:00:00Z&end_date=2024-12-31T23:59:59Z&workflow_id=workflow-123\n"},"children":[]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_credit_usage_v1_credits_usage_get/request/example-response","deepLinkHash":"/credits/get_credit_usage_v1_credits_usage_get#credits/get_credit_usage_v1_credits_usage_get/request/example-response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"success\": true,\n  \"tenant_id\": 123,\n  \"start_date\": \"2024-01-01T00:00:00Z\",\n  \"end_date\": \"2024-12-31T23:59:59Z\",\n  \"credits_used\": 1250.5\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"success\": true,\n  \"tenant_id\": 123,\n  \"start_date\": \"2024-01-01T00:00:00Z\",\n  \"end_date\": \"2024-12-31T23:59:59Z\",\n  \"credits_used\": 1250.5\n}\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"start_date","in":"query","schemaId":"schema_27","description":"Start date for credit calculation","required":true},{"name":"end_date","in":"query","schemaId":"schema_28","description":"End date for credit calculation","required":true},{"name":"workflow_id","in":"query","schemaId":"schema_29","description":"Optional workflow ID for filtering"},{"name":"workflow_run_id","in":"query","schemaId":"schema_30","description":"Optional workflow run ID for filtering"},{"name":"custom_key","in":"query","schemaId":"schema_31","description":"Optional custom key for filtering"},{"name":"custom_value","in":"query","schemaId":"schema_32","description":"Optional custom value for filtering"}],"pointer":"/paths/~1v1~1credits~1usage/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/credits/usage","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[{"name":"start_date","in":"query","required":true,"schemaId":"schema_27"},{"name":"end_date","in":"query","required":true,"schemaId":"schema_28"},{"name":"workflow_id","in":"query","required":false,"schemaId":"schema_29"},{"name":"workflow_run_id","in":"query","required":false,"schemaId":"schema_30"},{"name":"custom_key","in":"query","required":false,"schemaId":"schema_31"},{"name":"custom_value","in":"query","required":false,"schemaId":"schema_32"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"responseCodes":["200","400","401","422","429","500"],"pointer":"/v1/credits/usage","href":"credits/get_credit_usage_v1_credits_usage_get","openApiOperationId":"get_credit_usage_v1_credits_usage_get","summary":"Get Credit Usage"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreditUsageResponse","exampleIds":["paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/CreditUsageResponse","exampleIds":["paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}],"pointer":"/paths/~1v1~1credits~1usage/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CreditUsageResponse","exampleIds":["paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreditUsageResponse","exampleIds":["paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/credits/get_credit_usage_v1_credits_usage_get"}],"panels":[]}]},"httpPath":"/v1/credits/usage"},{"label":"Get Remaining Credits","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/credits/get_remaining_credits_v1_credits_remaining_get","routeSlug":"/openapi/credits/get_remaining_credits_v1_credits_remaining_get","metadata":{"seo":{"title":"Get Remaining Credits","description":"Get the current remaining credits for a tenant."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_remaining_credits_v1_credits_remaining_get","name":"Get Remaining Credits","isWebhook":false,"pointer":"/paths/~1v1~1credits~1remaining/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Remaining Credits","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the current remaining credits for a tenant."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_remaining_credits_v1_credits_remaining_get/request/overview","deepLinkHash":"/credits/get_remaining_credits_v1_credits_remaining_get#credits/get_remaining_credits_v1_credits_remaining_get/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint retrieves the current remaining credits available for the authenticated tenant."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_remaining_credits_v1_credits_remaining_get/request/response-fields","deepLinkHash":"/credits/get_remaining_credits_v1_credits_remaining_get#credits/get_remaining_credits_v1_credits_remaining_get/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tenant_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The tenant ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remaining_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Current remaining credits for the tenant"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_credits"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Total credits for the tenant"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_remaining_credits_v1_credits_remaining_get/request/authentication","deepLinkHash":"/credits/get_remaining_credits_v1_credits_remaining_get#credits/get_remaining_credits_v1_credits_remaining_get/request/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint requires authentication via Bearer token. The tenant ID is automatically extracted from the authenticated user's token."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"credits/get_remaining_credits_v1_credits_remaining_get/request/example-response","deepLinkHash":"/credits/get_remaining_credits_v1_credits_remaining_get#credits/get_remaining_credits_v1_credits_remaining_get/request/example-response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n  \"success\": true,\n  \"tenant_id\": 123,\n  \"remaining_credits\": 4750.25\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n  \"success\": true,\n  \"tenant_id\": 123,\n  \"remaining_credits\": 4750.25\n}\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/credits/remaining","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"responseCodes":["200","401","429","500"],"pointer":"/v1/credits/remaining","href":"credits/get_remaining_credits_v1_credits_remaining_get","openApiOperationId":"get_remaining_credits_v1_credits_remaining_get","summary":"Get Remaining Credits"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RemainingCreditsResponse","exampleIds":["paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/RemainingCreditsResponse","exampleIds":["paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example"]},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}},"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}],"pointer":"/paths/~1v1~1credits~1remaining/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/RemainingCreditsResponse","exampleIds":["paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RemainingCreditsResponse","exampleIds":["paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}},{"code":"429","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}},{"code":"500","schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/api_gateway__models__credits__ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/credits/get_remaining_credits_v1_credits_remaining_get"}],"panels":[]}]},"httpPath":"/v1/credits/remaining"}],"content":{"contentType":"group","meta":{"name":"Credits"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Credits","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/credits/usage","summary":"Get Credit Usage","prefix":{"name":"get","color":"get"},"badges":[],"link":"/credits/get_credit_usage_v1_credits_usage_get","deprecated":false},{"title":"/v1/credits/remaining","summary":"Get Remaining Credits","prefix":{"name":"get","color":"get"},"badges":[],"link":"/credits/get_remaining_credits_v1_credits_remaining_get","deprecated":false}]}]}]}]}},{"type":"group","label":"Forms","link":"/openapi/forms","routeSlug":"/openapi/forms","items":[{"label":"Submit Form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/forms/submit_form_v1_forms_submit_post","routeSlug":"/openapi/forms/submit_form_v1_forms_submit_post","metadata":{"seo":{"title":"Submit Form","description":"Accepts form submissions and immediately enriches and dispositions the data."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"submit_form_v1_forms_submit_post","name":"Submit Form","isWebhook":false,"pointer":"/paths/~1v1~1forms~1submit/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Submit Form","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts form submissions and immediately enriches and dispositions the data."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/overview","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Form Submit API is designed to accept form submissions directly from marketing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"automation platforms or websites. It provides immediate enrichment and disposition of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"submitted data with two possible outcomes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return enriched lead data in the response"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Push the enriched lead to Salesforce or Marketing Automation (MA) tool"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/authentication","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requires an API key configured per site or system."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/rate-limits","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/rate-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Designed for near-real-time processing (less than 5 seconds end-to-end) and supports"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high-volume campaign bursts."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/request-body","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Contact email address (validated)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"company"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Company name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Phone number (validated)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job title"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"additional_fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Additional form fields as key-value pairs"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"form_source"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Source of form submission"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enrichment_preferences"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enrichment preferences and configuration"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"output_preferences"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Output preferences (return data vs push to external system)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/response-fields","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing status (enriched, pushed, failed)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique request ID for tracking"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enriched_lead"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enriched lead data (if requested)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"push_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Status of push to external system (if applicable)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"gdpr_safe"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether enrichment was GDPR compliant"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/features","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/features"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Features"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Input Validation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Email and phone number validation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"GDPR Compliance"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Safe enrichment practices"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Real-time Processing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Sub-5 second end-to-end processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High Volume Support"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optimized for campaign bursts"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flexible Output"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Return enriched data or push to external systems"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Trail"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Complete logging for compliance"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"forms/submit_form_v1_forms_submit_post/request/credit-usage","deepLinkHash":"/forms/submit_form_v1_forms_submit_post#forms/submit_form_v1_forms_submit_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Form submissions consume credits based on processing:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic Submission"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 2 credits per form"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +3 credits for enrichment processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Push"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +1 credit for external system push"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FormSubmitRequest"}},"schemaId":"components/schemas/FormSubmitRequest","pointer":"/paths/~1v1~1forms~1submit/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/forms/submit","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/FormSubmitRequest"}},"responseCodes":["200","400","401","402","409","422","429","500"],"pointer":"/v1/forms/submit","href":"forms/submit_form_v1_forms_submit_post","openApiOperationId":"submit_form_v1_forms_submit_post","summary":"Submit Form"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/FormSubmitRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FormSubmitRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormSubmitResponse","exampleIds":["paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/FormSubmitResponse","exampleIds":["paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters or validation errors","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"},{"code":"409","description":"Conflict - Duplicate form submission detected","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}},"schemaId":"components/schemas/FormErrorResponse"}],"pointer":"/paths/~1v1~1forms~1submit/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FormSubmitResponse","exampleIds":["paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormSubmitResponse","exampleIds":["paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}},{"code":"401","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}},{"code":"402","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}},{"code":"409","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}},{"code":"500","schemaId":"components/schemas/FormErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FormErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/forms/submit_form_v1_forms_submit_post"}],"panels":[]}]},"httpPath":"/v1/forms/submit"}],"content":{"contentType":"group","meta":{"name":"Forms"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Forms","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/forms/submit","summary":"Submit Form","prefix":{"name":"post","color":"post"},"badges":[],"link":"/forms/submit_form_v1_forms_submit_post","deprecated":false}]}]}]}]}},{"type":"group","label":"Workflows","link":"/openapi/workflows","routeSlug":"/openapi/workflows","items":[{"label":"Trigger Workflow","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post","routeSlug":"/openapi/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post","metadata":{"seo":{"title":"Trigger Workflow","description":"Triggers enrichment and routing workflows from external systems."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"trigger_workflow_v1_workflows__workflow_id__trigger_post","name":"Trigger Workflow","isWebhook":false,"pointer":"/paths/~1v1~1workflows~1{workflow_id}~1trigger/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Trigger Workflow","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Triggers enrichment and routing workflows from external systems."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/overview","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Workflow Trigger API provides a generic interface for initiating enrichment and routing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"workflows from various external systems like Eloqua, Customer Data Platforms (CDP), Data Lakes,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and other marketing automation platforms."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/authentication","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requires either an API key or OAuth2 bearer token in the Authorization header."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/rate-limits","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/rate-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Designed to support bursty event traffic, capable of handling hundreds of requests per minute."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/request-body","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request Body"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Generic record payload containing fields for Lead, Contact, Opportunity, or other custom objects"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_system"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional source system identifier (e.g., 'eloqua', 'cdp', 'data_lake')"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enrichment_preferences"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optional enrichment preferences and configuration"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/response-fields","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/response-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Boolean indicating request success"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Workflow status (triggered, queued, failed)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Unique request ID for tracking"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"workflow_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ID of the triggered workflow"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing_time_ms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Processing time in milliseconds"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enrichment_job_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ID of enrichment job created (if applicable)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_consumed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of credits used"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"credits_remaining"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (approximate balance; use GET /v1/credits/remaining for precise value)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cached"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Whether result was from cache"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/features","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/features"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Features"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generic Payload"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Accepts any record type (Lead, Contact, Opportunity, custom objects)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Audit Logging"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": All requests and responses are logged for compliance"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retry Logic"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Automatic retries on failure with exponential backoff"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High Throughput"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Optimized for bursty event traffic"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Tracking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Transparent credit consumption tracking"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/credit-usage","deepLinkHash":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post#workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post/request/credit-usage"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit Usage"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workflow triggers consume credits based on complexity:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic Trigger"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 1 credit per record"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Enrichment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +2 credits for enrichment processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With Routing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": +1 credit for routing logic"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"ApiToken"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"workflow_id","in":"path","schemaId":"schema_33","required":true}],"pointer":"/paths/~1v1~1workflows~1{workflow_id}~1trigger/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WorkflowTriggerRequest"}},"schemaId":"components/schemas/WorkflowTriggerRequest","pointer":"/paths/~1v1~1workflows~1{workflow_id}~1trigger/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/workflows/{workflow_id}/trigger","servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"parameters":{"path":[{"name":"workflow_id","in":"path","required":true,"schemaId":"schema_33"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/WorkflowTriggerRequest"}},"responseCodes":["200","400","401","402","409","422","429","500"],"pointer":"/v1/workflows/{workflow_id}/trigger","href":"workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post","openApiOperationId":"trigger_workflow_v1_workflows__workflow_id__trigger_post","summary":"Trigger Workflow"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}],"schemaId":"components/schemas/WorkflowTriggerRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WorkflowTriggerRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success Response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowTriggerResponse","exampleIds":["paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/WorkflowTriggerResponse","exampleIds":["paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid input parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"},{"code":"401","description":"Unauthorized - Invalid or missing API key","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"},{"code":"402","description":"Insufficient Credits - Not enough credits to complete request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"},{"code":"409","description":"Conflict - Duplicate workflow trigger detected","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"},{"code":"422","description":"Validation Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"},{"code":"429","description":"Rate Limited - Too many requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"},{"code":"500","description":"Internal Server Error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}},"schemaId":"components/schemas/WorkflowErrorResponse"}],"pointer":"/paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WorkflowTriggerResponse","exampleIds":["paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowTriggerResponse","exampleIds":["paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}},{"code":"401","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}},{"code":"402","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}},{"code":"409","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}},{"code":"429","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}},{"code":"500","schemaId":"components/schemas/WorkflowErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WorkflowErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post"}],"panels":[]}]},"httpPath":"/v1/workflows/{workflow_id}/trigger"}],"content":{"contentType":"group","meta":{"name":"Workflows"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Workflows","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/workflows/{workflow_id}/trigger","summary":"Trigger Workflow","prefix":{"name":"post","color":"post"},"badges":[],"link":"/workflows/trigger_workflow_v1_workflows__workflow_id__trigger_post","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/AIEnrichmentOptions":{"id":"components/schemas/AIEnrichmentOptions","kind":"json-schema","title":"AIEnrichmentOptions","data":{"properties":{"format_json":{"type":"boolean","title":"Format Json","description":"Whether to return response in structured JSON format","default":false}},"type":"object","title":"AIEnrichmentOptions","description":"Options for AI enrichment request."}},"components/schemas/AIEnrichmentRequest":{"id":"components/schemas/AIEnrichmentRequest","kind":"json-schema","title":"AIEnrichmentRequest","data":{"properties":{"query":{"type":"string","maxLength":8000,"title":"Query","description":"The main prompt or question to send to the AI model"},"options":{"anyOf":[{"$ref":"#/components/schemas/AIEnrichmentOptions"},{"type":"null"}],"description":"Additional configuration options"},"effort":{"$ref":"#/components/schemas/EnrichmentEffortType","description":"Enrichment effort type","default":"low","examples":["low","medium","high"]},"agent_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Type","description":"Type of specialized agent to use for processing","examples":["funding","legal"]}},"type":"object","required":["query"],"title":"AIEnrichmentRequest","description":"Request model for AI enrichment."}},"components/schemas/AIEnrichmentResponse":{"id":"components/schemas/AIEnrichmentResponse","kind":"json-schema","title":"AIEnrichmentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"query":{"type":"string","title":"Query","description":"Echo of the input query"},"response":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}],"title":"Response","description":"AI-generated response"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"AI confidence score (0.0-1.0) or null if disabled"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"token_usage":{"$ref":"#/components/schemas/TokenUsage","description":"Token consumption details"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"agent_used":{"type":"string","title":"Agent Used","description":"Type of agent that was used for processing"}},"type":"object","required":["success","query","response","credits_consumed","token_usage","processing_time_ms","agent_used"],"title":"AIEnrichmentResponse","description":"Response model for AI enrichment."}},"components/schemas/AgentType":{"id":"components/schemas/AgentType","kind":"json-schema","title":"AgentType","data":{"type":"string","enum":["funding","legal","general"],"title":"AgentType"}},"components/schemas/AssignRequest":{"id":"components/schemas/AssignRequest","kind":"json-schema","title":"AssignRequest","data":{"properties":{"object":{"type":"string","enum":["lead","contact","opportunity","account"],"title":"Object","description":"Salesforce object type to assign"},"sf_id":{"type":"string","title":"Sf Id","description":"Salesforce ID of the object to assign"},"pool":{"type":"string","title":"Pool","description":"Round-robin pool identifier"},"exclude_inactive":{"type":"boolean","title":"Exclude Inactive","description":"Whether to exclude inactive users from assignment","default":true},"reset_rules":{"anyOf":[{"$ref":"#/components/schemas/ResetRules"},{"type":"null"}],"description":"Optional reset rules for the assignment"}},"type":"object","required":["object","sf_id","pool"],"title":"AssignRequest","description":"Request model for round-robin assignment."}},"components/schemas/AssignResponse":{"id":"components/schemas/AssignResponse","kind":"json-schema","title":"AssignResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"assigned_to":{"type":"string","title":"Assigned To","description":"User ID that was assigned"},"sequence":{"type":"integer","title":"Sequence","description":"Current sequence number in the rotation"},"pool_size":{"type":"integer","title":"Pool Size","description":"Total number of active users in the pool"},"timestamp":{"type":"string","title":"Timestamp","description":"ISO timestamp of the assignment"}},"type":"object","required":["success","assigned_to","sequence","pool_size","timestamp"],"title":"AssignResponse","description":"Response model for round-robin assignment."}},"components/schemas/BatchErrorResponse":{"id":"components/schemas/BatchErrorResponse","kind":"json-schema","title":"BatchErrorResponse","data":{"properties":{"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"credits_required":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Required","description":"Credits required for insufficient credit errors"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Credits remaining for insufficient credit errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"BatchErrorResponse","description":"Error response model for batch operations."}},"components/schemas/BatchResponse":{"id":"components/schemas/BatchResponse","kind":"json-schema","title":"BatchResponse","data":{"properties":{"run_id":{"type":"string","title":"Run Id","description":"Unique identifier for the batch run"},"result_path":{"type":"string","title":"Result Path","description":"S3 bucket path where results will be stored"},"credits_csv_path":{"type":"string","title":"Credits Csv Path","description":"S3 bucket path where credit usage report will be stored"}},"type":"object","required":["run_id","result_path","credits_csv_path"],"title":"BatchResponse","description":"Response model for batch operations."}},"components/schemas/CompanyEnrichmentData":{"id":"components/schemas/CompanyEnrichmentData","kind":"json-schema","title":"CompanyEnrichmentData","data":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Company name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","description":"LinkedIn company page URL"},"hq":{"anyOf":[{"$ref":"#/components/schemas/CompanyLocation"},{"type":"null"}],"description":"Headquarters location"},"size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size Range","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Employee size range (e.g., '500+')"},"children":[]}]}]}]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","description":"Industry classification"},"geo":{"anyOf":[{"$ref":"#/components/schemas/CompanyGeo"},{"type":"null"}],"description":"Geographic coordinates and location details"},"last_verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Verified At","description":"ISO timestamp of last verification"}},"type":"object","title":"CompanyEnrichmentData","description":"Company enrichment data response."}},"components/schemas/CompanyEnrichmentRequest":{"id":"components/schemas/CompanyEnrichmentRequest","kind":"json-schema","title":"CompanyEnrichmentRequest","data":{"properties":{"record_id":{"type":"string","title":"Record Id","description":"Unique identifier for this enrichment request"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country code or name"},"external_ids":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"External Ids","description":"External system IDs (e.g., Salesforce account ID)"},"effort":{"$ref":"#/components/schemas/EnrichmentEffortType","description":"Enrichment effort type","default":"low","examples":["low","medium","high"]},"max_credits":{"type":"integer","maximum":100,"minimum":1,"title":"Max Credits","description":"Maximum credits to spend on this request","default":1}},"type":"object","required":["record_id"],"title":"CompanyEnrichmentRequest","description":"Request model for company enrichment."}},"components/schemas/CompanyEnrichmentResponse":{"id":"components/schemas/CompanyEnrichmentResponse","kind":"json-schema","title":"CompanyEnrichmentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"record_id":{"type":"string","title":"Record Id","description":"Unique identifier for this enrichment request"},"company":{"anyOf":[{"$ref":"#/components/schemas/CompanyEnrichmentData"},{"type":"null"}],"description":"Enriched company data"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"Confidence score (0.0-1.0) or null if disabled/not found"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache"}},"type":"object","required":["success","record_id","credits_consumed","processing_time_ms","cached"],"title":"CompanyEnrichmentResponse","description":"Response model for company enrichment."}},"components/schemas/CompanyGeo":{"id":"components/schemas/CompanyGeo","kind":"json-schema","title":"CompanyGeo","data":{"properties":{"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat","description":"Latitude coordinate"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon","description":"Longitude coordinate"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County","description":"County or administrative division"}},"type":"object","title":"CompanyGeo","description":"Geographic coordinates and location details."}},"components/schemas/CompanyLocation":{"id":"components/schemas/CompanyLocation","kind":"json-schema","title":"CompanyLocation","data":{"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","description":"State or province"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country code or name"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal or ZIP code"}},"type":"object","title":"CompanyLocation","description":"Company headquarters location information."}},"components/schemas/ConversionLogs":{"id":"components/schemas/ConversionLogs","kind":"json-schema","title":"ConversionLogs","data":{"properties":{"route_log":{"type":"boolean","title":"Route Log","description":"Whether to log routing information","default":true},"enrichment_diff":{"type":"boolean","title":"Enrichment Diff","description":"Whether to log enrichment differences","default":true}},"type":"object","title":"ConversionLogs","description":"Logging configuration for conversion."}},"components/schemas/ConversionMatchPolicy":{"id":"components/schemas/ConversionMatchPolicy","kind":"json-schema","title":"ConversionMatchPolicy","data":{"properties":{"contact":{"$ref":"#/components/schemas/MatchPolicy","description":"Contact matching policy"},"account":{"$ref":"#/components/schemas/MatchPolicy","description":"Account matching policy"}},"type":"object","required":["contact","account"],"title":"ConversionMatchPolicy","description":"Match policy configuration for conversion."}},"components/schemas/ConvertRequest":{"id":"components/schemas/ConvertRequest","kind":"json-schema","title":"ConvertRequest","data":{"properties":{"lead_sf_id":{"type":"string","title":"Lead Sf Id","description":"Salesforce Lead ID to convert"},"match_policy":{"$ref":"#/components/schemas/ConversionMatchPolicy","description":"Match policy configuration"},"merge_policy":{"$ref":"#/components/schemas/MergePolicy","description":"Merge policy configuration"},"set_owner_round_robin_pool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Owner Round Robin Pool","description":"Round-robin pool for owner assignment"},"logs":{"$ref":"#/components/schemas/ConversionLogs","description":"Logging configuration"}},"type":"object","required":["lead_sf_id","match_policy","merge_policy"],"title":"ConvertRequest","description":"Request model for Salesforce lead conversion."}},"components/schemas/ConvertResponse":{"id":"components/schemas/ConvertResponse","kind":"json-schema","title":"ConvertResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"status":{"type":"string","enum":["converted","failed","duplicate"],"title":"Status","description":"Conversion status"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Created or matched Account ID"},"contact_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Id","description":"Created or matched Contact ID"},"owner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Id","description":"Assigned Owner ID"},"actions":{"items":{"type":"string"},"type":"array","title":"Actions","description":"List of actions performed during conversion"}},"type":"object","required":["success","status","actions"],"title":"ConvertResponse","description":"Response model for Salesforce lead conversion."}},"components/schemas/CreditUsageResponse":{"id":"components/schemas/CreditUsageResponse","kind":"json-schema","title":"CreditUsageResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"tenant_id":{"type":"integer","title":"Tenant Id","description":"Tenant ID"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date for credit calculation"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date for credit calculation"},"credits_used":{"type":"number","title":"Credits Used","description":"Total credits used in the period"}},"type":"object","required":["success","tenant_id","start_date","end_date","credits_used"],"title":"CreditUsageResponse","description":"Response model for credit usage."}},"components/schemas/DeepResearchBatchRequest":{"id":"components/schemas/DeepResearchBatchRequest","kind":"json-schema","title":"DeepResearchBatchRequest","data":{"properties":{"ids":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Ids","description":"List of IDs to process for deep research"},"query_hint":{"type":"string","title":"Query Hint","description":"Query hint for research context (optional)","default":""},"entity_type":{"$ref":"#/components/schemas/EntityType","description":"Type of entity being processed (company or person)"},"effort":{"$ref":"#/components/schemas/EnrichmentEffortType","description":"Effort level for deep research processing","default":"medium"},"agent_type":{"$ref":"#/components/schemas/AgentType","description":"Type of specialized agent to use for deep research (defaults to 'general')","default":"general"},"max_credits":{"type":"integer","exclusiveMinimum":0,"title":"Max Credits","description":"Maximum credits this request is allowed to consume"}},"type":"object","required":["ids","entity_type","max_credits"],"title":"DeepResearchBatchRequest","description":"Request model for deep research batch operations."}},"components/schemas/DeepResearchOptions":{"id":"components/schemas/DeepResearchOptions","kind":"json-schema","title":"DeepResearchOptions","data":{"properties":{"format_json":{"type":"boolean","title":"Format Json","description":"Whether to format the response as JSON","default":false}},"type":"object","title":"DeepResearchOptions","description":"Options for deep research requests."}},"components/schemas/DeepResearchRequest":{"id":"components/schemas/DeepResearchRequest","kind":"json-schema","title":"DeepResearchRequest","data":{"properties":{"query":{"type":"string","maxLength":8000,"title":"Query","description":"The research question or topic to investigate deeply","examples":["Research the latest developments in renewable energy storage technology","Analyze the competitive landscape for AI-powered customer service platforms","What are the emerging trends in sustainable agriculture practices?"]},"options":{"anyOf":[{"$ref":"#/components/schemas/DeepResearchOptions"},{"type":"null"}],"description":"Additional options for the deep research"},"agent_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Type","description":"Type of specialized agent to use for processing","examples":["funding","legal"]}},"type":"object","required":["query"],"title":"DeepResearchRequest","description":"Request model for deep research LLM calls."}},"components/schemas/DeepResearchResponse":{"id":"components/schemas/DeepResearchResponse","kind":"json-schema","title":"DeepResearchResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"query":{"type":"string","title":"Query","description":"Echo of the input query"},"response":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}],"title":"Response","description":"Deep research response with comprehensive analysis"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"AI confidence score (0.0-1.0) or null if disabled"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"token_usage":{"$ref":"#/components/schemas/TokenUsage","description":"Token consumption details"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"agent_used":{"type":"string","title":"Agent Used","description":"Type of agent that was used for processing"}},"type":"object","required":["success","query","response","credits_consumed","token_usage","processing_time_ms","agent_used"],"title":"DeepResearchResponse","description":"Response model for deep research."}},"components/schemas/EmailEnrichBatchRequest":{"id":"components/schemas/EmailEnrichBatchRequest","kind":"json-schema","title":"EmailEnrichBatchRequest","data":{"properties":{"ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1},{"type":"null"}],"title":"Ids","description":"List of IDs to process for email enrichment"},"records":{"anyOf":[{"items":{"$ref":"#/components/schemas/EmailEnrichmentRecord"},"type":"array","maxItems":1000,"minItems":1},{"type":"null"}],"title":"Records","description":"List of record objects to process for email enrichment"},"entity_type":{"type":"string","const":"person","title":"Entity Type","description":"Type of entity being processed (must be 'person' for email enrichment)","default":"person"},"max_credits":{"type":"integer","exclusiveMinimum":0,"title":"Max Credits","description":"Maximum credits this request is allowed to consume"}},"type":"object","required":["max_credits"],"title":"EmailEnrichBatchRequest","description":"Request model for email enrichment batch operations.","examples":[{"entity_type":"person","ids":["6ba7b810-9dad-11d1-80b4-00c04fd430c8","6ba7b811-9dad-11d1-80b4-00c04fd430c8","6ba7b812-9dad-11d1-80b4-00c04fd430c8"],"max_credits":100}]}},"components/schemas/EmailEnrichmentRecord":{"id":"components/schemas/EmailEnrichmentRecord","kind":"json-schema","title":"EmailEnrichmentRecord","data":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the record"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"Person's first name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Person's last name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Company name or website URL"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain","description":"Company domain"},"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin","description":"LinkedIn profile URL or identifier"}},"type":"object","required":["id"],"title":"EmailEnrichmentRecord","description":"Record model for email enrichment batch operations."}},"components/schemas/EmailEnrichmentRequest":{"id":"components/schemas/EmailEnrichmentRequest","kind":"json-schema","title":"EmailEnrichmentRequest","data":{"properties":{"record_id":{"type":"string","title":"Record Id","description":"Your unique identifier for this record"},"first_name":{"type":"string","title":"First Name","description":"Contact's first name"},"last_name":{"type":"string","title":"Last Name","description":"Contact's last name"},"company":{"type":"string","title":"Company","description":"Company name or website URL where the contact works"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain","description":"Company domain (optional)"},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"LinkedIn profile identifier/slug (e.g., 'john-doe-123456')","examples":["john-doe-123456","jane-smith-789"]},"max_credits":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Max Credits","description":"Maximum credits to spend on this request"}},"type":"object","required":["record_id","first_name","last_name","company"],"title":"EmailEnrichmentRequest","description":"Request model for email enrichment."}},"components/schemas/EmailEnrichmentResponse":{"id":"components/schemas/EmailEnrichmentResponse","kind":"json-schema","title":"EmailEnrichmentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"record_id":{"type":"string","title":"Record Id","description":"Echo of the input record ID"},"first_name":{"type":"string","title":"First Name","description":"Echo of input first name"},"last_name":{"type":"string","title":"Last Name","description":"Echo of input last name"},"company":{"type":"string","title":"Company","description":"Echo of input company"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Professional email address or null if not found"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"Confidence score (0.0-1.0) or null if disabled/not found"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache"}},"type":"object","required":["success","record_id","first_name","last_name","company","credits_consumed","processing_time_ms","cached"],"title":"EmailEnrichmentResponse","description":"Response model for email enrichment."}},"components/schemas/EmailStatus":{"id":"components/schemas/EmailStatus","kind":"json-schema","title":"EmailStatus","data":{"type":"string","enum":["valid","accept_all","risky","invalid","unknown"],"title":"EmailStatus"}},"components/schemas/EnrichmentEffortType":{"id":"components/schemas/EnrichmentEffortType","kind":"json-schema","title":"EnrichmentEffortType","data":{"type":"string","enum":["low","medium","high"],"title":"EnrichmentEffortType"}},"components/schemas/EntityType":{"id":"components/schemas/EntityType","kind":"json-schema","title":"EntityType","data":{"type":"string","enum":["person","company"],"title":"EntityType"}},"components/schemas/FormErrorResponse":{"id":"components/schemas/FormErrorResponse","kind":"json-schema","title":"FormErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"validation_errors":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Validation Errors","description":"Field-specific validation errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"FormErrorResponse","description":"Error response model for Form Submit API."}},"components/schemas/FormSubmitRequest":{"id":"components/schemas/FormSubmitRequest","kind":"json-schema","title":"FormSubmitRequest","data":{"properties":{"form_name":{"type":"string","title":"Form Name","description":"Name of the form"},"form_payload":{"additionalProperties":true,"type":"object","title":"Form Payload","description":"Payload of the form"}},"type":"object","required":["form_name","form_payload"],"title":"FormSubmitRequest","description":"Request model for Form Submit API."}},"components/schemas/FormSubmitResponse":{"id":"components/schemas/FormSubmitResponse","kind":"json-schema","title":"FormSubmitResponse","data":{"properties":{"tenant_id":{"type":"integer","title":"Tenant Id","description":"Tenant ID"},"submission_id":{"type":"string","format":"uuid","title":"Submission Id","description":"Submission ID"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At","description":"Submission timestamp"},"form_name":{"type":"string","title":"Form Name","description":"Name of the form"},"form_payload":{"additionalProperties":true,"type":"object","title":"Form Payload","description":"Payload of the form"}},"type":"object","required":["tenant_id","submission_id","submitted_at","form_name","form_payload"],"title":"FormSubmitResponse","description":"Response model for Form Submit API."}},"components/schemas/HTTPValidationError":{"id":"components/schemas/HTTPValidationError","kind":"json-schema","title":"HTTPValidationError","data":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}},"components/schemas/MatchCandidate":{"id":"components/schemas/MatchCandidate","kind":"json-schema","title":"MatchCandidate","data":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain"},"billing_street":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Street","description":"Billing street address"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","description":"Phone number"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Email address"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"First name (for contacts/leads)"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Last name (for contacts/leads)"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Job title (for contacts/leads)"}},"type":"object","title":"MatchCandidate","description":"Individual candidate for matching."}},"components/schemas/MatchCandidateResult":{"id":"components/schemas/MatchCandidateResult","kind":"json-schema","title":"MatchCandidateResult","data":{"properties":{"input_index":{"type":"integer","title":"Input Index","description":"Index of the input candidate"},"matches":{"items":{"$ref":"#/components/schemas/MatchResult"},"type":"array","title":"Matches","description":"List of matches found"},"best_match":{"type":"boolean","title":"Best Match","description":"Whether this is the best match"},"status":{"type":"string","enum":["matched","no_match","ambiguous"],"title":"Status","description":"Match status"}},"type":"object","required":["input_index","matches","best_match","status"],"title":"MatchCandidateResult","description":"Result for a single candidate."}},"components/schemas/MatchGroup":{"id":"components/schemas/MatchGroup","kind":"json-schema","title":"MatchGroup","data":{"properties":{"all":{"items":{"type":"string"},"type":"array","title":"All","description":"List of field rules that must all match"}},"type":"object","required":["all"],"title":"MatchGroup","description":"Match group with boolean logic."}},"components/schemas/MatchPolicy":{"id":"components/schemas/MatchPolicy","kind":"json-schema","title":"MatchPolicy","data":{"properties":{"by":{"items":{"type":"string"},"type":"array","title":"By","description":"List of field rules for matching"},"create_if_no_match":{"type":"boolean","title":"Create If No Match","description":"Whether to create new record if no match found"}},"type":"object","required":["by","create_if_no_match"],"title":"MatchPolicy","description":"Match policy for contact or account matching."}},"components/schemas/MatchRequest":{"id":"components/schemas/MatchRequest","kind":"json-schema","title":"MatchRequest","data":{"properties":{"object":{"type":"string","enum":["account","contact","lead"],"title":"Object","description":"Object type to match"},"candidates":{"items":{"$ref":"#/components/schemas/MatchCandidate"},"type":"array","title":"Candidates","description":"List of candidates to match"},"rules":{"$ref":"#/components/schemas/MatchRules","description":"Matching rules configuration"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","description":"Context information"},"max_credits":{"type":"integer","maximum":100,"minimum":1,"title":"Max Credits","description":"Maximum credits to spend","default":1}},"type":"object","required":["object","candidates","rules"],"title":"MatchRequest","description":"Request model for match API."}},"components/schemas/MatchResponse":{"id":"components/schemas/MatchResponse","kind":"json-schema","title":"MatchResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"results":{"items":{"$ref":"#/components/schemas/MatchCandidateResult"},"type":"array","title":"Results","description":"List of candidate results"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"Confidence score (0.0-1.0) or null if disabled/not found"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache"}},"type":"object","required":["success","results","credits_consumed","processing_time_ms","cached"],"title":"MatchResponse","description":"Response model for match API."}},"components/schemas/MatchResult":{"id":"components/schemas/MatchResult","kind":"json-schema","title":"MatchResult","data":{"properties":{"sf_id":{"type":"string","title":"Sf Id","description":"Salesforce ID of the matched record"},"object":{"type":"string","title":"Object","description":"Object type of the matched record (e.g., 'Account', 'Contact', 'Lead')"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","description":"Overall confidence score"},"explanations":{"items":{"type":"string"},"type":"array","title":"Explanations","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of match explanations (e.g., ['domain eq', 'name fuzzy 0.86'])"},"children":[]}]}]}]},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Matched record fields (e.g., {'Name': 'Company Name', 'Website': 'example.com'})"},"children":[]}]}]}]}},"type":"object","required":["sf_id","object","confidence","explanations","fields"],"title":"MatchResult","description":"Individual match result."}},"components/schemas/MatchRules":{"id":"components/schemas/MatchRules","kind":"json-schema","title":"MatchRules","data":{"properties":{"mode":{"type":"string","enum":["simple","grouped","ai"],"title":"Mode","description":"Matching mode"},"groups":{"anyOf":[{"items":{"$ref":"#/components/schemas/MatchGroup"},"type":"array"},{"type":"null"}],"title":"Groups","description":"Match groups (for grouped mode)"},"any":{"type":"boolean","title":"Any","description":"Match if any group is true","default":true},"threshold":{"type":"number","maximum":1,"minimum":0,"title":"Threshold","description":"Overall confidence cutoff"},"effort":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Effort","description":"Enrichment effort level (for AI mode)","examples":["low","medium","high"]}},"type":"object","required":["mode","threshold"],"title":"MatchRules","description":"Match rules configuration."}},"components/schemas/MergePolicy":{"id":"components/schemas/MergePolicy","kind":"json-schema","title":"MergePolicy","data":{"properties":{"on_contact_match":{"type":"string","title":"On Contact Match","description":"Action when contact match is found"},"on_account_match":{"type":"string","title":"On Account Match","description":"Action when account match is found"}},"type":"object","required":["on_contact_match","on_account_match"],"title":"MergePolicy","description":"Merge policy configuration."}},"components/schemas/PersonEnrichmentData":{"id":"components/schemas/PersonEnrichmentData","kind":"json-schema","title":"PersonEnrichmentData","data":{"properties":{"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"Person's full name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Person's email address"},"email_confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Email Confidence","description":"Email confidence score (0.0-1.0)"},"email_status":{"$ref":"#/components/schemas/EmailStatus","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email verification status: valid, accept_all, risky, invalid, unknown"},"children":[]}]}]}],"default":"unknown"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","description":"Direct phone number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Job title"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url","description":"LinkedIn profile URL"},"job_last_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Last Seen At","description":"ISO timestamp when job information was last verified"}},"type":"object","title":"PersonEnrichmentData","description":"Person enrichment data response."}},"components/schemas/PersonEnrichmentRequest":{"id":"components/schemas/PersonEnrichmentRequest","kind":"json-schema","title":"PersonEnrichmentRequest","data":{"properties":{"record_id":{"type":"string","title":"Record Id","description":"Unique identifier for this enrichment request"},"first_name":{"type":"string","title":"First Name","description":"Person's first name"},"last_name":{"type":"string","title":"Last Name","description":"Person's last name"},"company_domain":{"type":"string","title":"Company Domain","description":"Company domain where the person works"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Person's email address"},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"LinkedIn ID or profile URL"},"effort":{"$ref":"#/components/schemas/EnrichmentEffortType","description":"Enrichment effort type","default":"low","examples":["low","medium","high"]},"max_credits":{"type":"integer","maximum":100,"minimum":1,"title":"Max Credits","description":"Maximum credits to spend on this request","default":1}},"type":"object","required":["record_id","first_name","last_name","company_domain"],"title":"PersonEnrichmentRequest","description":"Request model for person enrichment."}},"components/schemas/PersonEnrichmentResponse":{"id":"components/schemas/PersonEnrichmentResponse","kind":"json-schema","title":"PersonEnrichmentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"record_id":{"type":"string","title":"Record Id","description":"Unique identifier for this enrichment request"},"person":{"anyOf":[{"$ref":"#/components/schemas/PersonEnrichmentData"},{"type":"null"}],"description":"Enriched person data"},"confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Confidence","description":"Confidence score (0.0-1.0) or null if disabled/not found"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache"}},"type":"object","required":["success","record_id","credits_consumed","processing_time_ms","cached"],"title":"PersonEnrichmentResponse","description":"Response model for person enrichment."}},"components/schemas/PhoneEnrichBatchRequest":{"id":"components/schemas/PhoneEnrichBatchRequest","kind":"json-schema","title":"PhoneEnrichBatchRequest","data":{"properties":{"ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1},{"type":"null"}],"title":"Ids","description":"List of IDs to process for phone enrichment"},"records":{"anyOf":[{"items":{"$ref":"#/components/schemas/PhoneEnrichmentRecord"},"type":"array","maxItems":1000,"minItems":1},{"type":"null"}],"title":"Records","description":"List of record objects to process for phone enrichment"},"entity_type":{"type":"string","const":"person","title":"Entity Type","description":"Type of entity being processed (must be 'person' for phone enrichment)","default":"person"},"max_credits":{"type":"integer","exclusiveMinimum":0,"title":"Max Credits","description":"Maximum credits this request is allowed to consume"}},"type":"object","required":["max_credits"],"title":"PhoneEnrichBatchRequest","description":"Request model for phone enrichment batch operations.","examples":[{"entity_type":"person","ids":["550e8400-e29b-41d4-a716-446655440001","550e8400-e29b-41d4-a716-446655440002","550e8400-e29b-41d4-a716-446655440003"],"max_credits":100}]}},"components/schemas/PhoneEnrichmentRecord":{"id":"components/schemas/PhoneEnrichmentRecord","kind":"json-schema","title":"PhoneEnrichmentRecord","data":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the record"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"Person's first name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Person's last name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Company name or website URL"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Person's email address"},"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin","description":"LinkedIn profile URL or identifier"}},"type":"object","required":["id"],"title":"PhoneEnrichmentRecord","description":"Record model for phone enrichment batch operations."}},"components/schemas/PhoneEnrichmentRequest":{"id":"components/schemas/PhoneEnrichmentRequest","kind":"json-schema","title":"PhoneEnrichmentRequest","data":{"properties":{"record_id":{"type":"string","title":"Record Id","description":"Your unique identifier for this record"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"Contact's first name (required for name-based enrichment)"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Contact's last name (required for name-based enrichment)"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Company name or website URL (required for name-based enrichment)"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Contact's email address (optional)"},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"LinkedIn profile identifier/slug (e.g., 'john-doe-123456')","examples":["john-doe-123456","jane-smith-789"]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Company domain (optional) - improves accuracy when provided"}},"type":"object","required":["record_id"],"title":"PhoneEnrichmentRequest","description":"Request model for phone enrichment."}},"components/schemas/PhoneEnrichmentResponse":{"id":"components/schemas/PhoneEnrichmentResponse","kind":"json-schema","title":"PhoneEnrichmentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"record_id":{"type":"string","title":"Record Id","description":"Echo of the input record ID"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"Echo of input first name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Echo of input last name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Echo of input company"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Echo of input email or email found during enrichment"},"linkedin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Id","description":"Echo of input LinkedIn ID or LinkedIn profile found during enrichment"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","description":"International format phone number (E.164) or null if not found"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"}},"type":"object","required":["success","record_id","processing_time_ms"],"title":"PhoneEnrichmentResponse","description":"Response model for phone enrichment."}},"components/schemas/PollingStatus":{"id":"components/schemas/PollingStatus","kind":"json-schema","title":"PollingStatus","data":{"properties":{"last_poll_time":{"type":"string","title":"Last Poll Time","description":"ISO timestamp of last poll"},"records_processed":{"type":"integer","title":"Records Processed","description":"Number of records processed in last poll"},"watermark_value":{"type":"string","title":"Watermark Value","description":"Current watermark value"},"next_poll_time":{"type":"string","title":"Next Poll Time","description":"ISO timestamp of next scheduled poll"}},"type":"object","required":["last_poll_time","records_processed","watermark_value","next_poll_time"],"title":"PollingStatus","description":"Status of polling-based enrichment."}},"components/schemas/RemainingCreditsResponse":{"id":"components/schemas/RemainingCreditsResponse","kind":"json-schema","title":"RemainingCreditsResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"tenant_id":{"type":"integer","title":"Tenant Id","description":"Tenant ID"},"remaining_credits":{"type":"number","title":"Remaining Credits","description":"Remaining credits for the tenant"},"total_credits":{"type":"number","title":"Total Credits","description":"Total credits for the tenant"}},"type":"object","required":["success","tenant_id","remaining_credits","total_credits"],"title":"RemainingCreditsResponse","description":"Response model for remaining credits."}},"components/schemas/ResetRules":{"id":"components/schemas/ResetRules","kind":"json-schema","title":"ResetRules","data":{"properties":{"reason":{"type":"string","title":"Reason","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reason for reset (e.g., 'bad_fit', 'user_request')"},"children":[]}]}]}]},"place_user_at_top":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place User At Top","description":"User ID to place at top of rotation (optional)"}},"type":"object","required":["reason"],"title":"ResetRules","description":"Reset rules for round-robin assignment."}},"components/schemas/RouteLog":{"id":"components/schemas/RouteLog","kind":"json-schema","title":"RouteLog","data":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"ISO timestamp of the action"},"object":{"type":"string","enum":["Lead","Contact","Account","Opportunity"],"title":"Object","description":"Salesforce object type"},"object_id":{"type":"string","title":"Object Id","description":"Salesforce ID of the object"},"action":{"type":"string","enum":["assign","convert","merge","enrich"],"title":"Action","description":"Action performed on the object"},"pool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pool","description":"Round-robin pool name (for assign actions)"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To","description":"Salesforce ID of assigned user (for assign actions)"},"prev_owner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prev Owner","description":"Previous owner ID (for assign/convert actions)"},"sequence":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sequence","description":"Round-robin sequence number (for assign actions)"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reason for the action (e.g., 'round_robin', 'manual_override')"},"children":[]}]}]}]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key","description":"Idempotency key for duplicate prevention"},"diff":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Diff","description":"Field changes for enrichment/merge actions"}},"type":"object","required":["timestamp","object","object_id","action"],"title":"RouteLog","description":"Route log entry for audit and reporting."}},"components/schemas/RunErrorResponse":{"id":"components/schemas/RunErrorResponse","kind":"json-schema","title":"RunErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"}},"type":"object","required":["error"],"title":"RunErrorResponse","description":"Error response model for run operations."}},"components/schemas/RunStatus":{"id":"components/schemas/RunStatus","kind":"json-schema","title":"RunStatus","data":{"type":"string","enum":["queued","queued","failed","completed","failed"],"title":"RunStatus"}},"components/schemas/RunStatusResponse":{"id":"components/schemas/RunStatusResponse","kind":"json-schema","title":"RunStatusResponse","data":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id","description":"Unique identifier for the run"},"status":{"$ref":"#/components/schemas/RunStatus","description":"Current status of the run"}},"type":"object","required":["run_id","status"],"title":"RunStatusResponse","description":"Response model for run status.","example":{"run_id":"123e4567-e89b-12d3-a456-426614174000","status":"queued"}}},"components/schemas/TokenUsage":{"id":"components/schemas/TokenUsage","kind":"json-schema","title":"TokenUsage","data":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens","description":"Tokens used in the input"},"completion_tokens":{"type":"integer","title":"Completion Tokens","description":"Tokens used in the response"},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total tokens consumed"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"TokenUsage","description":"Token usage information for AI enrichment."}},"components/schemas/TriggerRequest":{"id":"components/schemas/TriggerRequest","kind":"json-schema","title":"TriggerRequest","data":{"properties":{"object":{"type":"string","enum":["lead","contact","account","opportunity"],"title":"Object","description":"Salesforce object type that triggered the event"},"ids":{"items":{"type":"string"},"type":"array","title":"Ids","description":"List of Salesforce record IDs that changed"},"event":{"type":"string","enum":["after_insert","after_update","after_undelete"],"title":"Event","description":"Salesforce trigger event type"},"org_id":{"type":"string","title":"Org Id","description":"Salesforce organization ID"}},"type":"object","required":["object","ids","event","org_id"],"title":"TriggerRequest","description":"Request model for Salesforce trigger webhook."}},"components/schemas/TriggerResponse":{"id":"components/schemas/TriggerResponse","kind":"json-schema","title":"TriggerResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"processed_count":{"type":"integer","title":"Processed Count","description":"Number of records processed"},"enrichment_jobs":{"items":{"type":"string"},"type":"array","title":"Enrichment Jobs","description":"List of enrichment job IDs created"},"workflow_status":{"type":"string","enum":["started","queued","failed"],"title":"Workflow Status","description":"Status of the enrichment workflow"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache"}},"type":"object","required":["success","processed_count","enrichment_jobs","workflow_status","credits_consumed","processing_time_ms","cached"],"title":"TriggerResponse","description":"Response model for Salesforce trigger webhook."}},"components/schemas/ValidationError":{"id":"components/schemas/ValidationError","kind":"json-schema","title":"ValidationError","data":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"components/schemas/WorkflowErrorResponse":{"id":"components/schemas/WorkflowErrorResponse","kind":"json-schema","title":"WorkflowErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"workflow_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Id","description":"Workflow ID that failed"},"credits_required":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Required","description":"Credits required for insufficient credit errors"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Credits remaining for insufficient credit errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"WorkflowErrorResponse","description":"Error response model for Workflow Trigger API."}},"components/schemas/WorkflowTriggerRequest":{"id":"components/schemas/WorkflowTriggerRequest","kind":"json-schema","title":"WorkflowTriggerRequest","data":{"properties":{"record_data":{"additionalProperties":true,"type":"object","title":"Record Data","description":"Generic record payload containing fields for Lead, Contact, Opportunity, or other custom objects"},"source_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source System","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Source system identifier (e.g., 'eloqua', 'cdp', 'data_lake')"},"children":[]}]}]}]},"enrichment_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Enrichment Preferences","description":"Optional enrichment preferences and configuration"}},"type":"object","required":["record_data"],"title":"WorkflowTriggerRequest","description":"Request model for Workflow Trigger API."}},"components/schemas/WorkflowTriggerResponse":{"id":"components/schemas/WorkflowTriggerResponse","kind":"json-schema","title":"WorkflowTriggerResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success"},"status":{"type":"string","enum":["triggered","queued","failed"],"title":"Status","description":"Status of the workflow trigger"},"request_id":{"type":"string","title":"Request Id","description":"Unique request ID for tracking"},"workflow_id":{"type":"string","title":"Workflow Id","description":"ID of the triggered workflow"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to process the request in milliseconds"},"enrichment_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enrichment Job Id","description":"ID of the enrichment job created (if applicable)"},"credits_consumed":{"type":"integer","title":"Credits Consumed","description":"Number of credits used for this request"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Approximate remaining credit balance. Use GET /v1/credits/remaining for precise balance."},"cached":{"type":"boolean","title":"Cached","description":"Boolean indicating if this result was returned from cache","default":false}},"type":"object","required":["success","status","request_id","workflow_id","processing_time_ms","credits_consumed"],"title":"WorkflowTriggerResponse","description":"Response model for Workflow Trigger API."}},"components/schemas/api_gateway__models__credits__ErrorResponse":{"id":"components/schemas/api_gateway__models__credits__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Boolean indicating request success","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Error response model."}},"components/schemas/api_gateway__models__enrichment__ErrorResponse":{"id":"components/schemas/api_gateway__models__enrichment__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"credits_required":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Required","description":"Credits required for insufficient credit errors"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Credits remaining for insufficient credit errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"components/schemas/api_gateway__models__logs__ErrorResponse":{"id":"components/schemas/api_gateway__models__logs__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"components/schemas/api_gateway__models__match__ErrorResponse":{"id":"components/schemas/api_gateway__models__match__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"credits_required":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Required","description":"Credits required for insufficient credit errors"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Credits remaining for insufficient credit errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"components/schemas/api_gateway__models__routing__ErrorResponse":{"id":"components/schemas/api_gateway__models__routing__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"components/schemas/api_gateway__models__salesforce__ErrorResponse":{"id":"components/schemas/api_gateway__models__salesforce__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"components/schemas/api_gateway__models__triggers__ErrorResponse":{"id":"components/schemas/api_gateway__models__triggers__ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Always false for error responses","default":false},"error":{"type":"string","title":"Error","description":"Error message"},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional error details"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Request ID for tracking"},"credits_required":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Required","description":"Credits required for insufficient credit errors"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Credits remaining for insufficient credit errors"},"retry_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After","description":"Seconds to wait before retrying for rate limit errors"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"Standard error response model."}},"schema_17":{"kind":"json-schema","data":{"type":"string","format":"date-time","description":"Start date for log export (ISO format)","title":"From Date"},"id":"schema_17"},"schema_18":{"kind":"json-schema","data":{"type":"string","format":"date-time","description":"End date for log export (ISO format)","title":"To Date"},"id":"schema_18"},"schema_19":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by specific pool name","title":"Pool"},"id":"schema_19"},"schema_20":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by specific object type","title":"Object"},"id":"schema_20"},"schema_21":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by specific action type","title":"Action"},"id":"schema_21"},"schema_22":{"kind":"json-schema","data":{"type":"string","description":"Export format (json, csv)","default":"json","title":"Format"},"id":"schema_22"},"schema_23":{"kind":"json-schema","data":{"type":"boolean","description":"Include diff data in export","default":true,"title":"Include Diff"},"id":"schema_23"},"schema_24":{"kind":"json-schema","data":{"type":"integer","maximum":10000,"minimum":1,"description":"Maximum number of records to return","default":1000,"title":"Limit"},"id":"schema_24"},"schema_25":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/RouteLog"},"title":"Response Export Route Logs V1 Logs Routing Get"},"id":"schema_25"},"schema_26":{"kind":"json-schema","data":{"type":"string","title":"Run Id"},"id":"schema_26"},"schema_27":{"kind":"json-schema","data":{"type":"string","format":"date-time","description":"Start date for credit calculation","title":"Start Date"},"id":"schema_27"},"schema_28":{"kind":"json-schema","data":{"type":"string","format":"date-time","description":"End date for credit calculation","title":"End Date"},"id":"schema_28"},"schema_29":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional workflow ID for filtering","title":"Workflow Id"},"id":"schema_29"},"schema_30":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional workflow run ID for filtering","title":"Workflow Run Id"},"id":"schema_30"},"schema_31":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional custom key for filtering","title":"Custom Key"},"id":"schema_31"},"schema_32":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional custom value for filtering","title":"Custom Value"},"id":"schema_32"},"schema_33":{"kind":"json-schema","data":{"type":"string","title":"Workflow Id"},"id":"schema_33"}},"exampleStore":{"paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example":{"value":{"success":true,"record_id":"contact_001","first_name":"John","last_name":"Smith","company":"Acme Corp","email":"john.smith@acme.com","linkedin_id":"john-smith-123456","phone":"+1-555-123-4567","processing_time_ms":1250},"id":"paths/~1v1~1enrich~1phone/post/responses/200/content/application~1json/example"},"paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example":{"value":{"success":true,"record_id":"contact_001","first_name":"John","last_name":"Smith","company":"Acme Corp","email":"john.smith@acme.com","confidence":"high","credits_consumed":3,"credits_remaining":950,"processing_time_ms":750,"cached":false},"id":"paths/~1v1~1enrich~1email/post/responses/200/content/application~1json/example"},"paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example":{"value":{"success":true,"record_id":"company_001","company":{"name":"Databricks","domain":"databricks.com","linkedin_url":"https://www.linkedin.com/company/databricks","hq":{"city":"San Francisco","state":"CA","country":"US","postal_code":"94105"},"size_range":"500+","industry":"Technology","geo":{"lat":37.79,"lon":-122.39,"county":"San Francisco"},"last_verified_at":"2025-09-12T18:22:01Z"},"confidence":0.9,"credits_consumed":1,"credits_remaining":950,"processing_time_ms":1200,"cached":true},"id":"paths/~1v1~1enrich~1company/post/responses/200/content/application~1json/example"},"paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example":{"value":{"success":true,"record_id":"person_001","person":{"full_name":"Jane Doe","email":"jane.doe@trinet.com","email_confidence":0.93,"email_status":"valid","phone":"+1-415-555-0199","title":"Director, RevOps","linkedin_url":"https://linkedin.com/in/janedoe","job_last_seen_at":"2025-08-30T15:12:00Z"},"confidence":0.9,"credits_consumed":1,"credits_remaining":950,"processing_time_ms":1200,"cached":true},"id":"paths/~1v1~1enrich~1person/post/responses/200/content/application~1json/example"},"paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response":{"value":{"success":true,"query":"Analyze the market trends for electric vehicles in 2024","response":"Based on current market data, electric vehicle adoption is accelerating rapidly in 2024. Key trends include: 1) Increased affordability with new models under $30k, 2) Improved charging infrastructure with 40% more stations, 3) Enhanced battery technology offering 300+ mile ranges...","confidence":0.85,"credits_consumed":5,"credits_remaining":950,"token_usage":{"prompt_tokens":45,"completion_tokens":234,"total_tokens":279},"processing_time_ms":1200},"key":"text_response","summary":"Text Format Response","id":"paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/text_response"},"paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response":{"value":{"success":true,"query":"Extract key information from this company description","response":{"company_name":"TechCorp Solutions","industry":"Software Development","employee_count":"250-500","founded":"2018","headquarters":"San Francisco, CA","key_products":["CRM Software","Analytics Platform","Mobile Apps"]},"confidence":0.92,"credits_consumed":3,"credits_remaining":950,"token_usage":{"prompt_tokens":67,"completion_tokens":89,"total_tokens":156},"processing_time_ms":950},"key":"json_response","summary":"JSON Format Response","id":"paths/~1v1~1enrich~1ai/post/responses/200/content/application~1json/examples/json_response"},"paths/~1v1~1match/post/responses/200/content/application~1json/example":{"value":{"success":true,"results":[{"input_index":0,"matches":[{"sf_id":"001xx0001ABCDEF","object":"Account","confidence":0.91,"explanations":["domain eq","name fuzzy 0.86"],"fields":{"Name":"TriNet Group, Inc.","Website":"trinet.com","Phone":"+1-800-874-6388"}}],"best_match":true,"status":"matched"}],"confidence":0.9,"credits_consumed":1,"credits_remaining":950,"processing_time_ms":1200,"cached":true},"id":"paths/~1v1~1match/post/responses/200/content/application~1json/example"},"paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example":{"value":{"success":true,"status":"converted","account_id":"001xx0001ABCDEF","contact_id":"003xx0002HIJKLM","owner_id":"005xx0003NOPQRS","actions":["lead_merged","contact_created","assigned_round_robin"],"credits_consumed":6,"processing_time_ms":2500,"cached":false},"id":"paths/~1v1~1salesforce~1convert/post/responses/200/content/application~1json/example"},"paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example":{"value":{"success":true,"assigned_to":"005xx0002ABCDE","sequence":1245,"pool_size":17,"timestamp":"2025-09-18T16:12:00Z","credits_consumed":1,"processing_time_ms":450,"cached":false},"id":"paths/~1v1~1routing~1assign/post/responses/200/content/application~1json/example"},"paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example":{"value":{"success":true,"processed_count":2,"enrichment_jobs":["job_001","job_002"],"workflow_status":"started","credits_consumed":4,"credits_remaining":950,"processing_time_ms":850,"cached":false},"id":"paths/~1v1~1triggers~1salesforce/post/responses/200/content/application~1json/example"},"paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example":{"value":[{"timestamp":"2025-09-18T16:12:00Z","object":"Lead","object_id":"00Qxx0000Lm789U","action":"assign","pool":"SDR_WEST_01","assigned_to":"005xx0002ABCDE","prev_owner":"005xx0001ZZZZZ","sequence":1245,"reason":"round_robin","request_id":"req_abc123","idempotency_key":"c1f2-..."},{"timestamp":"2025-09-18T16:15:00Z","object":"Lead","object_id":"00Qxx0000Lm78AA","action":"enrich","reason":"auto_enrichment","request_id":"req_def456","idempotency_key":"a3b4-...","diff":{"Company":{"to":"Databricks"},"Industry":{"from":"Unknown","to":"Software"}}}],"id":"paths/~1v1~1logs~1routing/get/responses/200/content/application~1json/example"},"paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example":{"value":{"run_id":"550e8400-e29b-41d4-a716-446655440000","result_path":"s3://{s3_bucket}/{entity_type}/phone-enrichment-batch_2025-01-15_550e8400-e29b-41d4-a716-446655440000.csv","credits_csv_path":"s3://{s3_bucket}/{s3_prefix}/phone-enrichment/2025-01-15/550e8400-e29b-41d4-a716-446655440000_credits.csv"},"id":"paths/~1v1~1agents~1phone/post/responses/202/content/application~1json/example"},"paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example":{"value":{"run_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","result_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment-batch_2025-01-15_550e8400-e29b-41d4-a716-446655440000.csv","credits_csv_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment/2025-01-15/550e8400-e29b-41d4-a716-446655440000_credits.csv"},"id":"paths/~1v1~1agents~1email/post/responses/202/content/application~1json/example"},"paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example":{"value":{"run_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","result_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment-batch_2025-01-15_550e8400-e29b-41d4-a716-446655440000.csv","credits_csv_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment/2025-01-15/550e8400-e29b-41d4-a716-446655440000_credits.csv"},"id":"paths/~1v1~1agents~1deep-research/post/responses/202/content/application~1json/example"},"paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example":{"value":{"run_id":"550e8400-e29b-41d4-a716-446655440000","result_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment-batch_2025-01-15_550e8400-e29b-41d4-a716-446655440000.csv","credits_csv_path":"s3://{s3_bucket}/{entity_type}/phone-email-enrichment/2025-01-15/550e8400-e29b-41d4-a716-446655440000_credits.csv"},"id":"paths/~1v1~1agents~1phone-email/post/responses/202/content/application~1json/example"},"paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example":{"value":{"run_id":"123e4567-e89b-12d3-a456-426614174000","status":"completed"},"id":"paths/~1v1~1agents~1runs~1{run_id}~1status/get/responses/200/content/application~1json/example"},"paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example":{"value":{"success":true,"tenant_id":123,"start_date":"2024-01-01T00:00:00Z","end_date":"2024-12-31T23:59:59Z","credits_used":1250.5},"id":"paths/~1v1~1credits~1usage/get/responses/200/content/application~1json/example"},"paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example":{"value":{"success":true,"tenant_id":123,"remaining_credits":4750.25},"id":"paths/~1v1~1credits~1remaining/get/responses/200/content/application~1json/example"},"paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example":{"value":{"tenant_id":1,"submission_id":"123e4567-e89b-12d3-a456-426614174000","submission_timestamp":"2024-01-15T10:30:00Z","form_name":"Lead Generation Form","form_payload":{"name":"John Doe","email":"john.doe@example.com","company":"Acme Corp","phone":"+1-555-123-4567","title":"VP Sales"}},"id":"paths/~1v1~1forms~1submit/post/responses/200/content/application~1json/example"},"paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example":{"value":{"success":true,"status":"triggered","request_id":"req_1234567890abcdef","workflow_id":"wf_workflow_123","processing_time_ms":150,"enrichment_job_id":"job_9876543210fedcba","credits_consumed":3,"credits_remaining":950,"cached":false},"id":"paths/~1v1~1workflows~1{workflow_id}~1trigger/post/responses/200/content/application~1json/example"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"ApiToken"}},"servers":[{"url":"https://api-gateway.agenthq.withlantern.com","description":"Lantern API server"},{"url":"http://localhost:8000","description":"Local API server"}]},"options":{"disableSearch":false,"hideDownloadButton":false,"generateCodeSamples":{"languages":[{"lang":"curl","label":"cURL"},{"lang":"Node.js","label":"Node.js"},{"lang":"Python","label":"Python"},{"lang":"PHP","label":"PHP"},{"lang":"Java","label":"Java"}]},"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi.json?download"},{"url":"/_bundle/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Lantern API docs","description":"## Overview\n\nThe Lantern API provides two major processing modes to enhance your contact and business data:\n\n🔄 **Sync API** - Real-time Processing (`/v1/enrich/`)\nProcess individual records and get immediate responses. Perfect for:\n- Real-time user interfaces\n- Single record processing\n- Immediate validation workflows\n\n**Available Services:**\n- **Phone Enrichment**: Find phone numbers for contacts\n- **Email Enrichment**: Discover professional email addresses\n- **Company Enrichment**: Get comprehensive firmographics and website-verified data\n- **Person Enrichment**: Enrich person records with contact and professional data\n- **AI Enrichment**: Generate insights, analysis, and structured data using advanced language models\n- **Deep Research**: Comprehensive research using advanced language models with real-time search capabilities\n\n🎯 **Match API** - Object Matching (`/v1/match/`)\nMatch Account/Contact/Lead objects with sophisticated matching logic. Perfect for:\n- CRM data deduplication\n- Lead-to-account matching\n- Contact matching and merging\n\n**Available Services:**\n- **Account Matching**: Match company records with exact, fuzzy, and AI-assisted logic\n- **Contact Matching**: Match contact records with grouped boolean logic\n- **Lead Matching**: Match lead records with confidence scoring and explanations\n\n🔗 **Salesforce API** - Lead Conversion (`/v1/salesforce/`)\nConvert Salesforce Leads to Contacts and Accounts with intelligent matching. Perfect for:\n- Automated lead conversion workflows\n- CRM data management\n- Lead-to-contact merging\n\n**Available Services:**\n- **Lead Conversion**: Convert leads to contacts and accounts with duplicate prevention\n- **Auto-Merge**: Intelligent merging with configurable policies\n- **Round-Robin Assignment**: Automatic owner assignment from pools\n\n🎯 **Routing API** - Round Robin Assignment (`/v1/routing/`)\nAssign Salesforce objects to users using intelligent round-robin logic. Perfect for:\n- Fair distribution of leads and opportunities\n- Automated user assignment\n- Pool-based routing management\n\n**Available Services:**\n- **Round Robin Assignment**: Assign objects to users with sequence tracking\n- **Pool Management**: Organize users into assignment pools\n- **Reset Rules**: Support for resetting rotation with specific reasons\n\n⚡ **Triggers API** - Instant Enrichment (`/v1/triggers/`)\nTrigger instant enrichment on Salesforce record creation/updates. Perfect for:\n- Real-time data enrichment\n- Automated workflow triggers\n- Near real-time processing\n\n**Available Services:**\n- **Salesforce Webhooks**: Real-time trigger processing via Platform Events\n- **Polling Fallback**: SOQL-based polling every 2 minutes for comprehensive coverage\n- **Instant Enrichment**: Automatic enrichment workflows on record changes\n\n📊 **Logs API** - Audit & Reporting (`/v1/logs/`)\nComprehensive audit trails and reporting for all routing actions. Perfect for:\n- Compliance and audit requirements\n- Performance analysis and monitoring\n- User activity tracking\n\n**Available Services:**\n- **Route Log Export**: Export logs with filtering and multiple formats (JSON/CSV)\n- **Log Statistics**: Statistical analysis of log data for reporting\n- **Retention Management**: Configurable retention policies and cleanup schedules\n\n🚀 **Async API** - Batch Processing (`/v1/agents/`)\nProcess multiple records (1-1000) asynchronously with results stored in S3. Perfect for:\n- Large-scale bulk processing\n- Background processing workflows\n- Cost breakdown results on s3 too\n\n**Available Services:**\n- **Phone Enrichment Batch**: Bulk phone number enrichment\n- **Email Enrichment Batch**: Bulk email address enrichment\n- **Deep Research Batch**: Bulk AI-powered research with specialized agents\n\n💳 **Credits API** - Credit Management (`/v1/credits/`)\nMonitor and manage your credit usage and availability. Perfect for:\n- Tracking credit consumption across time periods\n- Checking remaining credit balance\n\n**Available Services:**\n- **Credit Usage**: Get detailed usage statistics for specific date ranges\n- **Remaining Credits**: Check current credit balance\n\n🔄 **Workflow Trigger API** - External System Integration (`/v1/workflows/`)\nTrigger enrichment and routing workflows from external systems. Perfect for:\n- Eloqua, CDP, and Data Lake integrations\n- Marketing automation platform triggers\n- High-volume bursty event processing\n\n**Available Services:**\n- **Workflow Trigger**: Generic interface for initiating workflows from any external system\n- **Audit Logging**: Complete request/response logging for compliance\n- **Retry Logic**: Automatic retries with exponential backoff\n\n📝 **Form Submit API** - Direct Form Processing (`/v1/forms/`)\nAccept form submissions and immediately enrich and disposition data. Perfect for:\n- Marketing automation platform integrations\n- Website form processing\n- Real-time lead enrichment\n\n**Available Services:**\n- **Form Submission**: Accept form data with validation\n- **Immediate Enrichment**: Sub-5 second processing with GDPR compliance\n- **Flexible Output**: Return enriched data or push to external systems\n\n## Processing Mode Comparison\n\n| Feature | Sync API | Match API | Salesforce API | Routing API | Triggers API | Logs API | Async API | Credits API | Workflow API | Form API |\n|---------|----------|-----------|---------------|-------------|--------------|----------|-----------|-------------|-------------|----------|\n| **Records per request** | 1 | 1-100 | 1 | 1 | 1-100 | 1-10000 | 1-1000 | N/A | 1 | 1 |\n| **Response time** | Immediate | Immediate | Immediate | Immediate | Immediate | Immediate | Asynchronous | Immediate | Immediate | Immediate |\n| **Result delivery** | Direct response | Direct response | Direct response | Direct response | Direct response | Direct response | S3 storage | Direct response | Direct response | Direct response |\n| **Use case** | Real-time processing | Object matching | Lead conversion | User assignment | Instant enrichment | Audit reporting | Bulk operations | Credit monitoring | External system triggers | Form processing |\n| **Rate limits** | Per-minute limits | Per-minute limits | Per-minute limits | Per-minute limits | Per-minute limits | Per-minute limits | Lower frequency limits | Per-minute limits | High burst support | High burst support |\n\n## Base URL\n\n```\nhttps://api-gateway.agenthq.withlantern.com\n```\n\n## Authentication\n\nAll requests must include your API key in the Authorization header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n## Rate Limiting & Credits\n\n- **Sync API Rate Limit**: 50 requests per minute per API key. Can be lifted on request.\n- **Async API Rate Limit**: 1 batch request per minute per API key. Can be lifted on request.\n- **Credits API Rate Limit**: 10 requests per minute per API key. Can be lifted on request.\n- **Headers**: Rate limit and credit information is returned in response headers:\n    - `X-RateLimit-Limit`: The rate limit ceiling for your API key\n    - `X-Credits-Remaining`: Credits remaining in your account\n\n**Error Codes:**\n\n- `429 Too Many Requests`: Rate limit exceeded\n- `402 Payment Required`: Credit limit exceeded\n\n## Best Practices\n\n### General Guidelines\n\n1. **API Key Security**: Keep your API key secure and never expose it in client-side code\n2. **Rate Limit Handling**: Implement exponential backoff when receiving 429 responses\n3. **Error Handling**: Always check the `success` field before processing results\n4. **Credit Management**: Monitor your credit usage and remaining balance through response headers\n\n### Sync API Guidelines\n\n1. **Use Unique Record IDs**: Always provide unique record IDs to enable caching and prevent duplicate processing\n2. **Set Credit Limits**: Use `max_credits` parameter to control spending per request\n3. **Cache Awareness**: Check the `cached` field to understand if fresh data was retrieved\n4. **Monitor Confidence Levels**: Use confidence scores to determine data quality for your use case\n\n### Async API Guidelines\n\n1. **Batch Sizing**: Submit 100-1000 records per batch for optimal performance\n2. **Result Monitoring**: Get submission details from API call when batch is accepted, then poll results from S3 until completion\n3. **Credit Planning**: Set appropriate `max_credits` limits for large batches\n4. **Error Handling**: Handle batch-level errors and individual record failures within results\n\n### Credits API Guidelines\n\n1. **Proactive Monitoring**: Check remaining credits before large operations\n2. **Usage Tracking**: Use date range filtering to analyze spending patterns\n3. **Budget Planning**: Monitor usage trends to forecast credit needs\n\n### AI Enrichment\n\n1. **Clear Queries**: Be specific and provide context for better responses\n2. **JSON Format**: Enable JSON formatting for structured data extraction tasks\n3. **Monitor Confidence**: Pay attention to confidence scores for quality assessment"}},"baseSlug":"/openapi","routesMapping":{}}