{"openapi":"3.1.0","info":{"title":"Intelligence API — LiveOne","version":"0.1.0","description":"The Intelligence Service provides client intelligence and content performance insights.\n\n## Modules\n\n### Client Intelligence\nClient company profiles, brand intelligence, restrictions, and preferences.\nStores what we know about clients - their brand voice, what they can't say, and what they like.\n\n### Engagement Intelligence\nContact and account health tracking - engagement scores, churn risk, lifecycle stages.\n\n### Compliance Engine\nDocument tracking, interaction logging, and consent management for regulatory compliance.\n\n### Pulse Generator\nContent performance metrics, engagement scoring, and intelligence alerts.\n\n## Authentication\nAll endpoints require a valid session cookie. Use the Auth Service to authenticate.","contact":{"name":"LiveOne API Support","email":"support@liveone.com","url":"https://dash.liveone.ai"}},"servers":[{"url":"https://intelligence.liveone.ai","description":"Production"}],"components":{"schemas":{"ListContactProfilesResponse":{"type":"object","properties":{"profiles":{"type":"array","items":{"$ref":"#/components/schemas/ContactIntelligenceProfile"}},"total":{"type":"integer","example":50},"page":{"type":"integer","example":1},"limit":{"type":"integer","example":20}},"required":["profiles","total","page","limit"]},"ContactIntelligenceProfile":{"type":"object","properties":{"id":{"type":"string","example":"cip_abc123"},"organizationId":{"type":"string","example":"org_123"},"contactId":{"type":"string","example":"cnt_456"},"engagementScore":{"type":"integer","minimum":0,"maximum":100,"example":75},"sentimentScore":{"type":["integer","null"],"minimum":-100,"maximum":100,"example":25},"lastInteractionDate":{"type":["string","null"],"format":"date-time","example":"2026-01-01T10:00:00Z"},"interactionFrequency":{"type":"string","enum":["unknown","daily","weekly","monthly","quarterly","rarely"],"example":"weekly"},"preferredChannel":{"type":["string","null"],"example":"email"},"responseTimeAvg":{"type":["integer","null"],"example":3600},"lifecycleStage":{"type":"string","enum":["unknown","new","engaged","active","at_risk","churned","won_back"],"example":"engaged"},"churnRisk":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"influenceScore":{"type":["integer","null"],"minimum":0,"maximum":100,"example":60},"decisionMakerLikelihood":{"type":["integer","null"],"minimum":0,"maximum":100,"example":80},"topicsOfInterest":{"type":"array","items":{"type":"string"},"example":["pricing","features"]},"communicationStyle":{"type":["string","null"],"example":"formal"},"bestContactTime":{"type":["string","null"],"example":"morning"},"aiSummary":{"type":["string","null"],"example":"Key decision maker, responsive to technical demos"},"aiRecommendations":{"type":"array","items":{"type":"string"},"example":["Schedule product demo","Send case study"]},"aiLastAnalyzed":{"type":["string","null"],"format":"date-time","example":"2026-01-01T08:00:00Z"},"customAttributes":{"type":"object","additionalProperties":{},"example":{"preferredName":"Bob"}},"dataSources":{"type":"array","items":{"type":"string"},"example":["crm","email","calendar"]},"confidenceScore":{"type":["integer","null"],"minimum":0,"maximum":100,"example":85},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"updatedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T12:00:00Z"}},"required":["id","organizationId","contactId","engagementScore","sentimentScore","lastInteractionDate","interactionFrequency","preferredChannel","responseTimeAvg","lifecycleStage","churnRisk","influenceScore","decisionMakerLikelihood","topicsOfInterest","communicationStyle","bestContactTime","aiSummary","aiRecommendations","aiLastAnalyzed","customAttributes","dataSources","confidenceScore","createdAt","updatedAt"]},"GetContactProfileResponse":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/ContactIntelligenceProfile"}},"required":["profile"]},"UpdateContactIntelligenceRequest":{"type":"object","properties":{"engagementScore":{"type":"integer","minimum":0,"maximum":100},"sentimentScore":{"type":"integer","minimum":-100,"maximum":100},"interactionFrequency":{"type":"string","enum":["unknown","daily","weekly","monthly","quarterly","rarely"],"example":"weekly"},"preferredChannel":{"type":"string"},"responseTimeAvg":{"type":"integer"},"lifecycleStage":{"type":"string","enum":["unknown","new","engaged","active","at_risk","churned","won_back"],"example":"engaged"},"churnRisk":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"influenceScore":{"type":"integer","minimum":0,"maximum":100},"decisionMakerLikelihood":{"type":"integer","minimum":0,"maximum":100},"topicsOfInterest":{"type":"array","items":{"type":"string"}},"communicationStyle":{"type":"string"},"bestContactTime":{"type":"string"},"customAttributes":{"type":"object","additionalProperties":{}}}},"SyncContactIntelligenceFromCrmRequest":{"type":"object","properties":{"engagementScore":{"type":"integer","minimum":0,"maximum":100},"sentimentScore":{"type":["integer","null"],"minimum":-100,"maximum":100},"lastInteractionDate":{"type":["string","null"],"format":"date-time"},"interactionFrequency":{"type":"string","enum":["unknown","daily","weekly","monthly","quarterly","rarely"],"example":"weekly"},"preferredChannel":{"type":["string","null"]},"responseTimeAvg":{"type":["integer","null"]},"lifecycleStage":{"type":"string","enum":["unknown","new","engaged","active","at_risk","churned","won_back"],"example":"engaged"},"churnRisk":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"influenceScore":{"type":["integer","null"],"minimum":0,"maximum":100},"decisionMakerLikelihood":{"type":["integer","null"],"minimum":0,"maximum":100},"topicsOfInterest":{"type":"array","items":{"type":"string"},"default":[]},"communicationStyle":{"type":["string","null"]},"bestContactTime":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiRecommendations":{"type":"array","items":{"type":"string"},"default":[]},"dataSources":{"type":"array","items":{"type":"string"},"default":["crm.contacts","crm.activities"]},"confidenceScore":{"type":"integer","minimum":0,"maximum":100},"customAttributes":{"type":"object","additionalProperties":{},"default":{}}},"required":["engagementScore","interactionFrequency","lifecycleStage","churnRisk","confidenceScore"]},"ListAccountProfilesResponse":{"type":"object","properties":{"profiles":{"type":"array","items":{"$ref":"#/components/schemas/AccountIntelligenceProfile"}},"total":{"type":"integer","example":25},"page":{"type":"integer","example":1},"limit":{"type":"integer","example":20}},"required":["profiles","total","page","limit"]},"AccountIntelligenceProfile":{"type":"object","properties":{"id":{"type":"string","example":"aip_abc123"},"organizationId":{"type":"string","example":"org_123"},"accountId":{"type":"string","example":"acc_456"},"healthScore":{"type":"integer","minimum":0,"maximum":100,"example":80},"engagementScore":{"type":"integer","minimum":0,"maximum":100,"example":70},"growthPotential":{"type":"string","enum":["unknown","low","medium","high","very_high"],"example":"high"},"revenueTrend":{"type":"string","enum":["declining","stable","growing","rapid_growth"],"example":"stable"},"lastActivityDate":{"type":["string","null"],"format":"date-time","example":"2026-01-01T10:00:00Z"},"activityFrequency":{"type":"string","enum":["unknown","daily","weekly","monthly","quarterly","rarely"],"example":"weekly"},"keyContactsCount":{"type":"integer","example":5},"activeDealsCount":{"type":"integer","example":2},"lifetimeValue":{"type":["integer","null"],"example":50000000},"averageDealSize":{"type":["integer","null"],"example":10000000},"winRate":{"type":["integer","null"],"minimum":0,"maximum":100,"example":65},"averageSalesCycle":{"type":["integer","null"],"example":30},"churnRisk":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"expansionOpportunity":{"type":"string","enum":["unknown","low","medium","high"],"example":"medium"},"competitiveThreats":{"type":"array","items":{"type":"string"},"example":["Competitor A"]},"industryTrends":{"type":"array","items":{"type":"string"},"example":["AI adoption","Cloud migration"]},"aiSummary":{"type":["string","null"],"example":"Strong account with expansion potential"},"aiRecommendations":{"type":"array","items":{"type":"string"},"example":["Upsell premium tier"]},"aiLastAnalyzed":{"type":["string","null"],"format":"date-time","example":"2026-01-01T08:00:00Z"},"customAttributes":{"type":"object","additionalProperties":{},"example":{"tier":"enterprise"}},"dataSources":{"type":"array","items":{"type":"string"},"example":["crm","billing"]},"confidenceScore":{"type":["integer","null"],"minimum":0,"maximum":100,"example":90},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"updatedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T12:00:00Z"}},"required":["id","organizationId","accountId","healthScore","engagementScore","growthPotential","revenueTrend","lastActivityDate","activityFrequency","keyContactsCount","activeDealsCount","lifetimeValue","averageDealSize","winRate","averageSalesCycle","churnRisk","expansionOpportunity","competitiveThreats","industryTrends","aiSummary","aiRecommendations","aiLastAnalyzed","customAttributes","dataSources","confidenceScore","createdAt","updatedAt"]},"GetAccountProfileResponse":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/AccountIntelligenceProfile"}},"required":["profile"]},"UpdateAccountIntelligenceRequest":{"type":"object","properties":{"healthScore":{"type":"integer","minimum":0,"maximum":100},"engagementScore":{"type":"integer","minimum":0,"maximum":100},"growthPotential":{"type":"string","enum":["unknown","low","medium","high","very_high"],"example":"high"},"revenueTrend":{"type":"string","enum":["declining","stable","growing","rapid_growth"],"example":"stable"},"activityFrequency":{"type":"string","enum":["unknown","daily","weekly","monthly","quarterly","rarely"],"example":"weekly"},"lifetimeValue":{"type":"number"},"churnRisk":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"expansionOpportunity":{"type":"string","enum":["unknown","low","medium","high"],"example":"medium"},"competitiveThreats":{"type":"array","items":{"type":"string"}},"industryTrends":{"type":"array","items":{"type":"string"}},"customAttributes":{"type":"object","additionalProperties":{}}}},"ClientProfile":{"type":"object","properties":{"id":{"type":"string","example":"client_abc123"},"organizationId":{"type":"string","example":"org_123"},"crmAccountId":{"type":["string","null"],"example":"acc_456"},"crmLeadId":{"type":["string","null"],"example":null},"name":{"type":"string","example":"Acme Corp"},"website":{"type":["string","null"],"example":"https://acme.com"},"industry":{"type":["string","null"],"example":"Technology"},"companySize":{"type":["string","null"],"enum":["startup","smb","mid_market","enterprise",null],"example":"smb"},"description":{"type":["string","null"],"example":"Leading provider of widgets"},"brandVoice":{"type":["string","null"],"enum":["professional","casual","technical","friendly","authoritative",null],"example":"professional"},"brandTone":{"type":["array","null"],"items":{"type":"string"},"example":["confident","innovative"]},"brandColors":{"type":["array","null"],"items":{"type":"string"},"example":["#FF6600","#000000"]},"logoUrl":{"type":["string","null"],"example":"https://acme.com/logo.png"},"tagline":{"type":["string","null"],"example":"Building the future"},"linkedinUrl":{"type":["string","null"],"example":"https://linkedin.com/company/acme"},"twitterUrl":{"type":["string","null"],"example":"https://twitter.com/acme"},"facebookUrl":{"type":["string","null"],"example":null},"instagramUrl":{"type":["string","null"],"example":null},"tiktokUrl":{"type":["string","null"],"example":null},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"],"example":"basic"},"lastResearchedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T10:00:00Z"},"researchConfidence":{"type":["integer","null"],"minimum":0,"maximum":100,"example":75},"researchSources":{"type":["array","null"],"items":{"type":"string"},"example":["https://acme.com"]},"aiSummary":{"type":["string","null"],"example":"Tech company focused on B2B solutions"},"aiKeyInsights":{"type":["array","null"],"items":{"type":"string"},"example":["Fast-growing","Enterprise focus"]},"aiLastAnalyzed":{"type":["string","null"],"format":"date-time","example":"2026-01-01T08:00:00Z"},"tags":{"type":["array","null"],"items":{"type":"string"},"example":["priority","tech"]},"notes":{"type":["string","null"],"example":"Key account for Q1"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"updatedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T12:00:00Z"}},"required":["id","organizationId","crmAccountId","crmLeadId","name","website","industry","companySize","description","brandVoice","brandTone","brandColors","logoUrl","tagline","linkedinUrl","twitterUrl","facebookUrl","instagramUrl","tiktokUrl","researchLevel","lastResearchedAt","researchConfidence","researchSources","aiSummary","aiKeyInsights","aiLastAnalyzed","tags","notes","createdAt","updatedAt"]},"CreateClientProfile":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"crmAccountId":{"type":"string"},"crmLeadId":{"type":"string"},"website":{"type":"string","format":"uri"},"industry":{"type":"string"},"companySize":{"type":"string","enum":["startup","smb","mid_market","enterprise"],"example":"smb"},"description":{"type":"string"},"brandVoice":{"type":"string","enum":["professional","casual","technical","friendly","authoritative"],"example":"professional"},"brandTone":{"type":"array","items":{"type":"string"}},"brandColors":{"type":"array","items":{"type":"string"}},"logoUrl":{"type":"string","format":"uri"},"tagline":{"type":"string"},"linkedinUrl":{"type":"string","format":"uri"},"twitterUrl":{"type":"string","format":"uri"},"facebookUrl":{"type":"string","format":"uri"},"instagramUrl":{"type":"string","format":"uri"},"tiktokUrl":{"type":"string","format":"uri"},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}},"required":["name"]},"UpdateClientProfile":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"crmAccountId":{"type":["string","null"]},"crmLeadId":{"type":["string","null"]},"website":{"type":["string","null"],"format":"uri"},"industry":{"type":["string","null"]},"companySize":{"type":["string","null"],"enum":["startup","smb","mid_market","enterprise",null],"example":"smb"},"description":{"type":["string","null"]},"brandVoice":{"type":["string","null"],"enum":["professional","casual","technical","friendly","authoritative",null],"example":"professional"},"brandTone":{"type":["array","null"],"items":{"type":"string"}},"brandColors":{"type":["array","null"],"items":{"type":"string"}},"logoUrl":{"type":["string","null"],"format":"uri"},"tagline":{"type":["string","null"]},"linkedinUrl":{"type":["string","null"],"format":"uri"},"twitterUrl":{"type":["string","null"],"format":"uri"},"facebookUrl":{"type":["string","null"],"format":"uri"},"instagramUrl":{"type":["string","null"],"format":"uri"},"tiktokUrl":{"type":["string","null"],"format":"uri"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]}}},"ClientRestriction":{"type":"object","properties":{"id":{"type":"string","example":"restr_abc123"},"clientProfileId":{"type":"string","example":"client_456"},"organizationId":{"type":"string","example":"org_123"},"type":{"type":"string","enum":["phrase","claim","visual","topic","competitor","other"],"example":"phrase"},"pattern":{"type":"string","example":"guaranteed results"},"patternType":{"type":"string","enum":["exact","contains","regex","semantic"],"example":"contains"},"description":{"type":["string","null"],"example":"Client explicitly prohibits guarantee language"},"severity":{"type":"string","enum":["info","warning","error","block"],"example":"error"},"source":{"type":"string","enum":["meeting","email","chat","manual","research","approval_rejection"],"example":"meeting"},"sourceId":{"type":["string","null"],"example":"meeting_789"},"sourceSpeaker":{"type":["string","null"],"example":"Jane Smith (CMO)"},"sourceTimestamp":{"type":["string","null"],"format":"date-time","example":"2026-01-01T14:00:00Z"},"sourceQuote":{"type":["string","null"],"example":"We can never say guaranteed in our marketing"},"confidence":{"type":"integer","minimum":0,"maximum":100,"example":100},"isVerified":{"type":"boolean","example":true},"verifiedBy":{"type":["string","null"],"example":"user_123"},"verifiedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-02T10:00:00Z"},"isActive":{"type":"boolean","example":true},"expiresAt":{"type":["string","null"],"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"updatedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T12:00:00Z"}},"required":["id","clientProfileId","organizationId","type","pattern","patternType","description","severity","source","sourceId","sourceSpeaker","sourceTimestamp","sourceQuote","confidence","isVerified","verifiedBy","verifiedAt","isActive","expiresAt","createdAt","updatedAt"]},"CreateClientRestriction":{"type":"object","properties":{"type":{"type":"string","enum":["phrase","claim","visual","topic","competitor","other"],"example":"phrase"},"pattern":{"type":"string","minLength":1},"patternType":{"type":"string","enum":["exact","contains","regex","semantic"],"default":"exact","example":"contains"},"description":{"type":"string"},"severity":{"type":"string","enum":["info","warning","error","block"],"default":"warning","example":"warning"},"source":{"type":"string","enum":["meeting","email","chat","manual","research","approval_rejection"],"example":"manual"},"sourceId":{"type":"string"},"sourceSpeaker":{"type":"string"},"sourceTimestamp":{"type":"string","format":"date-time"},"sourceQuote":{"type":"string"},"confidence":{"type":"integer","minimum":0,"maximum":100,"default":100},"expiresAt":{"type":"string","format":"date-time"}},"required":["type","pattern","source"]},"UpdateClientRestriction":{"type":"object","properties":{"type":{"type":"string","enum":["phrase","claim","visual","topic","competitor","other"],"example":"phrase"},"pattern":{"type":"string","minLength":1},"patternType":{"type":"string","enum":["exact","contains","regex","semantic"],"example":"contains"},"description":{"type":["string","null"]},"severity":{"type":"string","enum":["info","warning","error","block"],"example":"warning"},"confidence":{"type":"integer","minimum":0,"maximum":100},"isVerified":{"type":"boolean"},"isActive":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"}}},"ClientPreference":{"type":"object","properties":{"id":{"type":"string","example":"pref_abc123"},"clientProfileId":{"type":"string","example":"client_456"},"organizationId":{"type":"string","example":"org_123"},"category":{"type":"string","enum":["visual","copy","format","timing","channel","other"],"example":"copy"},"subcategory":{"type":["string","null"],"example":"headline_length"},"preference":{"type":"string","example":"Short headlines under 6 words"},"preferenceValue":{"example":{"maxWords":6}},"source":{"type":"string","enum":["explicit","learned","imported","inferred"],"example":"explicit"},"approvalRate":{"type":["number","null"],"minimum":0,"maximum":1,"example":0.85},"sampleSize":{"type":"integer","example":20},"confidence":{"type":"integer","minimum":0,"maximum":100,"example":90},"sourceId":{"type":["string","null"],"example":"meeting_789"},"sourceQuote":{"type":["string","null"],"example":"We prefer short, punchy headlines"},"isActive":{"type":"boolean","example":true},"lastObservedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-05T10:00:00Z"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"updatedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T12:00:00Z"}},"required":["id","clientProfileId","organizationId","category","subcategory","preference","source","approvalRate","sampleSize","confidence","sourceId","sourceQuote","isActive","lastObservedAt","createdAt","updatedAt"]},"CreateClientPreference":{"type":"object","properties":{"category":{"type":"string","enum":["visual","copy","format","timing","channel","other"],"example":"copy"},"subcategory":{"type":"string"},"preference":{"type":"string","minLength":1},"preferenceValue":{},"source":{"type":"string","enum":["explicit","learned","imported","inferred"],"example":"explicit"},"approvalRate":{"type":"number","minimum":0,"maximum":1},"sampleSize":{"type":"integer","default":0},"confidence":{"type":"integer","minimum":0,"maximum":100,"default":50},"sourceId":{"type":"string"},"sourceQuote":{"type":"string"}},"required":["category","preference","source"]},"UpdateClientPreference":{"type":"object","properties":{"category":{"type":"string","enum":["visual","copy","format","timing","channel","other"],"example":"copy"},"subcategory":{"type":["string","null"]},"preference":{"type":"string","minLength":1},"preferenceValue":{},"approvalRate":{"type":["number","null"],"minimum":0,"maximum":1},"sampleSize":{"type":"integer"},"confidence":{"type":"integer","minimum":0,"maximum":100},"isActive":{"type":"boolean"}}},"ResearchJob":{"type":"object","properties":{"id":{"type":"string","example":"job_abc123"},"organizationId":{"type":"string","example":"org_123"},"clientProfileId":{"type":"string","example":"client_456"},"researchLevel":{"type":"string","enum":["basic","standard","deep"],"example":"basic","description":"Depth of research: basic (website only), standard (+ social), deep (+ news/AI analysis)"},"requestedSources":{"type":["array","null"],"items":{"type":"string","enum":["website","linkedin","twitter","facebook","instagram","news","manual"],"example":"website"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"],"example":"processing"},"progress":{"type":"integer","minimum":0,"maximum":100,"example":45},"currentPhase":{"type":["string","null"],"example":"linkedin"},"phases":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["pending","processing","completed","failed","skipped"]},"example":{"website":"completed","linkedin":"processing"}},"queuedAt":{"type":"string","format":"date-time","example":"2026-01-01T10:00:00Z"},"startedAt":{"type":["string","null"],"format":"date-time","example":"2026-01-01T10:00:05Z"},"completedAt":{"type":["string","null"],"format":"date-time"},"estimatedDuration":{"type":["number","null"],"example":120,"description":"Seconds"},"sourcesScanned":{"type":"integer","example":3},"dataPointsExtracted":{"type":"integer","example":12},"confidenceScore":{"type":["integer","null"],"minimum":0,"maximum":100,"example":85},"errorMessage":{"type":["string","null"]},"errorCode":{"type":["string","null"]},"retryCount":{"type":"integer","example":0},"maxRetries":{"type":"integer","example":3},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","organizationId","clientProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","sourcesScanned","dataPointsExtracted","confidenceScore","errorMessage","errorCode","retryCount","maxRetries","createdAt","updatedAt"]},"TriggerResearch":{"type":"object","properties":{"researchLevel":{"type":"string","enum":["basic","standard","deep"],"default":"basic","example":"basic","description":"Depth of research: basic (website only), standard (+ social), deep (+ news/AI analysis)"},"sources":{"type":"array","items":{"type":"string","enum":["website","linkedin","twitter","facebook","instagram","news","manual"],"example":"website"}},"force":{"type":"boolean","default":false,"description":"Force re-research even if recently researched"}}},"ResearchResult":{"type":"object","properties":{"id":{"type":"string","example":"result_abc123"},"organizationId":{"type":"string","example":"org_123"},"researchJobId":{"type":"string","example":"job_456"},"clientProfileId":{"type":"string","example":"client_789"},"source":{"type":"string","enum":["website","linkedin","twitter","facebook","instagram","news","manual"],"example":"website"},"sourceUrl":{"type":["string","null"],"example":"https://acme.com"},"sourceTitle":{"type":["string","null"],"example":"Acme Corp - Home"},"scrapedAt":{"type":["string","null"],"format":"date-time"},"dataType":{"type":"string","enum":["company_info","brand_colors","logo","social_profile","contact","news","other"],"example":"company_info"},"fieldName":{"type":"string","example":"tagline"},"extractedValue":{"example":"Building the future"},"previousValue":{},"confidence":{"type":"integer","minimum":0,"maximum":100,"example":90},"extractionMethod":{"type":["string","null"],"enum":["scraper","ai","api","manual",null],"example":"scraper"},"isVerified":{"type":"boolean","example":false},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["string","null"],"format":"date-time"},"isApplied":{"type":"boolean","example":false},"appliedAt":{"type":["string","null"],"format":"date-time"},"appliedBy":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","organizationId","researchJobId","clientProfileId","source","sourceUrl","sourceTitle","scrapedAt","dataType","fieldName","confidence","extractionMethod","isVerified","verifiedBy","verifiedAt","isApplied","appliedAt","appliedBy","createdAt"]},"AggregationJobResult":{"type":"object","properties":{"success":{"type":"boolean"},"benchmarksCreated":{"type":"number"},"benchmarksUpdated":{"type":"number"},"skippedDueToKAnonymity":{"type":"number"},"errors":{"type":"array","items":{"type":"string"}},"duration":{"type":"number"},"completedAt":{"type":"number"}},"required":["success","benchmarksCreated","benchmarksUpdated","skippedDueToKAnonymity","errors","duration","completedAt"]},"RunAggregationJobInput":{"type":"object","properties":{"periodTypes":{"type":"array","items":{"type":"string","enum":["month","quarter","year","all_time"]},"description":"Period types to aggregate (defaults to all)","example":["month","quarter"]},"platforms":{"type":"array","items":{"type":"string"},"description":"Platforms to aggregate (defaults to all)","example":["meta","tiktok"]},"verticals":{"type":"array","items":{"type":"string"},"description":"Verticals to aggregate (defaults to all)","example":["supplements","ecommerce"]},"creativeTypes":{"type":"array","items":{"type":"string"},"description":"Creative types to aggregate (defaults to all)","example":["ugc","video"]}}},"AggregationResult":{"type":["object","null"],"properties":{"benchmarkId":{"type":"string"},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"]},"timePeriod":{"type":"string"},"periodType":{"type":"string"},"sampleSize":{"type":"number"},"campaignCount":{"type":"number"},"organizationCount":{"type":"number"},"meetsKThreshold":{"type":"boolean"},"kThreshold":{"type":"number"},"calculatedAt":{"type":"number"}},"required":["benchmarkId","platform","vertical","subVertical","creativeType","timePeriod","periodType","sampleSize","campaignCount","organizationCount","meetsKThreshold","kThreshold","calculatedAt"]},"CalculateBenchmarkInput":{"type":"object","properties":{"platform":{"type":"string","description":"Filter by platform","example":"meta"},"vertical":{"type":"string","description":"Filter by vertical","example":"supplements"},"subVertical":{"type":"string","description":"Filter by sub-vertical","example":"protein_supplements"},"creativeType":{"type":"string","description":"Filter by creative type","example":"ugc"},"timePeriod":{"type":"string","description":"Time period (YYYY-MM, YYYY-Qn, YYYY, or all_time)","example":"2026-01"},"periodType":{"type":"string","enum":["month","quarter","year","all_time"],"description":"Period type","example":"month"}},"required":["timePeriod","periodType"]},"AggregationStats":{"type":"object","properties":{"totalBenchmarks":{"type":"number"},"staleBenchmarks":{"type":"number"},"benchmarksByPeriodType":{"type":"object","additionalProperties":{"type":"number"}},"benchmarksByPlatform":{"type":"object","additionalProperties":{"type":"number"}},"benchmarksByVertical":{"type":"object","additionalProperties":{"type":"number"}},"lastCalculatedAt":{"type":["number","null"]},"excludedOrganizations":{"type":"number"}},"required":["totalBenchmarks","staleBenchmarks","benchmarksByPeriodType","benchmarksByPlatform","benchmarksByVertical","lastCalculatedAt","excludedOrganizations"]},"MarkStaleResult":{"type":"object","properties":{"success":{"type":"boolean"},"markedCount":{"type":"number"}},"required":["success","markedCount"]},"MarkStaleInput":{"type":"object","properties":{"platform":{"type":"string","description":"Filter by platform"},"vertical":{"type":"string","description":"Filter by vertical"},"creativeType":{"type":"string","description":"Filter by creative type"}}}},"parameters":{}},"paths":{"/engagement/contacts":{"get":{"operationId":"listContactProfiles","summary":"List contact intelligence profiles","description":"Get paginated list of contact intelligence profiles with filtering","tags":["Engagement - Contacts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","example":"John"},"required":false,"name":"search","in":"query"},{"schema":{"type":"string","enum":["unknown","new","engaged","active","at_risk","churned","won_back"],"example":"engaged"},"required":false,"name":"lifecycleStage","in":"query"},{"schema":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"required":false,"name":"churnRisk","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":100},"required":false,"name":"minEngagementScore","in":"query"}],"responses":{"200":{"description":"Contact profiles retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListContactProfilesResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/contacts/{contactId}":{"get":{"operationId":"getContactProfile","summary":"Get contact intelligence profile","description":"Get intelligence profile for a specific contact","tags":["Engagement - Contacts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Contact profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContactProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"updateContactProfile","summary":"Update contact intelligence profile","description":"Update intelligence metrics for a contact","tags":["Engagement - Contacts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"requestBody":{"description":"Profile updates","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContactIntelligenceRequest"}}}},"responses":{"200":{"description":"Updated profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContactProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/contacts/{contactId}/analyze":{"post":{"operationId":"analyzeContact","summary":"Trigger AI analysis for contact","description":"Run AI analysis to update contact intelligence profile","tags":["Engagement - Contacts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Analyzed profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContactProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/contacts/{contactId}/sync":{"post":{"operationId":"syncContactFromCrm","summary":"Sync contact intelligence from CRM","description":"Upsert a contact intelligence profile from CRM-derived activity and contact signals","tags":["Engagement - Contacts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"requestBody":{"description":"CRM-derived intelligence payload","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncContactIntelligenceFromCrmRequest"}}}},"responses":{"200":{"description":"Synced profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContactProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/accounts":{"get":{"operationId":"listAccountProfiles","summary":"List account intelligence profiles","description":"Get paginated list of account intelligence profiles with filtering","tags":["Engagement - Accounts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","example":"Acme"},"required":false,"name":"search","in":"query"},{"schema":{"type":"string","enum":["unknown","low","medium","high","very_high"],"example":"high"},"required":false,"name":"growthPotential","in":"query"},{"schema":{"type":"string","enum":["unknown","low","medium","high","critical"],"example":"low"},"required":false,"name":"churnRisk","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":100},"required":false,"name":"minHealthScore","in":"query"}],"responses":{"200":{"description":"Account profiles retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAccountProfilesResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/accounts/{accountId}":{"get":{"operationId":"getAccountProfile","summary":"Get account intelligence profile","description":"Get intelligence profile for a specific account","tags":["Engagement - Accounts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"acc_abc123"},"required":true,"name":"accountId","in":"path"}],"responses":{"200":{"description":"Account profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Account not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"updateAccountProfile","summary":"Update account intelligence profile","description":"Update intelligence metrics for an account","tags":["Engagement - Accounts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"acc_abc123"},"required":true,"name":"accountId","in":"path"}],"requestBody":{"description":"Profile updates","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountIntelligenceRequest"}}}},"responses":{"200":{"description":"Updated profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Account not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/engagement/accounts/{accountId}/analyze":{"post":{"operationId":"analyzeAccount","summary":"Trigger AI analysis for account","description":"Run AI analysis to update account intelligence profile","tags":["Engagement - Accounts"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"acc_abc123"},"required":true,"name":"accountId","in":"path"}],"responses":{"200":{"description":"Analyzed profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountProfileResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Account not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles":{"get":{"operationId":"listClientProfiles","summary":"List client profiles","description":"Get paginated list of client profiles with filtering","tags":["Client Intelligence - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Search by name"},"required":false,"description":"Search by name","name":"search","in":"query"},{"schema":{"type":"string"},"required":false,"name":"industry","in":"query"},{"schema":{"type":"string","enum":["startup","smb","mid_market","enterprise"],"example":"smb"},"required":false,"name":"companySize","in":"query"},{"schema":{"type":"string","enum":["none","basic","standard","deep"],"example":"basic"},"required":false,"name":"researchLevel","in":"query"},{"schema":{"type":"string"},"required":false,"name":"crmAccountId","in":"query"}],"responses":{"200":{"description":"Client profiles retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"profiles":{"type":"array","items":{"$ref":"#/components/schemas/ClientProfile"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"}},"required":["profiles","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"createClientProfile","summary":"Create client profile","description":"Create a new client profile for intelligence tracking","tags":["Client Intelligence - Profiles"],"security":[{"Bearer":[]}],"requestBody":{"description":"Client profile data","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientProfile"}}}},"responses":{"201":{"description":"Client profile created","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/ClientProfile"}},"required":["profile"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Client already exists","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}":{"get":{"operationId":"getClientProfile","summary":"Get client profile","description":"Get a specific client profile by ID","tags":["Client Intelligence - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"responses":{"200":{"description":"Client profile","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/ClientProfile"}},"required":["profile"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"updateClientProfile","summary":"Update client profile","description":"Update an existing client profile","tags":["Client Intelligence - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"requestBody":{"description":"Profile updates","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClientProfile"}}}},"responses":{"200":{"description":"Client profile updated","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/ClientProfile"}},"required":["profile"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"deleteClientProfile","summary":"Delete client profile","description":"Soft delete a client profile and all related data","tags":["Client Intelligence - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"responses":{"200":{"description":"Client profile deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}/restrictions":{"get":{"operationId":"listClientRestrictions","summary":"List client restrictions","description":"Get all restrictions for a client","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["phrase","claim","visual","topic","competitor","other"],"example":"phrase"},"required":false,"name":"type","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isActive","in":"query"},{"schema":{"type":"string","enum":["info","warning","error","block"],"example":"warning"},"required":false,"name":"severity","in":"query"}],"responses":{"200":{"description":"Restrictions retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"restrictions":{"type":"array","items":{"$ref":"#/components/schemas/ClientRestriction"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"}},"required":["restrictions","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"createClientRestriction","summary":"Create client restriction","description":"Add a new restriction for a client","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"requestBody":{"description":"Restriction data","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientRestriction"}}}},"responses":{"201":{"description":"Restriction created","content":{"application/json":{"schema":{"type":"object","properties":{"restriction":{"$ref":"#/components/schemas/ClientRestriction"}},"required":["restriction"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}/restrictions/{restrictionId}":{"get":{"operationId":"getClientRestriction","summary":"Get client restriction","description":"Get a specific restriction by ID","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"restr_abc123"},"required":true,"name":"restrictionId","in":"path"}],"responses":{"200":{"description":"Restriction","content":{"application/json":{"schema":{"type":"object","properties":{"restriction":{"$ref":"#/components/schemas/ClientRestriction"}},"required":["restriction"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Restriction not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"updateClientRestriction","summary":"Update client restriction","description":"Update an existing restriction","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"restr_abc123"},"required":true,"name":"restrictionId","in":"path"}],"requestBody":{"description":"Restriction updates","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClientRestriction"}}}},"responses":{"200":{"description":"Restriction updated","content":{"application/json":{"schema":{"type":"object","properties":{"restriction":{"$ref":"#/components/schemas/ClientRestriction"}},"required":["restriction"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Restriction not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"deleteClientRestriction","summary":"Delete client restriction","description":"Soft delete a restriction","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"restr_abc123"},"required":true,"name":"restrictionId","in":"path"}],"responses":{"200":{"description":"Restriction deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Restriction not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}/restrictions/{restrictionId}/verify":{"post":{"operationId":"verifyClientRestriction","summary":"Verify client restriction","description":"Mark a restriction as verified by a human","tags":["Client Intelligence - Restrictions"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"restr_abc123"},"required":true,"name":"restrictionId","in":"path"}],"responses":{"200":{"description":"Restriction verified","content":{"application/json":{"schema":{"type":"object","properties":{"restriction":{"$ref":"#/components/schemas/ClientRestriction"}},"required":["restriction"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Restriction not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}/preferences":{"get":{"operationId":"listClientPreferences","summary":"List client preferences","description":"Get all preferences for a client","tags":["Client Intelligence - Preferences"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["visual","copy","format","timing","channel","other"],"example":"copy"},"required":false,"name":"category","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isActive","in":"query"}],"responses":{"200":{"description":"Preferences retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"array","items":{"$ref":"#/components/schemas/ClientPreference"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"}},"required":["preferences","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"createClientPreference","summary":"Create client preference","description":"Add a new preference for a client","tags":["Client Intelligence - Preferences"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"requestBody":{"description":"Preference data","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientPreference"}}}},"responses":{"201":{"description":"Preference created","content":{"application/json":{"schema":{"type":"object","properties":{"preference":{"$ref":"#/components/schemas/ClientPreference"}},"required":["preference"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/clients/profiles/{clientId}/preferences/{preferenceId}":{"get":{"operationId":"getClientPreference","summary":"Get client preference","description":"Get a specific preference by ID","tags":["Client Intelligence - Preferences"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"pref_abc123"},"required":true,"name":"preferenceId","in":"path"}],"responses":{"200":{"description":"Preference","content":{"application/json":{"schema":{"type":"object","properties":{"preference":{"$ref":"#/components/schemas/ClientPreference"}},"required":["preference"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Preference not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"updateClientPreference","summary":"Update client preference","description":"Update an existing preference","tags":["Client Intelligence - Preferences"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"pref_abc123"},"required":true,"name":"preferenceId","in":"path"}],"requestBody":{"description":"Preference updates","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClientPreference"}}}},"responses":{"200":{"description":"Preference updated","content":{"application/json":{"schema":{"type":"object","properties":{"preference":{"$ref":"#/components/schemas/ClientPreference"}},"required":["preference"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Preference not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"deleteClientPreference","summary":"Delete client preference","description":"Soft delete a preference","tags":["Client Intelligence - Preferences"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"string","example":"pref_abc123"},"required":true,"name":"preferenceId","in":"path"}],"responses":{"200":{"description":"Preference deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Preference not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//clients/{clientId}/research":{"post":{"tags":["Research Engine"],"summary":"Trigger research for a client","description":"Queue a research job to gather intelligence about a client from web sources","parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerResearch"}}}},"responses":{"201":{"description":"Research job created","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"$ref":"#/components/schemas/ResearchJob"},"message":{"type":"string","example":"Research job queued successfully"}},"required":["job","message"]}}}},"400":{"description":"Invalid request (e.g., research already in progress)"},"404":{"description":"Client profile not found"}}}},"//clients/{clientId}/research/status":{"get":{"tags":["Research Engine"],"summary":"Get research status for a client","description":"Check the status of active or most recent research job","parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"responses":{"200":{"description":"Research status retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"allOf":[{"$ref":"#/components/schemas/ResearchJob"},{"type":["object","null"]}]},"hasActiveJob":{"type":"boolean"},"lastCompletedJob":{"allOf":[{"$ref":"#/components/schemas/ResearchJob"},{"type":["object","null"]}]}},"required":["job","hasActiveJob","lastCompletedJob"]}}}},"404":{"description":"Client profile not found"}}}},"//clients/{clientId}/research/cancel":{"post":{"tags":["Research Engine"],"summary":"Cancel active research job","description":"Cancel a queued or processing research job","parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"responses":{"200":{"description":"Research job cancelled","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"$ref":"#/components/schemas/ResearchJob"},"message":{"type":"string","example":"Research job cancelled"}},"required":["job","message"]}}}},"400":{"description":"No active research job to cancel"},"404":{"description":"Client profile not found"}}}},"//research/jobs":{"get":{"tags":["Research Engine"],"summary":"List research jobs","description":"List all research jobs with optional filters","parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["queued","processing","completed","failed","cancelled"],"example":"processing"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"}],"responses":{"200":{"description":"Research jobs retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"$ref":"#/components/schemas/ResearchJob"}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["jobs","total","page","limit"]}}}}}}},"//research/jobs/{jobId}":{"get":{"tags":["Research Engine"],"summary":"Get research job details","description":"Get detailed information about a specific research job","parameters":[{"schema":{"type":"string","example":"job_abc123"},"required":true,"name":"jobId","in":"path"}],"responses":{"200":{"description":"Research job retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"$ref":"#/components/schemas/ResearchJob"}},"required":["job"]}}}},"404":{"description":"Research job not found"}}}},"//clients/{clientId}/research/results":{"get":{"tags":["Research Engine"],"summary":"List research results","description":"List extracted data from research jobs for a client","parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"},{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"jobId","in":"query"},{"schema":{"type":"string","enum":["website","linkedin","twitter","facebook","instagram","news","manual"],"example":"website"},"required":false,"name":"source","in":"query"},{"schema":{"type":"string","enum":["company_info","brand_colors","logo","social_profile","contact","news","other"],"example":"company_info"},"required":false,"name":"dataType","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isApplied","in":"query"}],"responses":{"200":{"description":"Research results retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/ResearchResult"}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["results","total","page","limit"]}}}},"404":{"description":"Client profile not found"}}}},"//clients/{clientId}/research/apply":{"post":{"tags":["Research Engine"],"summary":"Apply research results","description":"Apply extracted research data to the client profile","parameters":[{"schema":{"type":"string","example":"client_abc123"},"required":true,"name":"clientId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"resultIds":{"type":"array","items":{"type":"string"},"minItems":1,"example":["result_abc","result_def"]}},"required":["resultIds"]}}}},"responses":{"200":{"description":"Results applied successfully","content":{"application/json":{"schema":{"type":"object","properties":{"appliedCount":{"type":"integer"},"skippedCount":{"type":"integer"},"message":{"type":"string"}},"required":["appliedCount","skippedCount","message"]}}}},"400":{"description":"Invalid request"},"404":{"description":"Client profile or results not found"}}}},"/products":{"get":{"tags":["Product Intelligence"],"summary":"List product profiles","description":"List all product profiles for the organization with filtering and pagination.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string","enum":["active","discontinued","coming_soon"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["consumer","professional","enterprise","industrial"]},"required":false,"name":"targetMarket","in":"query"},{"schema":{"type":"string","enum":["budget","mid_range","premium","luxury"]},"required":false,"name":"priceRange","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"Product profiles list","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"crmProductId":{"type":["string","null"]},"name":{"type":"string"},"sku":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"shortDescription":{"type":["string","null"]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":["array","null"],"items":{"type":"string"}},"price":{"type":["number","null"]},"currency":{"type":"string"},"priceRange":{"type":["string","null"],"enum":["budget","mid_range","premium","luxury",null]},"msrp":{"type":["number","null"]},"variants":{"type":["array","null"],"items":{"type":"object","additionalProperties":{}}},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"videoUrls":{"type":["array","null"],"items":{"type":"string"}},"targetMarket":{"type":["string","null"],"enum":["consumer","professional","enterprise","industrial",null]},"marketSegment":{"type":["string","null"]},"positioning":{"type":["string","null"]},"aiSellingPoints":{"type":["array","null"],"items":{"type":"string"}},"aiTargetAudience":{"type":["object","null"],"additionalProperties":{}},"aiMessagingAngles":{"type":["array","null"],"items":{"type":"string"}},"aiCompetitiveAdvantages":{"type":["array","null"],"items":{"type":"string"}},"aiWeaknesses":{"type":["array","null"],"items":{"type":"string"}},"aiKeywords":{"type":["array","null"],"items":{"type":"string"}},"aiSummary":{"type":["string","null"]},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSummary":{"type":["string","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"number"}},"complianceCategory":{"type":["string","null"],"enum":["supplement","medical","financial","alcohol","tobacco","general",null]},"complianceNotes":{"type":["array","null"],"items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean"},"disclaimerText":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"launchDate":{"type":["number","null"]},"discontinuedDate":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","crmProductId","name","sku","category","subcategory","description","shortDescription","specifications","features","dimensions","materials","price","currency","priceRange","msrp","variants","productUrl","amazonUrl","imageUrls","videoUrls","targetMarket","marketSegment","positioning","aiSellingPoints","aiTargetAudience","aiMessagingAngles","aiCompetitiveAdvantages","aiWeaknesses","aiKeywords","aiSummary","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","avgRating","reviewCount","reviewSummary","reviewSources","complianceCategory","complianceNotes","requiresDisclaimer","disclaimerText","status","launchDate","discontinuedDate","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["products","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Product Intelligence"],"summary":"Create product profile","description":"Create a new product profile for a client.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","minLength":1},"crmProductId":{"type":"string"},"name":{"type":"string","minLength":1},"sku":{"type":"string"},"category":{"type":"string"},"subcategory":{"type":"string"},"description":{"type":"string"},"shortDescription":{"type":"string"},"specifications":{"type":"object","additionalProperties":{}},"features":{"type":"array","items":{"type":"string"}},"dimensions":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":"array","items":{"type":"string"}},"price":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"priceRange":{"type":"string","enum":["budget","mid_range","premium","luxury"]},"msrp":{"type":"number","exclusiveMinimum":0},"productUrl":{"type":"string","format":"uri"},"amazonUrl":{"type":"string","format":"uri"},"imageUrls":{"type":"array","items":{"type":"string","format":"uri"}},"videoUrls":{"type":"array","items":{"type":"string","format":"uri"}},"targetMarket":{"type":"string","enum":["consumer","professional","enterprise","industrial"]},"marketSegment":{"type":"string"},"positioning":{"type":"string"},"complianceCategory":{"type":"string","enum":["supplement","medical","financial","alcohol","tobacco","general"]},"complianceNotes":{"type":"array","items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean","default":false},"disclaimerText":{"type":"string"},"status":{"type":"string","enum":["active","discontinued","coming_soon"],"default":"active"},"launchDate":{"type":"number"},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}},"required":["clientProfileId","name"]}}}},"responses":{"201":{"description":"Product created","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"crmProductId":{"type":["string","null"]},"name":{"type":"string"},"sku":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"shortDescription":{"type":["string","null"]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":["array","null"],"items":{"type":"string"}},"price":{"type":["number","null"]},"currency":{"type":"string"},"priceRange":{"type":["string","null"],"enum":["budget","mid_range","premium","luxury",null]},"msrp":{"type":["number","null"]},"variants":{"type":["array","null"],"items":{"type":"object","additionalProperties":{}}},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"videoUrls":{"type":["array","null"],"items":{"type":"string"}},"targetMarket":{"type":["string","null"],"enum":["consumer","professional","enterprise","industrial",null]},"marketSegment":{"type":["string","null"]},"positioning":{"type":["string","null"]},"aiSellingPoints":{"type":["array","null"],"items":{"type":"string"}},"aiTargetAudience":{"type":["object","null"],"additionalProperties":{}},"aiMessagingAngles":{"type":["array","null"],"items":{"type":"string"}},"aiCompetitiveAdvantages":{"type":["array","null"],"items":{"type":"string"}},"aiWeaknesses":{"type":["array","null"],"items":{"type":"string"}},"aiKeywords":{"type":["array","null"],"items":{"type":"string"}},"aiSummary":{"type":["string","null"]},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSummary":{"type":["string","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"number"}},"complianceCategory":{"type":["string","null"],"enum":["supplement","medical","financial","alcohol","tobacco","general",null]},"complianceNotes":{"type":["array","null"],"items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean"},"disclaimerText":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"launchDate":{"type":["number","null"]},"discontinuedDate":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","crmProductId","name","sku","category","subcategory","description","shortDescription","specifications","features","dimensions","materials","price","currency","priceRange","msrp","variants","productUrl","amazonUrl","imageUrls","videoUrls","targetMarket","marketSegment","positioning","aiSellingPoints","aiTargetAudience","aiMessagingAngles","aiCompetitiveAdvantages","aiWeaknesses","aiKeywords","aiSummary","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","avgRating","reviewCount","reviewSummary","reviewSources","complianceCategory","complianceNotes","requiresDisclaimer","disclaimerText","status","launchDate","discontinuedDate","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["product"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/research-jobs":{"get":{"tags":["Product Research"],"summary":"List research jobs","description":"List all product research jobs for the organization.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"productProfileId","in":"query"}],"responses":{"200":{"description":"Research jobs list","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"requestedSources":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"currentPhase":{"type":["string","null"]},"phases":{"type":["object","null"],"additionalProperties":{"type":"string"}},"queuedAt":{"type":"number"},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"resultSummary":{"type":["string","null"]},"dataExtracted":{"type":["number","null"]},"confidence":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","productProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","resultSummary","dataExtracted","confidence","errorMessage","createdBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["jobs","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}":{"get":{"tags":["Product Intelligence"],"summary":"Get product profile","description":"Get a specific product profile by ID.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"responses":{"200":{"description":"Product profile","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"crmProductId":{"type":["string","null"]},"name":{"type":"string"},"sku":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"shortDescription":{"type":["string","null"]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":["array","null"],"items":{"type":"string"}},"price":{"type":["number","null"]},"currency":{"type":"string"},"priceRange":{"type":["string","null"],"enum":["budget","mid_range","premium","luxury",null]},"msrp":{"type":["number","null"]},"variants":{"type":["array","null"],"items":{"type":"object","additionalProperties":{}}},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"videoUrls":{"type":["array","null"],"items":{"type":"string"}},"targetMarket":{"type":["string","null"],"enum":["consumer","professional","enterprise","industrial",null]},"marketSegment":{"type":["string","null"]},"positioning":{"type":["string","null"]},"aiSellingPoints":{"type":["array","null"],"items":{"type":"string"}},"aiTargetAudience":{"type":["object","null"],"additionalProperties":{}},"aiMessagingAngles":{"type":["array","null"],"items":{"type":"string"}},"aiCompetitiveAdvantages":{"type":["array","null"],"items":{"type":"string"}},"aiWeaknesses":{"type":["array","null"],"items":{"type":"string"}},"aiKeywords":{"type":["array","null"],"items":{"type":"string"}},"aiSummary":{"type":["string","null"]},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSummary":{"type":["string","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"number"}},"complianceCategory":{"type":["string","null"],"enum":["supplement","medical","financial","alcohol","tobacco","general",null]},"complianceNotes":{"type":["array","null"],"items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean"},"disclaimerText":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"launchDate":{"type":["number","null"]},"discontinuedDate":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","crmProductId","name","sku","category","subcategory","description","shortDescription","specifications","features","dimensions","materials","price","currency","priceRange","msrp","variants","productUrl","amazonUrl","imageUrls","videoUrls","targetMarket","marketSegment","positioning","aiSellingPoints","aiTargetAudience","aiMessagingAngles","aiCompetitiveAdvantages","aiWeaknesses","aiKeywords","aiSummary","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","avgRating","reviewCount","reviewSummary","reviewSources","complianceCategory","complianceNotes","requiresDisclaimer","disclaimerText","status","launchDate","discontinuedDate","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["product"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Product Intelligence"],"summary":"Update product profile","description":"Update an existing product profile.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"crmProductId":{"type":"string"},"name":{"type":"string","minLength":1},"sku":{"type":"string"},"category":{"type":"string"},"subcategory":{"type":"string"},"description":{"type":"string"},"shortDescription":{"type":"string"},"specifications":{"type":"object","additionalProperties":{}},"features":{"type":"array","items":{"type":"string"}},"dimensions":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":"array","items":{"type":"string"}},"price":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"priceRange":{"type":"string","enum":["budget","mid_range","premium","luxury"]},"msrp":{"type":"number","exclusiveMinimum":0},"productUrl":{"type":"string","format":"uri"},"amazonUrl":{"type":"string","format":"uri"},"imageUrls":{"type":"array","items":{"type":"string","format":"uri"}},"videoUrls":{"type":"array","items":{"type":"string","format":"uri"}},"targetMarket":{"type":"string","enum":["consumer","professional","enterprise","industrial"]},"marketSegment":{"type":"string"},"positioning":{"type":"string"},"complianceCategory":{"type":"string","enum":["supplement","medical","financial","alcohol","tobacco","general"]},"complianceNotes":{"type":"array","items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean","default":false},"disclaimerText":{"type":"string"},"status":{"type":"string","enum":["active","discontinued","coming_soon"],"default":"active"},"launchDate":{"type":"number"},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}}}}}},"responses":{"200":{"description":"Product updated","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"crmProductId":{"type":["string","null"]},"name":{"type":"string"},"sku":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"shortDescription":{"type":["string","null"]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":["array","null"],"items":{"type":"string"}},"price":{"type":["number","null"]},"currency":{"type":"string"},"priceRange":{"type":["string","null"],"enum":["budget","mid_range","premium","luxury",null]},"msrp":{"type":["number","null"]},"variants":{"type":["array","null"],"items":{"type":"object","additionalProperties":{}}},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"videoUrls":{"type":["array","null"],"items":{"type":"string"}},"targetMarket":{"type":["string","null"],"enum":["consumer","professional","enterprise","industrial",null]},"marketSegment":{"type":["string","null"]},"positioning":{"type":["string","null"]},"aiSellingPoints":{"type":["array","null"],"items":{"type":"string"}},"aiTargetAudience":{"type":["object","null"],"additionalProperties":{}},"aiMessagingAngles":{"type":["array","null"],"items":{"type":"string"}},"aiCompetitiveAdvantages":{"type":["array","null"],"items":{"type":"string"}},"aiWeaknesses":{"type":["array","null"],"items":{"type":"string"}},"aiKeywords":{"type":["array","null"],"items":{"type":"string"}},"aiSummary":{"type":["string","null"]},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSummary":{"type":["string","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"number"}},"complianceCategory":{"type":["string","null"],"enum":["supplement","medical","financial","alcohol","tobacco","general",null]},"complianceNotes":{"type":["array","null"],"items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean"},"disclaimerText":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"launchDate":{"type":["number","null"]},"discontinuedDate":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","crmProductId","name","sku","category","subcategory","description","shortDescription","specifications","features","dimensions","materials","price","currency","priceRange","msrp","variants","productUrl","amazonUrl","imageUrls","videoUrls","targetMarket","marketSegment","positioning","aiSellingPoints","aiTargetAudience","aiMessagingAngles","aiCompetitiveAdvantages","aiWeaknesses","aiKeywords","aiSummary","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","avgRating","reviewCount","reviewSummary","reviewSources","complianceCategory","complianceNotes","requiresDisclaimer","disclaimerText","status","launchDate","discontinuedDate","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["product"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Product Intelligence"],"summary":"Delete product profile","description":"Soft delete a product profile.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"responses":{"200":{"description":"Product deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/variants":{"get":{"tags":["Product Variants"],"summary":"List product variants","description":"List all variants for a product.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"},{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["active","discontinued","coming_soon"]},"required":false,"name":"status","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"inStock","in":"query"}],"responses":{"200":{"description":"Product variants list","content":{"application/json":{"schema":{"type":"object","properties":{"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"sku":{"type":["string","null"]},"name":{"type":"string"},"attributes":{"type":["object","null"],"additionalProperties":{}},"price":{"type":["number","null"]},"currency":{"type":"string"},"inStock":{"type":"boolean"},"stockLevel":{"type":["string","null"],"enum":["in_stock","low_stock","out_of_stock",null]},"variantUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","productProfileId","sku","name","attributes","price","currency","inStock","stockLevel","variantUrl","imageUrl","status","createdAt","createdBy","updatedAt","updatedBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["variants","total","page","limit"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Product Variants"],"summary":"Create product variant","description":"Create a new variant for a product.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"name":{"type":"string","minLength":1},"attributes":{"type":"object","additionalProperties":{}},"price":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"inStock":{"type":"boolean","default":true},"stockLevel":{"type":"string","enum":["in_stock","low_stock","out_of_stock"]},"variantUrl":{"type":"string","format":"uri"},"imageUrl":{"type":"string","format":"uri"},"status":{"type":"string","enum":["active","discontinued","coming_soon"],"default":"active"}},"required":["name"]}}}},"responses":{"201":{"description":"Variant created","content":{"application/json":{"schema":{"type":"object","properties":{"variant":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"sku":{"type":["string","null"]},"name":{"type":"string"},"attributes":{"type":["object","null"],"additionalProperties":{}},"price":{"type":["number","null"]},"currency":{"type":"string"},"inStock":{"type":"boolean"},"stockLevel":{"type":["string","null"],"enum":["in_stock","low_stock","out_of_stock",null]},"variantUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","productProfileId","sku","name","attributes","price","currency","inStock","stockLevel","variantUrl","imageUrl","status","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["variant"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/variants/{variantId}":{"get":{"tags":["Product Variants"],"summary":"Get product variant","description":"Get a specific product variant by ID.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"variantId","in":"path"}],"responses":{"200":{"description":"Product variant","content":{"application/json":{"schema":{"type":"object","properties":{"variant":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"sku":{"type":["string","null"]},"name":{"type":"string"},"attributes":{"type":["object","null"],"additionalProperties":{}},"price":{"type":["number","null"]},"currency":{"type":"string"},"inStock":{"type":"boolean"},"stockLevel":{"type":["string","null"],"enum":["in_stock","low_stock","out_of_stock",null]},"variantUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","productProfileId","sku","name","attributes","price","currency","inStock","stockLevel","variantUrl","imageUrl","status","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["variant"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Product Variants"],"summary":"Update product variant","description":"Update an existing product variant.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"variantId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"name":{"type":"string","minLength":1},"attributes":{"type":"object","additionalProperties":{}},"price":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"inStock":{"type":"boolean","default":true},"stockLevel":{"type":"string","enum":["in_stock","low_stock","out_of_stock"]},"variantUrl":{"type":"string","format":"uri"},"imageUrl":{"type":"string","format":"uri"},"status":{"type":"string","enum":["active","discontinued","coming_soon"],"default":"active"}}}}}},"responses":{"200":{"description":"Variant updated","content":{"application/json":{"schema":{"type":"object","properties":{"variant":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"sku":{"type":["string","null"]},"name":{"type":"string"},"attributes":{"type":["object","null"],"additionalProperties":{}},"price":{"type":["number","null"]},"currency":{"type":"string"},"inStock":{"type":"boolean"},"stockLevel":{"type":["string","null"],"enum":["in_stock","low_stock","out_of_stock",null]},"variantUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","productProfileId","sku","name","attributes","price","currency","inStock","stockLevel","variantUrl","imageUrl","status","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["variant"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Product Variants"],"summary":"Delete product variant","description":"Soft delete a product variant.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"variantId","in":"path"}],"responses":{"200":{"description":"Variant deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/research":{"post":{"tags":["Product Research"],"summary":"Trigger product research","description":"Start an async research job to gather product intelligence from various sources.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"researchLevel":{"type":"string","enum":["none","basic","standard","deep"],"default":"basic"},"sources":{"type":"array","items":{"type":"string","enum":["website","amazon","reviews","competitors","social"]}},"force":{"type":"boolean","default":false}}}}}},"responses":{"201":{"description":"Research job queued","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"requestedSources":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"currentPhase":{"type":["string","null"]},"phases":{"type":["object","null"],"additionalProperties":{"type":"string"}},"queuedAt":{"type":"number"},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"resultSummary":{"type":["string","null"]},"dataExtracted":{"type":["number","null"]},"confidence":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","productProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","resultSummary","dataExtracted","confidence","errorMessage","createdBy"]},"message":{"type":"string"}},"required":["job","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/research/status":{"get":{"tags":["Product Research"],"summary":"Get research status","description":"Get the current research status for a product.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"responses":{"200":{"description":"Research status","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":["object","null"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"requestedSources":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"currentPhase":{"type":["string","null"]},"phases":{"type":["object","null"],"additionalProperties":{"type":"string"}},"queuedAt":{"type":"number"},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"resultSummary":{"type":["string","null"]},"dataExtracted":{"type":["number","null"]},"confidence":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","productProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","resultSummary","dataExtracted","confidence","errorMessage","createdBy"]},"hasActiveJob":{"type":"boolean"},"lastCompletedJob":{"type":["object","null"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"requestedSources":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"currentPhase":{"type":["string","null"]},"phases":{"type":["object","null"],"additionalProperties":{"type":"string"}},"queuedAt":{"type":"number"},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"resultSummary":{"type":["string","null"]},"dataExtracted":{"type":["number","null"]},"confidence":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","productProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","resultSummary","dataExtracted","confidence","errorMessage","createdBy"]}},"required":["job","hasActiveJob","lastCompletedJob"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/research/cancel":{"post":{"tags":["Product Research"],"summary":"Cancel product research","description":"Cancel an active research job for a product.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"responses":{"200":{"description":"Research cancelled","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"requestedSources":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"currentPhase":{"type":["string","null"]},"phases":{"type":["object","null"],"additionalProperties":{"type":"string"}},"queuedAt":{"type":"number"},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"resultSummary":{"type":["string","null"]},"dataExtracted":{"type":["number","null"]},"confidence":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","productProfileId","researchLevel","requestedSources","status","progress","currentPhase","phases","queuedAt","startedAt","completedAt","estimatedDuration","resultSummary","dataExtracted","confidence","errorMessage","createdBy"]},"message":{"type":"string"}},"required":["job","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/products/{productId}/analyze":{"post":{"tags":["Product AI"],"summary":"Trigger AI analysis","description":"Trigger AI analysis to generate selling points, target audience, and messaging angles.","parameters":[{"schema":{"type":"string"},"required":true,"name":"productId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"analysisType":{"type":"string","enum":["selling_points","target_audience","messaging","full"],"default":"full"},"force":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"AI analysis triggered","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"crmProductId":{"type":["string","null"]},"name":{"type":"string"},"sku":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"shortDescription":{"type":["string","null"]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"dimensions":{"type":["object","null"],"properties":{"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"weight":{"type":"number"},"unit":{"type":"string"}}},"materials":{"type":["array","null"],"items":{"type":"string"}},"price":{"type":["number","null"]},"currency":{"type":"string"},"priceRange":{"type":["string","null"],"enum":["budget","mid_range","premium","luxury",null]},"msrp":{"type":["number","null"]},"variants":{"type":["array","null"],"items":{"type":"object","additionalProperties":{}}},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"videoUrls":{"type":["array","null"],"items":{"type":"string"}},"targetMarket":{"type":["string","null"],"enum":["consumer","professional","enterprise","industrial",null]},"marketSegment":{"type":["string","null"]},"positioning":{"type":["string","null"]},"aiSellingPoints":{"type":["array","null"],"items":{"type":"string"}},"aiTargetAudience":{"type":["object","null"],"additionalProperties":{}},"aiMessagingAngles":{"type":["array","null"],"items":{"type":"string"}},"aiCompetitiveAdvantages":{"type":["array","null"],"items":{"type":"string"}},"aiWeaknesses":{"type":["array","null"],"items":{"type":"string"}},"aiKeywords":{"type":["array","null"],"items":{"type":"string"}},"aiSummary":{"type":["string","null"]},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSummary":{"type":["string","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"number"}},"complianceCategory":{"type":["string","null"],"enum":["supplement","medical","financial","alcohol","tobacco","general",null]},"complianceNotes":{"type":["array","null"],"items":{"type":"string"}},"requiresDisclaimer":{"type":"boolean"},"disclaimerText":{"type":["string","null"]},"status":{"type":"string","enum":["active","discontinued","coming_soon"]},"launchDate":{"type":["number","null"]},"discontinuedDate":{"type":["number","null"]},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","crmProductId","name","sku","category","subcategory","description","shortDescription","specifications","features","dimensions","materials","price","currency","priceRange","msrp","variants","productUrl","amazonUrl","imageUrls","videoUrls","targetMarket","marketSegment","positioning","aiSellingPoints","aiTargetAudience","aiMessagingAngles","aiCompetitiveAdvantages","aiWeaknesses","aiKeywords","aiSummary","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","avgRating","reviewCount","reviewSummary","reviewSources","complianceCategory","complianceNotes","requiresDisclaimer","disclaimerText","status","launchDate","discontinuedDate","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]},"analysisType":{"type":"string"},"message":{"type":"string"},"usage":{"type":["object","null"],"properties":{"cost":{"type":"number"},"model":{"type":"string"},"promptTokens":{"type":"number"},"responseTokens":{"type":"number"},"latencyMs":{"type":"number"},"byok":{"type":"boolean"}},"required":["cost","model","promptTokens","responseTokens","latencyMs","byok"]}},"required":["product","analysisType","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/competitors/companies":{"get":{"tags":["Competitive Intelligence"],"summary":"List company competitors","description":"List competitors that compete with client companies.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["direct","indirect","emerging","substitute"]},"required":false,"name":"competitorType","in":"query"},{"schema":{"type":"string","enum":["low","medium","high","critical"]},"required":false,"name":"threatLevel","in":"query"},{"schema":{"type":"string","enum":["active","inactive","archived","discontinued"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"List of company competitors","content":{"application/json":{"schema":{"type":"object","properties":{"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"]},"threatLevel":{"type":"string","enum":["low","medium","high","critical"]},"marketPosition":{"type":["string","null"],"enum":["leader","challenger","follower","niche",null]},"estimatedRevenue":{"type":["string","null"]},"employeeCount":{"type":["string","null"]},"foundedYear":{"type":["number","null"]},"headquarters":{"type":["string","null"]},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"opportunities":{"type":["array","null"],"items":{"type":"string"}},"threats":{"type":["array","null"],"items":{"type":"string"}},"targetMarkets":{"type":["array","null"],"items":{"type":"string"}},"marketShare":{"type":["number","null"]},"overlapScore":{"type":["number","null"]},"socialProfiles":{"type":["object","null"],"additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":["string","null"]},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adSpendEstimate":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"aiCounterStrategies":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","name","website","logoUrl","description","competitorType","threatLevel","marketPosition","estimatedRevenue","employeeCount","foundedYear","headquarters","strengths","weaknesses","opportunities","threats","targetMarkets","marketShare","overlapScore","socialProfiles","adLibraryUrl","advertisingChannels","adSpendEstimate","aiSummary","aiDifferentiators","aiCounterStrategies","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["competitors","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"post":{"tags":["Competitive Intelligence"],"summary":"Create company competitor","description":"Add a new competitor to track at the company level.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"website":{"type":"string","format":"uri"},"logoUrl":{"type":"string","format":"uri"},"description":{"type":"string"},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"],"default":"direct"},"threatLevel":{"type":"string","enum":["low","medium","high","critical"],"default":"medium"},"marketPosition":{"type":"string","enum":["leader","challenger","follower","niche"]},"estimatedRevenue":{"type":"string"},"employeeCount":{"type":"string"},"foundedYear":{"type":"integer","minimum":1800,"maximum":2100},"headquarters":{"type":"string"},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"opportunities":{"type":"array","items":{"type":"string"}},"threats":{"type":"array","items":{"type":"string"}},"targetMarkets":{"type":"array","items":{"type":"string"}},"marketShare":{"type":"number","minimum":0,"maximum":100},"overlapScore":{"type":"integer","minimum":0,"maximum":100},"socialProfiles":{"type":"object","additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":"string","format":"uri"},"advertisingChannels":{"type":"array","items":{"type":"string"}},"adSpendEstimate":{"type":"string"},"discoveryMethod":{"type":"string","enum":["manual","ai_suggested","amazon_similar","research"]},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}},"required":["clientProfileId","name"]}}}},"responses":{"201":{"description":"Company competitor created","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"]},"threatLevel":{"type":"string","enum":["low","medium","high","critical"]},"marketPosition":{"type":["string","null"],"enum":["leader","challenger","follower","niche",null]},"estimatedRevenue":{"type":["string","null"]},"employeeCount":{"type":["string","null"]},"foundedYear":{"type":["number","null"]},"headquarters":{"type":["string","null"]},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"opportunities":{"type":["array","null"],"items":{"type":"string"}},"threats":{"type":["array","null"],"items":{"type":"string"}},"targetMarkets":{"type":["array","null"],"items":{"type":"string"}},"marketShare":{"type":["number","null"]},"overlapScore":{"type":["number","null"]},"socialProfiles":{"type":["object","null"],"additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":["string","null"]},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adSpendEstimate":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"aiCounterStrategies":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","name","website","logoUrl","description","competitorType","threatLevel","marketPosition","estimatedRevenue","employeeCount","foundedYear","headquarters","strengths","weaknesses","opportunities","threats","targetMarkets","marketShare","overlapScore","socialProfiles","adLibraryUrl","advertisingChannels","adSpendEstimate","aiSummary","aiDifferentiators","aiCounterStrategies","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/companies/{competitorId}":{"get":{"tags":["Competitive Intelligence"],"summary":"Get company competitor by ID","description":"Get detailed information about a specific company competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"responses":{"200":{"description":"Company competitor details","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"]},"threatLevel":{"type":"string","enum":["low","medium","high","critical"]},"marketPosition":{"type":["string","null"],"enum":["leader","challenger","follower","niche",null]},"estimatedRevenue":{"type":["string","null"]},"employeeCount":{"type":["string","null"]},"foundedYear":{"type":["number","null"]},"headquarters":{"type":["string","null"]},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"opportunities":{"type":["array","null"],"items":{"type":"string"}},"threats":{"type":["array","null"],"items":{"type":"string"}},"targetMarkets":{"type":["array","null"],"items":{"type":"string"}},"marketShare":{"type":["number","null"]},"overlapScore":{"type":["number","null"]},"socialProfiles":{"type":["object","null"],"additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":["string","null"]},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adSpendEstimate":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"aiCounterStrategies":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","name","website","logoUrl","description","competitorType","threatLevel","marketPosition","estimatedRevenue","employeeCount","foundedYear","headquarters","strengths","weaknesses","opportunities","threats","targetMarkets","marketShare","overlapScore","socialProfiles","adLibraryUrl","advertisingChannels","adSpendEstimate","aiSummary","aiDifferentiators","aiCounterStrategies","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"patch":{"tags":["Competitive Intelligence"],"summary":"Update company competitor","description":"Update details about a company competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"website":{"type":"string","format":"uri"},"logoUrl":{"type":"string","format":"uri"},"description":{"type":"string"},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"],"default":"direct"},"threatLevel":{"type":"string","enum":["low","medium","high","critical"],"default":"medium"},"marketPosition":{"type":"string","enum":["leader","challenger","follower","niche"]},"estimatedRevenue":{"type":"string"},"employeeCount":{"type":"string"},"foundedYear":{"type":"integer","minimum":1800,"maximum":2100},"headquarters":{"type":"string"},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"opportunities":{"type":"array","items":{"type":"string"}},"threats":{"type":"array","items":{"type":"string"}},"targetMarkets":{"type":"array","items":{"type":"string"}},"marketShare":{"type":"number","minimum":0,"maximum":100},"overlapScore":{"type":"integer","minimum":0,"maximum":100},"socialProfiles":{"type":"object","additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":"string","format":"uri"},"advertisingChannels":{"type":"array","items":{"type":"string"}},"adSpendEstimate":{"type":"string"},"discoveryMethod":{"type":"string","enum":["manual","ai_suggested","amazon_similar","research"]},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}}}}}},"responses":{"200":{"description":"Company competitor updated","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"logoUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"competitorType":{"type":"string","enum":["direct","indirect","emerging","substitute"]},"threatLevel":{"type":"string","enum":["low","medium","high","critical"]},"marketPosition":{"type":["string","null"],"enum":["leader","challenger","follower","niche",null]},"estimatedRevenue":{"type":["string","null"]},"employeeCount":{"type":["string","null"]},"foundedYear":{"type":["number","null"]},"headquarters":{"type":["string","null"]},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"opportunities":{"type":["array","null"],"items":{"type":"string"}},"threats":{"type":["array","null"],"items":{"type":"string"}},"targetMarkets":{"type":["array","null"],"items":{"type":"string"}},"marketShare":{"type":["number","null"]},"overlapScore":{"type":["number","null"]},"socialProfiles":{"type":["object","null"],"additionalProperties":{"type":"string"}},"adLibraryUrl":{"type":["string","null"]},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adSpendEstimate":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"aiCounterStrategies":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","clientProfileId","name","website","logoUrl","description","competitorType","threatLevel","marketPosition","estimatedRevenue","employeeCount","foundedYear","headquarters","strengths","weaknesses","opportunities","threats","targetMarkets","marketShare","overlapScore","socialProfiles","adLibraryUrl","advertisingChannels","adSpendEstimate","aiSummary","aiDifferentiators","aiCounterStrategies","aiLastAnalyzed","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"delete":{"tags":["Competitive Intelligence"],"summary":"Delete company competitor","description":"Remove a company competitor from tracking.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"responses":{"200":{"description":"Company competitor deleted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/companies/{competitorId}/analyze":{"post":{"tags":["Competitive Intelligence"],"summary":"Trigger AI analysis on company competitor","description":"Run AI analysis on a company competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"analysisType":{"type":"string","enum":["full","positioning","pricing","advertising","swot"],"default":"full"}}}}}},"responses":{"200":{"description":"Analysis completed","content":{"application/json":{"schema":{"type":"object","properties":{"analysis":{"type":"object","properties":{"analysisType":{"type":"string","enum":["full","positioning","pricing","advertising","swot"]},"summary":{"type":"string"},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"positioningGaps":{"type":"array","items":{"type":"string"}},"counterStrategies":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"analyzedAt":{"type":"number"}},"required":["analysisType","summary","analyzedAt"]}},"required":["analysis"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/companies/{competitorId}/monitor":{"post":{"tags":["Competitive Intelligence"],"summary":"Trigger company monitoring","description":"Start a monitoring job for a company competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"],"default":"full_research"},"sources":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Monitoring job created","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"targetType":{"type":"string","enum":["company","product"]},"targetId":{"type":"string"},"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"error":{"type":["string","null"]},"sources":{"type":["array","null"],"items":{"type":"string"}},"resultsSummary":{"type":["object","null"],"additionalProperties":{}},"changesDetected":{"type":"boolean"},"alertsTriggered":{"type":"number"},"queuedAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","targetType","targetId","jobType","status","progress","error","sources","resultsSummary","changesDetected","alertsTriggered","queuedAt","startedAt","completedAt","estimatedDuration","createdBy"]}},"required":["job"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products":{"get":{"tags":["Competitive Intelligence"],"summary":"List product competitors","description":"List competitors that compete with specific products.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"productProfileId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"companyCompetitorId","in":"query"},{"schema":{"type":"string","enum":["direct","indirect","substitute","premium","budget"]},"required":false,"name":"competitorType","in":"query"},{"schema":{"type":"string","enum":["below","similar","above","premium"]},"required":false,"name":"pricePosition","in":"query"},{"schema":{"type":"string","enum":["active","inactive","archived","discontinued"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"brand","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"List of product competitors","content":{"application/json":{"schema":{"type":"object","properties":{"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"companyCompetitorId":{"type":["string","null"]},"name":{"type":"string"},"brand":{"type":["string","null"]},"sku":{"type":["string","null"]},"model":{"type":["string","null"]},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"]},"pricePosition":{"type":["string","null"],"enum":["below","similar","above","premium",null]},"currentPrice":{"type":["number","null"]},"currency":{"type":"string"},"msrp":{"type":["number","null"]},"lowestPrice":{"type":["number","null"]},"highestPrice":{"type":["number","null"]},"priceLastUpdated":{"type":["number","null"]},"priceHistory":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":"number"},"price":{"type":"number"}},"required":["date","price"]}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"object","properties":{"rating":{"type":"number"},"count":{"type":"number"}},"required":["rating","count"]}},"reviewSummary":{"type":["string","null"]},"reviewSentiment":{"type":["string","null"],"enum":["positive","mixed","negative",null]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"featureComparison":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["better","same","worse"]}},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adStyles":{"type":["array","null"],"items":{"type":"string"}},"adFrequency":{"type":["string","null"],"enum":["low","medium","high","aggressive",null]},"adCreativeSamples":{"type":["array","null"],"items":{"type":"string"}},"adMessaging":{"type":["array","null"],"items":{"type":"string"}},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"keyDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"targetAudience":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiPositioningGaps":{"type":["array","null"],"items":{"type":"string"}},"aiMessagingCounters":{"type":["array","null"],"items":{"type":"string"}},"aiRecommendations":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"priceAlertThreshold":{"type":["number","null"]},"stockMonitoring":{"type":"boolean"},"outOfStock":{"type":"boolean"},"lastStockCheck":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","productProfileId","companyCompetitorId","name","brand","sku","model","productUrl","amazonUrl","imageUrls","competitorType","pricePosition","currentPrice","currency","msrp","lowestPrice","highestPrice","priceLastUpdated","priceHistory","avgRating","reviewCount","reviewSources","reviewSummary","reviewSentiment","specifications","features","featureComparison","advertisingChannels","adStyles","adFrequency","adCreativeSamples","adMessaging","strengths","weaknesses","keyDifferentiators","targetAudience","aiSummary","aiPositioningGaps","aiMessagingCounters","aiRecommendations","aiLastAnalyzed","priceAlertThreshold","stockMonitoring","outOfStock","lastStockCheck","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["competitors","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"post":{"tags":["Competitive Intelligence"],"summary":"Create product competitor","description":"Add a new competitor product to track.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"productProfileId":{"type":"string","minLength":1},"companyCompetitorId":{"type":"string"},"name":{"type":"string","minLength":1},"brand":{"type":"string"},"sku":{"type":"string"},"model":{"type":"string"},"productUrl":{"type":"string","format":"uri"},"amazonUrl":{"type":"string","format":"uri"},"imageUrls":{"type":"array","items":{"type":"string","format":"uri"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"],"default":"direct"},"pricePosition":{"type":"string","enum":["below","similar","above","premium"]},"currentPrice":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"msrp":{"type":"number","exclusiveMinimum":0},"avgRating":{"type":"number","minimum":0,"maximum":5},"reviewCount":{"type":"integer","minimum":0},"reviewSummary":{"type":"string"},"reviewSentiment":{"type":"string","enum":["positive","mixed","negative"]},"specifications":{"type":"object","additionalProperties":{}},"features":{"type":"array","items":{"type":"string"}},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"keyDifferentiators":{"type":"array","items":{"type":"string"}},"targetAudience":{"type":"string"},"advertisingChannels":{"type":"array","items":{"type":"string"}},"adStyles":{"type":"array","items":{"type":"string"}},"adFrequency":{"type":"string","enum":["low","medium","high","aggressive"]},"priceAlertThreshold":{"type":"number","exclusiveMinimum":0},"stockMonitoring":{"type":"boolean","default":false},"discoveryMethod":{"type":"string","enum":["manual","ai_suggested","amazon_similar","research"]},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}},"required":["productProfileId","name"]}}}},"responses":{"201":{"description":"Product competitor created","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"companyCompetitorId":{"type":["string","null"]},"name":{"type":"string"},"brand":{"type":["string","null"]},"sku":{"type":["string","null"]},"model":{"type":["string","null"]},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"]},"pricePosition":{"type":["string","null"],"enum":["below","similar","above","premium",null]},"currentPrice":{"type":["number","null"]},"currency":{"type":"string"},"msrp":{"type":["number","null"]},"lowestPrice":{"type":["number","null"]},"highestPrice":{"type":["number","null"]},"priceLastUpdated":{"type":["number","null"]},"priceHistory":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":"number"},"price":{"type":"number"}},"required":["date","price"]}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"object","properties":{"rating":{"type":"number"},"count":{"type":"number"}},"required":["rating","count"]}},"reviewSummary":{"type":["string","null"]},"reviewSentiment":{"type":["string","null"],"enum":["positive","mixed","negative",null]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"featureComparison":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["better","same","worse"]}},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adStyles":{"type":["array","null"],"items":{"type":"string"}},"adFrequency":{"type":["string","null"],"enum":["low","medium","high","aggressive",null]},"adCreativeSamples":{"type":["array","null"],"items":{"type":"string"}},"adMessaging":{"type":["array","null"],"items":{"type":"string"}},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"keyDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"targetAudience":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiPositioningGaps":{"type":["array","null"],"items":{"type":"string"}},"aiMessagingCounters":{"type":["array","null"],"items":{"type":"string"}},"aiRecommendations":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"priceAlertThreshold":{"type":["number","null"]},"stockMonitoring":{"type":"boolean"},"outOfStock":{"type":"boolean"},"lastStockCheck":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","productProfileId","companyCompetitorId","name","brand","sku","model","productUrl","amazonUrl","imageUrls","competitorType","pricePosition","currentPrice","currency","msrp","lowestPrice","highestPrice","priceLastUpdated","priceHistory","avgRating","reviewCount","reviewSources","reviewSummary","reviewSentiment","specifications","features","featureComparison","advertisingChannels","adStyles","adFrequency","adCreativeSamples","adMessaging","strengths","weaknesses","keyDifferentiators","targetAudience","aiSummary","aiPositioningGaps","aiMessagingCounters","aiRecommendations","aiLastAnalyzed","priceAlertThreshold","stockMonitoring","outOfStock","lastStockCheck","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products/{competitorId}":{"get":{"tags":["Competitive Intelligence"],"summary":"Get product competitor by ID","description":"Get detailed information about a specific product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"responses":{"200":{"description":"Product competitor details","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"companyCompetitorId":{"type":["string","null"]},"name":{"type":"string"},"brand":{"type":["string","null"]},"sku":{"type":["string","null"]},"model":{"type":["string","null"]},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"]},"pricePosition":{"type":["string","null"],"enum":["below","similar","above","premium",null]},"currentPrice":{"type":["number","null"]},"currency":{"type":"string"},"msrp":{"type":["number","null"]},"lowestPrice":{"type":["number","null"]},"highestPrice":{"type":["number","null"]},"priceLastUpdated":{"type":["number","null"]},"priceHistory":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":"number"},"price":{"type":"number"}},"required":["date","price"]}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"object","properties":{"rating":{"type":"number"},"count":{"type":"number"}},"required":["rating","count"]}},"reviewSummary":{"type":["string","null"]},"reviewSentiment":{"type":["string","null"],"enum":["positive","mixed","negative",null]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"featureComparison":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["better","same","worse"]}},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adStyles":{"type":["array","null"],"items":{"type":"string"}},"adFrequency":{"type":["string","null"],"enum":["low","medium","high","aggressive",null]},"adCreativeSamples":{"type":["array","null"],"items":{"type":"string"}},"adMessaging":{"type":["array","null"],"items":{"type":"string"}},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"keyDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"targetAudience":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiPositioningGaps":{"type":["array","null"],"items":{"type":"string"}},"aiMessagingCounters":{"type":["array","null"],"items":{"type":"string"}},"aiRecommendations":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"priceAlertThreshold":{"type":["number","null"]},"stockMonitoring":{"type":"boolean"},"outOfStock":{"type":"boolean"},"lastStockCheck":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","productProfileId","companyCompetitorId","name","brand","sku","model","productUrl","amazonUrl","imageUrls","competitorType","pricePosition","currentPrice","currency","msrp","lowestPrice","highestPrice","priceLastUpdated","priceHistory","avgRating","reviewCount","reviewSources","reviewSummary","reviewSentiment","specifications","features","featureComparison","advertisingChannels","adStyles","adFrequency","adCreativeSamples","adMessaging","strengths","weaknesses","keyDifferentiators","targetAudience","aiSummary","aiPositioningGaps","aiMessagingCounters","aiRecommendations","aiLastAnalyzed","priceAlertThreshold","stockMonitoring","outOfStock","lastStockCheck","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"patch":{"tags":["Competitive Intelligence"],"summary":"Update product competitor","description":"Update details about a product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"companyCompetitorId":{"type":"string"},"name":{"type":"string","minLength":1},"brand":{"type":"string"},"sku":{"type":"string"},"model":{"type":"string"},"productUrl":{"type":"string","format":"uri"},"amazonUrl":{"type":"string","format":"uri"},"imageUrls":{"type":"array","items":{"type":"string","format":"uri"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"],"default":"direct"},"pricePosition":{"type":"string","enum":["below","similar","above","premium"]},"currentPrice":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"msrp":{"type":"number","exclusiveMinimum":0},"avgRating":{"type":"number","minimum":0,"maximum":5},"reviewCount":{"type":"integer","minimum":0},"reviewSummary":{"type":"string"},"reviewSentiment":{"type":"string","enum":["positive","mixed","negative"]},"specifications":{"type":"object","additionalProperties":{}},"features":{"type":"array","items":{"type":"string"}},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"keyDifferentiators":{"type":"array","items":{"type":"string"}},"targetAudience":{"type":"string"},"advertisingChannels":{"type":"array","items":{"type":"string"}},"adStyles":{"type":"array","items":{"type":"string"}},"adFrequency":{"type":"string","enum":["low","medium","high","aggressive"]},"priceAlertThreshold":{"type":"number","exclusiveMinimum":0},"stockMonitoring":{"type":"boolean","default":false},"discoveryMethod":{"type":"string","enum":["manual","ai_suggested","amazon_similar","research"]},"tags":{"type":"array","items":{"type":"string"}},"notes":{"type":"string"}}}}}},"responses":{"200":{"description":"Product competitor updated","content":{"application/json":{"schema":{"type":"object","properties":{"competitor":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productProfileId":{"type":"string"},"companyCompetitorId":{"type":["string","null"]},"name":{"type":"string"},"brand":{"type":["string","null"]},"sku":{"type":["string","null"]},"model":{"type":["string","null"]},"productUrl":{"type":["string","null"]},"amazonUrl":{"type":["string","null"]},"imageUrls":{"type":["array","null"],"items":{"type":"string"}},"competitorType":{"type":"string","enum":["direct","indirect","substitute","premium","budget"]},"pricePosition":{"type":["string","null"],"enum":["below","similar","above","premium",null]},"currentPrice":{"type":["number","null"]},"currency":{"type":"string"},"msrp":{"type":["number","null"]},"lowestPrice":{"type":["number","null"]},"highestPrice":{"type":["number","null"]},"priceLastUpdated":{"type":["number","null"]},"priceHistory":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":"number"},"price":{"type":"number"}},"required":["date","price"]}},"avgRating":{"type":["number","null"]},"reviewCount":{"type":["number","null"]},"reviewSources":{"type":["object","null"],"additionalProperties":{"type":"object","properties":{"rating":{"type":"number"},"count":{"type":"number"}},"required":["rating","count"]}},"reviewSummary":{"type":["string","null"]},"reviewSentiment":{"type":["string","null"],"enum":["positive","mixed","negative",null]},"specifications":{"type":["object","null"],"additionalProperties":{}},"features":{"type":["array","null"],"items":{"type":"string"}},"featureComparison":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["better","same","worse"]}},"advertisingChannels":{"type":["array","null"],"items":{"type":"string"}},"adStyles":{"type":["array","null"],"items":{"type":"string"}},"adFrequency":{"type":["string","null"],"enum":["low","medium","high","aggressive",null]},"adCreativeSamples":{"type":["array","null"],"items":{"type":"string"}},"adMessaging":{"type":["array","null"],"items":{"type":"string"}},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}},"keyDifferentiators":{"type":["array","null"],"items":{"type":"string"}},"targetAudience":{"type":["string","null"]},"aiSummary":{"type":["string","null"]},"aiPositioningGaps":{"type":["array","null"],"items":{"type":"string"}},"aiMessagingCounters":{"type":["array","null"],"items":{"type":"string"}},"aiRecommendations":{"type":["array","null"],"items":{"type":"string"}},"aiLastAnalyzed":{"type":["number","null"]},"priceAlertThreshold":{"type":["number","null"]},"stockMonitoring":{"type":"boolean"},"outOfStock":{"type":"boolean"},"lastStockCheck":{"type":["number","null"]},"researchLevel":{"type":"string","enum":["none","basic","standard","deep"]},"lastResearchedAt":{"type":["number","null"]},"researchConfidence":{"type":["number","null"]},"researchSources":{"type":["array","null"],"items":{"type":"string"}},"discoveryMethod":{"type":["string","null"],"enum":["manual","ai_suggested","amazon_similar","research",null]},"discoveredAt":{"type":["number","null"]},"status":{"type":"string","enum":["active","inactive","archived","discontinued"]},"monitoringEnabled":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"notes":{"type":["string","null"]},"createdAt":{"type":"number"},"createdBy":{"type":"string"},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]},"version":{"type":"number"}},"required":["id","organizationId","productProfileId","companyCompetitorId","name","brand","sku","model","productUrl","amazonUrl","imageUrls","competitorType","pricePosition","currentPrice","currency","msrp","lowestPrice","highestPrice","priceLastUpdated","priceHistory","avgRating","reviewCount","reviewSources","reviewSummary","reviewSentiment","specifications","features","featureComparison","advertisingChannels","adStyles","adFrequency","adCreativeSamples","adMessaging","strengths","weaknesses","keyDifferentiators","targetAudience","aiSummary","aiPositioningGaps","aiMessagingCounters","aiRecommendations","aiLastAnalyzed","priceAlertThreshold","stockMonitoring","outOfStock","lastStockCheck","researchLevel","lastResearchedAt","researchConfidence","researchSources","discoveryMethod","discoveredAt","status","monitoringEnabled","tags","notes","createdAt","createdBy","updatedAt","updatedBy","version"]}},"required":["competitor"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"delete":{"tags":["Competitive Intelligence"],"summary":"Delete product competitor","description":"Remove a product competitor from tracking.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"responses":{"200":{"description":"Product competitor deleted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products/{competitorId}/analyze":{"post":{"tags":["Competitive Intelligence"],"summary":"Trigger AI analysis on product competitor","description":"Run AI analysis on a product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"analysisType":{"type":"string","enum":["full","positioning","pricing","advertising","swot"],"default":"full"}}}}}},"responses":{"200":{"description":"Analysis completed","content":{"application/json":{"schema":{"type":"object","properties":{"analysis":{"type":"object","properties":{"analysisType":{"type":"string","enum":["full","positioning","pricing","advertising","swot"]},"summary":{"type":"string"},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"positioningGaps":{"type":"array","items":{"type":"string"}},"counterStrategies":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"analyzedAt":{"type":"number"}},"required":["analysisType","summary","analyzedAt"]}},"required":["analysis"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products/{competitorId}/compare":{"get":{"tags":["Competitive Intelligence"],"summary":"Compare product with competitor","description":"Get a detailed comparison between our product and a competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"responses":{"200":{"description":"Product comparison","content":{"application/json":{"schema":{"type":"object","properties":{"comparison":{"type":"object","properties":{"ourProduct":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"price":{"type":["number","null"]},"rating":{"type":["number","null"]},"features":{"type":["array","null"],"items":{"type":"string"}}},"required":["id","name","price","rating","features"]},"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"price":{"type":["number","null"]},"pricePosition":{"type":["string","null"],"enum":["below","similar","above","premium",null]},"priceDifference":{"type":["number","null"]},"rating":{"type":["number","null"]},"ratingDifference":{"type":["number","null"]},"strengths":{"type":["array","null"],"items":{"type":"string"}},"weaknesses":{"type":["array","null"],"items":{"type":"string"}}},"required":["id","name","brand","price","pricePosition","priceDifference","rating","ratingDifference","strengths","weaknesses"]}},"positioningOpportunity":{"type":["string","null"]},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["ourProduct","competitors","positioningOpportunity","recommendations"]}},"required":["comparison"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products/{competitorId}/monitor":{"post":{"tags":["Competitive Intelligence"],"summary":"Trigger product monitoring","description":"Start a monitoring job for a product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"],"default":"full_research"},"sources":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Monitoring job created","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"targetType":{"type":"string","enum":["company","product"]},"targetId":{"type":"string"},"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"error":{"type":["string","null"]},"sources":{"type":["array","null"],"items":{"type":"string"}},"resultsSummary":{"type":["object","null"],"additionalProperties":{}},"changesDetected":{"type":"boolean"},"alertsTriggered":{"type":"number"},"queuedAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","targetType","targetId","jobType","status","progress","error","sources","resultsSummary","changesDetected","alertsTriggered","queuedAt","startedAt","completedAt","estimatedDuration","createdBy"]}},"required":["job"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/products/{competitorId}/prices":{"get":{"tags":["Competitive Intelligence"],"summary":"List price history","description":"Get historical pricing data for a product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"},{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":365,"default":30},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"startDate","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"source","in":"query"}],"responses":{"200":{"description":"Price history","content":{"application/json":{"schema":{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productCompetitorId":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string"},"source":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"wasOnSale":{"type":"boolean"},"salePercentage":{"type":["number","null"]},"promotionName":{"type":["string","null"]},"inStock":{"type":"boolean"},"capturedAt":{"type":"number"},"captureMethod":{"type":["string","null"]}},"required":["id","organizationId","productCompetitorId","price","currency","source","sourceUrl","wasOnSale","salePercentage","promotionName","inStock","capturedAt","captureMethod"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"},"stats":{"type":"object","properties":{"minPrice":{"type":["number","null"]},"maxPrice":{"type":["number","null"]},"avgPrice":{"type":["number","null"]},"priceChange":{"type":["number","null"]}},"required":["minPrice","maxPrice","avgPrice","priceChange"]}},"required":["prices","total","page","limit","stats"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}},"post":{"tags":["Competitive Intelligence"],"summary":"Record price point","description":"Record a new price observation for a product competitor.","parameters":[{"schema":{"type":"string"},"required":true,"name":"competitorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"price":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"source":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"wasOnSale":{"type":"boolean","default":false},"salePercentage":{"type":"number","minimum":0,"maximum":100},"promotionName":{"type":"string"},"inStock":{"type":"boolean","default":true}},"required":["price"]}}}},"responses":{"201":{"description":"Price recorded","content":{"application/json":{"schema":{"type":"object","properties":{"price":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"productCompetitorId":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string"},"source":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"wasOnSale":{"type":"boolean"},"salePercentage":{"type":["number","null"]},"promotionName":{"type":["string","null"]},"inStock":{"type":"boolean"},"capturedAt":{"type":"number"},"captureMethod":{"type":["string","null"]}},"required":["id","organizationId","productCompetitorId","price","currency","source","sourceUrl","wasOnSale","salePercentage","promotionName","inStock","capturedAt","captureMethod"]}},"required":["price"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/monitoring":{"get":{"tags":["Competitive Intelligence"],"summary":"List monitoring jobs","description":"List competitor monitoring jobs.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["company","product"]},"required":false,"name":"targetType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"targetId","in":"query"},{"schema":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"required":false,"name":"jobType","in":"query"},{"schema":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"List of monitoring jobs","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"targetType":{"type":"string","enum":["company","product"]},"targetId":{"type":"string"},"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"error":{"type":["string","null"]},"sources":{"type":["array","null"],"items":{"type":"string"}},"resultsSummary":{"type":["object","null"],"additionalProperties":{}},"changesDetected":{"type":"boolean"},"alertsTriggered":{"type":"number"},"queuedAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","targetType","targetId","jobType","status","progress","error","sources","resultsSummary","changesDetected","alertsTriggered","queuedAt","startedAt","completedAt","estimatedDuration","createdBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["jobs","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/monitoring/{jobId}":{"get":{"tags":["Competitive Intelligence"],"summary":"Get monitoring job","description":"Get details about a specific monitoring job.","parameters":[{"schema":{"type":"string"},"required":true,"name":"jobId","in":"path"}],"responses":{"200":{"description":"Monitoring job details","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"targetType":{"type":"string","enum":["company","product"]},"targetId":{"type":"string"},"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"error":{"type":["string","null"]},"sources":{"type":["array","null"],"items":{"type":"string"}},"resultsSummary":{"type":["object","null"],"additionalProperties":{}},"changesDetected":{"type":"boolean"},"alertsTriggered":{"type":"number"},"queuedAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","targetType","targetId","jobType","status","progress","error","sources","resultsSummary","changesDetected","alertsTriggered","queuedAt","startedAt","completedAt","estimatedDuration","createdBy"]}},"required":["job"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/competitors/monitoring/{jobId}/cancel":{"post":{"tags":["Competitive Intelligence"],"summary":"Cancel monitoring job","description":"Cancel a pending or running monitoring job.","parameters":[{"schema":{"type":"string"},"required":true,"name":"jobId","in":"path"}],"responses":{"200":{"description":"Monitoring job cancelled","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"targetType":{"type":"string","enum":["company","product"]},"targetId":{"type":"string"},"jobType":{"type":"string","enum":["price_check","review_scrape","ad_analysis","full_research"]},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"]},"progress":{"type":"number"},"error":{"type":["string","null"]},"sources":{"type":["array","null"],"items":{"type":"string"}},"resultsSummary":{"type":["object","null"],"additionalProperties":{}},"changesDetected":{"type":"boolean"},"alertsTriggered":{"type":"number"},"queuedAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"completedAt":{"type":["number","null"]},"estimatedDuration":{"type":["number","null"]},"createdBy":{"type":"string"}},"required":["id","organizationId","targetType","targetId","jobType","status","progress","error","sources","resultsSummary","changesDetected","alertsTriggered","queuedAt","startedAt","completedAt","estimatedDuration","createdBy"]}},"required":["job"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"409":{"description":"Job already completed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/compliance/check":{"post":{"tags":["Compliance Engine"],"summary":"Check content for compliance","description":"Validate content against regulatory rules, platform policies, and client-specific restrictions.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"content":{"type":"object","properties":{"text":{"type":"string"},"images":{"type":"array","items":{"type":"string"}},"video":{"type":"string"}}},"context":{"type":"object","properties":{"clientProfileId":{"type":"string"},"productId":{"type":"string"},"platform":{"type":"string"}}},"options":{"type":"object","properties":{"checkLevels":{"type":"array","items":{"type":"string","enum":["1","2","3","4","5"]}},"strictMode":{"type":"boolean","default":false},"suggestFixes":{"type":"boolean","default":true},"rulesetIds":{"type":"array","items":{"type":"string"}}}}},"required":["contentType","content"]}}}},"responses":{"200":{"description":"Compliance check result","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"checkId":{"type":"string"},"passed":{"type":"boolean"},"score":{"type":"number"},"outcome":{"type":"string","enum":["passed","blocked","warned","overridden"]},"violations":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"ruleCode":{"type":"string"},"ruleName":{"type":"string"},"severity":{"type":"string","enum":["block","warn","info"]},"matchedContent":{"type":["string","null"]},"position":{"type":["object","null"],"properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"ruleDescription":{"type":["string","null"]},"reason":{"type":"string"},"source":{"type":"string"},"suggestion":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}}},"required":["ruleId","ruleCode","ruleName","severity","matchedContent","position","ruleDescription","reason","source","suggestion","alternatives"]}},"warnings":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"ruleCode":{"type":"string"},"ruleName":{"type":"string"},"severity":{"type":"string","enum":["block","warn","info"]},"matchedContent":{"type":["string","null"]},"position":{"type":["object","null"],"properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"ruleDescription":{"type":["string","null"]},"reason":{"type":"string"},"source":{"type":"string"},"suggestion":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}}},"required":["ruleId","ruleCode","ruleName","severity","matchedContent","position","ruleDescription","reason","source","suggestion","alternatives"]}},"requiredAdditions":{"type":"array","items":{"type":"object","properties":{"element":{"type":"string"},"text":{"type":"string"},"placement":{"type":"string"},"ruleId":{"type":"string"},"ruleCode":{"type":"string"}},"required":["element","text","placement","ruleId","ruleCode"]}},"rulesetsApplied":{"type":"array","items":{"type":"string"}},"rulesEvaluated":{"type":"number"},"durationMs":{"type":"number"},"breakdown":{"type":"object","properties":{"regulatory":{"type":"number"},"platform":{"type":"number"},"industry":{"type":"number"},"clientLegal":{"type":"number"},"clientPreferences":{"type":"number"}},"required":["regulatory","platform","industry","clientLegal","clientPreferences"]}},"required":["checkId","passed","score","outcome","violations","warnings","requiredAdditions","rulesetsApplied","rulesEvaluated","durationMs"]}},"required":["result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/pre-check":{"post":{"tags":["Compliance Engine"],"summary":"Get compliance guidelines before writing","description":"Returns what can and cannot be said for a given context (platform, product category, client).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string"},"clientProfileId":{"type":"string"},"productId":{"type":"string"},"productCategory":{"type":"string"}}}}}},"responses":{"200":{"description":"Pre-check guidelines","content":{"application/json":{"schema":{"type":"object","properties":{"guidelines":{"type":"object","properties":{"canSay":{"type":"array","items":{"type":"object","properties":{"phrase":{"type":"string"},"example":{"type":"string"},"note":{"type":"string"}},"required":["phrase"]}},"cannotSay":{"type":"array","items":{"type":"object","properties":{"phrase":{"type":"string"},"reason":{"type":"string"},"ruleCode":{"type":"string"},"alternatives":{"type":"array","items":{"type":"string"}}},"required":["phrase","reason","ruleCode"]}},"required":{"type":"array","items":{"type":"object","properties":{"element":{"type":"string"},"text":{"type":"string"},"when":{"type":"string"}},"required":["element","text","when"]}},"rulesApplied":{"type":"number"}},"required":["canSay","cannotSay","required","rulesApplied"]}},"required":["guidelines"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/rulesets":{"get":{"tags":["Compliance Engine"],"summary":"List compliance rulesets","description":"List available compliance rulesets with filtering.","parameters":[{"schema":{"type":"string","enum":["regulatory","platform","industry","client"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"subcategory","in":"query"},{"schema":{"type":"string","enum":["active","deprecated","draft"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","default":"true"},"required":false,"name":"includeGlobal","in":"query"},{"schema":{"type":"string","default":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","default":"50"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Rulesets list","content":{"application/json":{"schema":{"type":"object","properties":{"rulesets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":["string","null"]},"name":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":["string","null"]},"level":{"type":"number"},"isGlobal":{"type":"boolean"},"industries":{"type":["array","null"],"items":{"type":"string"}},"productCategories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"version":{"type":["string","null"]},"effectiveDate":{"type":["number","null"]},"expirationDate":{"type":["number","null"]},"lastUpdatedSource":{"type":["string","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"rulesCount":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","name","description","category","subcategory","level","isGlobal","industries","productCategories","platforms","version","effectiveDate","expirationDate","lastUpdatedSource","status","rulesCount","createdAt","createdBy","updatedAt","updatedBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["rulesets","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Compliance Engine"],"summary":"Create a ruleset","description":"Create a new compliance ruleset for the organization.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":"string"},"level":{"type":"number","minimum":1,"maximum":5,"default":4},"isGlobal":{"type":"boolean","default":false},"industries":{"type":"array","items":{"type":"string"}},"productCategories":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"version":{"type":"string","default":"1.0.0"},"effectiveDate":{"type":"number"},"expirationDate":{"type":"number"},"status":{"type":"string","enum":["active","deprecated","draft"],"default":"active"}},"required":["name","category"]}}}},"responses":{"201":{"description":"Created ruleset","content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":["string","null"]},"name":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":["string","null"]},"level":{"type":"number"},"isGlobal":{"type":"boolean"},"industries":{"type":["array","null"],"items":{"type":"string"}},"productCategories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"version":{"type":["string","null"]},"effectiveDate":{"type":["number","null"]},"expirationDate":{"type":["number","null"]},"lastUpdatedSource":{"type":["string","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"rulesCount":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","name","description","category","subcategory","level","isGlobal","industries","productCategories","platforms","version","effectiveDate","expirationDate","lastUpdatedSource","status","rulesCount","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["ruleset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/rulesets/{rulesetId}":{"get":{"tags":["Compliance Engine"],"summary":"Get a ruleset","description":"Get details of a specific compliance ruleset.","parameters":[{"schema":{"type":"string"},"required":true,"name":"rulesetId","in":"path"}],"responses":{"200":{"description":"Ruleset details","content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":["string","null"]},"name":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":["string","null"]},"level":{"type":"number"},"isGlobal":{"type":"boolean"},"industries":{"type":["array","null"],"items":{"type":"string"}},"productCategories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"version":{"type":["string","null"]},"effectiveDate":{"type":["number","null"]},"expirationDate":{"type":["number","null"]},"lastUpdatedSource":{"type":["string","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"rulesCount":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","name","description","category","subcategory","level","isGlobal","industries","productCategories","platforms","version","effectiveDate","expirationDate","lastUpdatedSource","status","rulesCount","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["ruleset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Compliance Engine"],"summary":"Update a ruleset","description":"Update an existing compliance ruleset.","parameters":[{"schema":{"type":"string"},"required":true,"name":"rulesetId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":"string"},"level":{"type":"number","minimum":1,"maximum":5,"default":4},"isGlobal":{"type":"boolean","default":false},"industries":{"type":"array","items":{"type":"string"}},"productCategories":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"version":{"type":"string","default":"1.0.0"},"effectiveDate":{"type":"number"},"expirationDate":{"type":"number"},"status":{"type":"string","enum":["active","deprecated","draft"],"default":"active"}}}}}},"responses":{"200":{"description":"Updated ruleset","content":{"application/json":{"schema":{"type":"object","properties":{"ruleset":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":["string","null"]},"name":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["regulatory","platform","industry","client"]},"subcategory":{"type":["string","null"]},"level":{"type":"number"},"isGlobal":{"type":"boolean"},"industries":{"type":["array","null"],"items":{"type":"string"}},"productCategories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"version":{"type":["string","null"]},"effectiveDate":{"type":["number","null"]},"expirationDate":{"type":["number","null"]},"lastUpdatedSource":{"type":["string","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"rulesCount":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","name","description","category","subcategory","level","isGlobal","industries","productCategories","platforms","version","effectiveDate","expirationDate","lastUpdatedSource","status","rulesCount","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["ruleset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Compliance Engine"],"summary":"Delete a ruleset","description":"Delete a compliance ruleset (organization-owned only).","parameters":[{"schema":{"type":"string"},"required":true,"name":"rulesetId","in":"path"}],"responses":{"200":{"description":"Ruleset deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/rules":{"get":{"tags":["Compliance Engine"],"summary":"List compliance rules","description":"List compliance rules with filtering.","parameters":[{"schema":{"type":"string"},"required":false,"name":"rulesetId","in":"query"},{"schema":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"required":false,"name":"ruleType","in":"query"},{"schema":{"type":"string","enum":["block","warn","info"]},"required":false,"name":"severity","in":"query"},{"schema":{"type":"string","enum":["active","deprecated","draft"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"string","default":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","default":"100"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Rules list","content":{"application/json":{"schema":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rulesetId":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"]},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":["array","null"],"items":{"type":"string"}},"caseSensitive":{"type":"boolean"},"wholeWord":{"type":"boolean"},"semanticDescription":{"type":["string","null"]},"semanticExamples":{"type":["array","null"],"items":{"type":"string"}},"semanticModel":{"type":["string","null"]},"requiredText":{"type":["string","null"]},"requiredPlacement":{"type":["string","null"]},"conditions":{"type":["object","null"],"properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string"},"suggestionTemplate":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}},"legalReference":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"lastVerified":{"type":["number","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"priority":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","rulesetId","code","name","description","ruleType","severity","detectionMethod","patterns","caseSensitive","wholeWord","semanticDescription","semanticExamples","semanticModel","requiredText","requiredPlacement","conditions","violationMessage","suggestionTemplate","alternatives","legalReference","sourceUrl","lastVerified","status","priority","createdAt","createdBy","updatedAt","updatedBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["rules","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Compliance Engine"],"summary":"Create a rule","description":"Create a new compliance rule within a ruleset.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rulesetId":{"type":"string","minLength":1},"code":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string"},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"],"default":"warn"},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":"array","items":{"type":"string"}},"caseSensitive":{"type":"boolean","default":false},"wholeWord":{"type":"boolean","default":false},"semanticDescription":{"type":"string"},"semanticExamples":{"type":"array","items":{"type":"string"}},"semanticModel":{"type":"string"},"requiredText":{"type":"string"},"requiredPlacement":{"type":"string"},"conditions":{"type":"object","properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string","minLength":1},"suggestionTemplate":{"type":"string"},"alternatives":{"type":"array","items":{"type":"string"}},"legalReference":{"type":"string"},"sourceUrl":{"type":"string"},"priority":{"type":"number","default":100},"status":{"type":"string","enum":["active","deprecated","draft"],"default":"active"}},"required":["rulesetId","code","name","ruleType","detectionMethod","violationMessage"]}}}},"responses":{"201":{"description":"Created rule","content":{"application/json":{"schema":{"type":"object","properties":{"rule":{"type":"object","properties":{"id":{"type":"string"},"rulesetId":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"]},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":["array","null"],"items":{"type":"string"}},"caseSensitive":{"type":"boolean"},"wholeWord":{"type":"boolean"},"semanticDescription":{"type":["string","null"]},"semanticExamples":{"type":["array","null"],"items":{"type":"string"}},"semanticModel":{"type":["string","null"]},"requiredText":{"type":["string","null"]},"requiredPlacement":{"type":["string","null"]},"conditions":{"type":["object","null"],"properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string"},"suggestionTemplate":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}},"legalReference":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"lastVerified":{"type":["number","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"priority":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","rulesetId","code","name","description","ruleType","severity","detectionMethod","patterns","caseSensitive","wholeWord","semanticDescription","semanticExamples","semanticModel","requiredText","requiredPlacement","conditions","violationMessage","suggestionTemplate","alternatives","legalReference","sourceUrl","lastVerified","status","priority","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["rule"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/rules/{ruleId}":{"get":{"tags":["Compliance Engine"],"summary":"Get a rule","description":"Get details of a specific compliance rule.","parameters":[{"schema":{"type":"string"},"required":true,"name":"ruleId","in":"path"}],"responses":{"200":{"description":"Rule details","content":{"application/json":{"schema":{"type":"object","properties":{"rule":{"type":"object","properties":{"id":{"type":"string"},"rulesetId":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"]},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":["array","null"],"items":{"type":"string"}},"caseSensitive":{"type":"boolean"},"wholeWord":{"type":"boolean"},"semanticDescription":{"type":["string","null"]},"semanticExamples":{"type":["array","null"],"items":{"type":"string"}},"semanticModel":{"type":["string","null"]},"requiredText":{"type":["string","null"]},"requiredPlacement":{"type":["string","null"]},"conditions":{"type":["object","null"],"properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string"},"suggestionTemplate":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}},"legalReference":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"lastVerified":{"type":["number","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"priority":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","rulesetId","code","name","description","ruleType","severity","detectionMethod","patterns","caseSensitive","wholeWord","semanticDescription","semanticExamples","semanticModel","requiredText","requiredPlacement","conditions","violationMessage","suggestionTemplate","alternatives","legalReference","sourceUrl","lastVerified","status","priority","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["rule"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Compliance Engine"],"summary":"Update a rule","description":"Update an existing compliance rule.","parameters":[{"schema":{"type":"string"},"required":true,"name":"ruleId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string"},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"],"default":"warn"},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":"array","items":{"type":"string"}},"caseSensitive":{"type":"boolean","default":false},"wholeWord":{"type":"boolean","default":false},"semanticDescription":{"type":"string"},"semanticExamples":{"type":"array","items":{"type":"string"}},"semanticModel":{"type":"string"},"requiredText":{"type":"string"},"requiredPlacement":{"type":"string"},"conditions":{"type":"object","properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string","minLength":1},"suggestionTemplate":{"type":"string"},"alternatives":{"type":"array","items":{"type":"string"}},"legalReference":{"type":"string"},"sourceUrl":{"type":"string"},"priority":{"type":"number","default":100},"status":{"type":"string","enum":["active","deprecated","draft"],"default":"active"}}}}}},"responses":{"200":{"description":"Updated rule","content":{"application/json":{"schema":{"type":"object","properties":{"rule":{"type":"object","properties":{"id":{"type":"string"},"rulesetId":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"ruleType":{"type":"string","enum":["prohibited_phrase","prohibited_claim","required_element","visual_rule","format_rule","timing_rule","audience_rule"]},"severity":{"type":"string","enum":["block","warn","info"]},"detectionMethod":{"type":"string","enum":["regex","keyword","semantic","presence","image_ai","template"]},"patterns":{"type":["array","null"],"items":{"type":"string"}},"caseSensitive":{"type":"boolean"},"wholeWord":{"type":"boolean"},"semanticDescription":{"type":["string","null"]},"semanticExamples":{"type":["array","null"],"items":{"type":"string"}},"semanticModel":{"type":["string","null"]},"requiredText":{"type":["string","null"]},"requiredPlacement":{"type":["string","null"]},"conditions":{"type":["object","null"],"properties":{"triggers":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}},"violationMessage":{"type":"string"},"suggestionTemplate":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}},"legalReference":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"lastVerified":{"type":["number","null"]},"status":{"type":"string","enum":["active","deprecated","draft"]},"priority":{"type":"number"},"createdAt":{"type":"number"},"createdBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","rulesetId","code","name","description","ruleType","severity","detectionMethod","patterns","caseSensitive","wholeWord","semanticDescription","semanticExamples","semanticModel","requiredText","requiredPlacement","conditions","violationMessage","suggestionTemplate","alternatives","legalReference","sourceUrl","lastVerified","status","priority","createdAt","createdBy","updatedAt","updatedBy"]}},"required":["rule"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Compliance Engine"],"summary":"Delete a rule","description":"Delete a compliance rule.","parameters":[{"schema":{"type":"string"},"required":true,"name":"ruleId","in":"path"}],"responses":{"200":{"description":"Rule deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/checks":{"get":{"tags":["Compliance Engine"],"summary":"List compliance checks","description":"List historical compliance checks with filtering.","parameters":[{"schema":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"required":false,"name":"contentType","in":"query"},{"schema":{"type":"string","enum":["passed","blocked","warned","overridden"]},"required":false,"name":"outcome","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"productId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","default":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","default":"50"},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Checks list","content":{"application/json":{"schema":{"type":"object","properties":{"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contentType":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"contentPreview":{"type":["string","null"]},"contentLength":{"type":["number","null"]},"clientProfileId":{"type":["string","null"]},"productId":{"type":["string","null"]},"platform":{"type":["string","null"]},"passed":{"type":"boolean"},"score":{"type":["number","null"]},"outcome":{"type":"string","enum":["passed","blocked","warned","overridden"]},"violationsCount":{"type":"number"},"warningsCount":{"type":"number"},"rulesEvaluated":{"type":"number"},"overridden":{"type":"boolean"},"overriddenBy":{"type":["string","null"]},"overrideReason":{"type":["string","null"]},"durationMs":{"type":["number","null"]},"checkedAt":{"type":"number"},"checkedBy":{"type":["string","null"]}},"required":["id","organizationId","contentType","contentPreview","contentLength","clientProfileId","productId","platform","passed","score","outcome","violationsCount","warningsCount","rulesEvaluated","overridden","overriddenBy","overrideReason","durationMs","checkedAt","checkedBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["checks","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/checks/{checkId}":{"get":{"tags":["Compliance Engine"],"summary":"Get check details","description":"Get detailed results of a specific compliance check.","parameters":[{"schema":{"type":"string"},"required":true,"name":"checkId","in":"path"},{"schema":{"type":"string","default":"true"},"required":false,"name":"includeViolations","in":"query"}],"responses":{"200":{"description":"Check details","content":{"application/json":{"schema":{"type":"object","properties":{"check":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contentType":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"contentPreview":{"type":["string","null"]},"contentLength":{"type":["number","null"]},"clientProfileId":{"type":["string","null"]},"productId":{"type":["string","null"]},"platform":{"type":["string","null"]},"passed":{"type":"boolean"},"score":{"type":["number","null"]},"outcome":{"type":"string","enum":["passed","blocked","warned","overridden"]},"violationsCount":{"type":"number"},"warningsCount":{"type":"number"},"rulesEvaluated":{"type":"number"},"overridden":{"type":"boolean"},"overriddenBy":{"type":["string","null"]},"overrideReason":{"type":["string","null"]},"durationMs":{"type":["number","null"]},"checkedAt":{"type":"number"},"checkedBy":{"type":["string","null"]}},"required":["id","organizationId","contentType","contentPreview","contentLength","clientProfileId","productId","platform","passed","score","outcome","violationsCount","warningsCount","rulesEvaluated","overridden","overriddenBy","overrideReason","durationMs","checkedAt","checkedBy"]},"violations":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"ruleCode":{"type":"string"},"ruleName":{"type":"string"},"severity":{"type":"string","enum":["block","warn","info"]},"matchedContent":{"type":["string","null"]},"position":{"type":["object","null"],"properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"ruleDescription":{"type":["string","null"]},"reason":{"type":"string"},"source":{"type":"string"},"suggestion":{"type":["string","null"]},"alternatives":{"type":["array","null"],"items":{"type":"string"}}},"required":["ruleId","ruleCode","ruleName","severity","matchedContent","position","ruleDescription","reason","source","suggestion","alternatives"]}}},"required":["check"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/checks/{checkId}/override":{"post":{"tags":["Compliance Engine"],"summary":"Override a blocked check","description":"Override a compliance check that was blocked, with documented reason.","parameters":[{"schema":{"type":"string"},"required":true,"name":"checkId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":1}},"required":["reason"]}}}},"responses":{"200":{"description":"Check overridden","content":{"application/json":{"schema":{"type":"object","properties":{"check":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contentType":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"contentPreview":{"type":["string","null"]},"contentLength":{"type":["number","null"]},"clientProfileId":{"type":["string","null"]},"productId":{"type":["string","null"]},"platform":{"type":["string","null"]},"passed":{"type":"boolean"},"score":{"type":["number","null"]},"outcome":{"type":"string","enum":["passed","blocked","warned","overridden"]},"violationsCount":{"type":"number"},"warningsCount":{"type":"number"},"rulesEvaluated":{"type":"number"},"overridden":{"type":"boolean"},"overriddenBy":{"type":["string","null"]},"overrideReason":{"type":["string","null"]},"durationMs":{"type":["number","null"]},"checkedAt":{"type":"number"},"checkedBy":{"type":["string","null"]}},"required":["id","organizationId","contentType","contentPreview","contentLength","clientProfileId","productId","platform","passed","score","outcome","violationsCount","warningsCount","rulesEvaluated","overridden","overriddenBy","overrideReason","durationMs","checkedAt","checkedBy"]},"success":{"type":"boolean"}},"required":["check","success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/org-rulesets":{"get":{"tags":["Compliance Engine"],"summary":"List organization ruleset assignments","description":"List which rulesets are assigned to the organization.","responses":{"200":{"description":"Organization ruleset assignments","content":{"application/json":{"schema":{"type":"object","properties":{"assignments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"rulesetId":{"type":"string"},"rulesetName":{"type":"string"},"rulesetCategory":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"severityOverrides":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["block","warn","info"]}},"disabledRules":{"type":["array","null"],"items":{"type":"string"}},"assignedAt":{"type":"number"},"assignedBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","rulesetId","enabled","priority","severityOverrides","disabledRules","assignedAt","assignedBy","updatedAt"]}}},"required":["assignments"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Compliance Engine"],"summary":"Assign ruleset to organization","description":"Assign a ruleset to the organization with optional configuration.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rulesetId":{"type":"string","minLength":1},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","default":100},"severityOverrides":{"type":"object","additionalProperties":{"type":"string","enum":["block","warn","info"]}},"disabledRules":{"type":"array","items":{"type":"string"}}},"required":["rulesetId"]}}}},"responses":{"201":{"description":"Ruleset assigned","content":{"application/json":{"schema":{"type":"object","properties":{"assignment":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"rulesetId":{"type":"string"},"rulesetName":{"type":"string"},"rulesetCategory":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"severityOverrides":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["block","warn","info"]}},"disabledRules":{"type":["array","null"],"items":{"type":"string"}},"assignedAt":{"type":"number"},"assignedBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","rulesetId","enabled","priority","severityOverrides","disabledRules","assignedAt","assignedBy","updatedAt"]}},"required":["assignment"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/org-rulesets/{assignmentId}":{"patch":{"tags":["Compliance Engine"],"summary":"Update ruleset assignment","description":"Update an organization ruleset assignment (enable/disable, priority, overrides).","parameters":[{"schema":{"type":"string"},"required":true,"name":"assignmentId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","default":true},"priority":{"type":"number","default":100},"severityOverrides":{"type":"object","additionalProperties":{"type":"string","enum":["block","warn","info"]}},"disabledRules":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Assignment updated","content":{"application/json":{"schema":{"type":"object","properties":{"assignment":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"rulesetId":{"type":"string"},"rulesetName":{"type":"string"},"rulesetCategory":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"severityOverrides":{"type":["object","null"],"additionalProperties":{"type":"string","enum":["block","warn","info"]}},"disabledRules":{"type":["array","null"],"items":{"type":"string"}},"assignedAt":{"type":"number"},"assignedBy":{"type":["string","null"]},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","rulesetId","enabled","priority","severityOverrides","disabledRules","assignedAt","assignedBy","updatedAt"]}},"required":["assignment"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Compliance Engine"],"summary":"Remove ruleset assignment","description":"Remove a ruleset assignment from the organization.","parameters":[{"schema":{"type":"string"},"required":true,"name":"assignmentId","in":"path"}],"responses":{"200":{"description":"Assignment removed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/compliance/analytics":{"get":{"tags":["Compliance Engine"],"summary":"Get compliance analytics","description":"Get compliance analytics and trends for the organization.","parameters":[{"schema":{"type":"string"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"required":false,"name":"contentType","in":"query"}],"responses":{"200":{"description":"Compliance analytics","content":{"application/json":{"schema":{"type":"object","properties":{"analytics":{"type":"object","properties":{"period":{"type":"string"},"totalChecks":{"type":"number"},"passRate":{"type":"number"},"avgScore":{"type":"number"},"topViolations":{"type":"array","items":{"type":"object","properties":{"ruleCode":{"type":"string"},"ruleName":{"type":"string"},"count":{"type":"number"},"severity":{"type":"string","enum":["block","warn","info"]}},"required":["ruleCode","ruleName","count","severity"]}},"byContentType":{"type":"array","items":{"type":"object","properties":{"contentType":{"type":"string","enum":["ad_copy","social_post","video_script","email","proposal","landing_page","product_description"]},"checks":{"type":"number"},"passRate":{"type":"number"}},"required":["contentType","checks","passRate"]}},"byOutcome":{"type":"object","properties":{"passed":{"type":"number"},"blocked":{"type":"number"},"warned":{"type":"number"},"overridden":{"type":"number"}},"required":["passed","blocked","warned","overridden"]},"trend":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"checks":{"type":"number"},"passRate":{"type":"number"}},"required":["date","checks","passRate"]}}},"required":["period","totalChecks","passRate","avgScore","topViolations","byContentType","byOutcome","trend"]}},"required":["analytics"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//personality/profiles":{"get":{"tags":["Personality Intelligence"],"summary":"List personality profiles","description":"List personality profiles with optional filters","parameters":[{"schema":{"type":"string"},"required":false,"name":"contactId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clusterId","in":"query"},{"schema":{"type":"string","enum":["D","I","S","C"]},"required":false,"name":"discPrimary","in":"query"},{"schema":{"type":"boolean"},"required":false,"name":"isPredicted","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of personality profiles","content":{"application/json":{"schema":{"type":"object","properties":{"profiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["profiles","total","limit","offset"]}}}}}},"post":{"tags":["Personality Intelligence"],"summary":"Create personality profile","description":"Create a new personality profile for a contact","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contactId":{"type":"string","minLength":1},"communicationFrequency":{"type":"number","minimum":1,"maximum":10},"detailOrientation":{"type":"number","minimum":1,"maximum":10},"decisionSpeed":{"type":"number","minimum":1,"maximum":10},"feedbackDirectness":{"type":"number","minimum":1,"maximum":10},"trustLevel":{"type":"number","minimum":1,"maximum":10},"changeTolerance":{"type":"number","minimum":1,"maximum":10},"engagementStyle":{"type":"number","minimum":1,"maximum":10},"autonomyPreference":{"type":"number","minimum":1,"maximum":10},"isPredicted":{"type":"boolean","default":false},"predictionSources":{"type":"array","items":{"type":"string"}}},"required":["contactId"]}}}},"responses":{"201":{"description":"Created personality profile","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}}}}}}},"//personality/profiles/{profileId}":{"get":{"tags":["Personality Intelligence"],"summary":"Get personality profile by ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"profileId","in":"path"}],"responses":{"200":{"description":"Personality profile","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}}}}}},"patch":{"tags":["Personality Intelligence"],"summary":"Update personality profile","parameters":[{"schema":{"type":"string"},"required":true,"name":"profileId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"communicationFrequency":{"type":"number","minimum":1,"maximum":10},"detailOrientation":{"type":"number","minimum":1,"maximum":10},"decisionSpeed":{"type":"number","minimum":1,"maximum":10},"feedbackDirectness":{"type":"number","minimum":1,"maximum":10},"trustLevel":{"type":"number","minimum":1,"maximum":10},"changeTolerance":{"type":"number","minimum":1,"maximum":10},"engagementStyle":{"type":"number","minimum":1,"maximum":10},"autonomyPreference":{"type":"number","minimum":1,"maximum":10}}}}}},"responses":{"200":{"description":"Updated personality profile","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}}}}}},"delete":{"tags":["Personality Intelligence"],"summary":"Delete personality profile","parameters":[{"schema":{"type":"string"},"required":true,"name":"profileId","in":"path"}],"responses":{"200":{"description":"Profile deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"string"}},"required":["success","id"]}}}}}}},"//personality/contacts/{contactId}/profile":{"get":{"tags":["Personality Intelligence"],"summary":"Get personality profile by contact ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Personality profile for contact","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}}}}}}},"//personality/signals":{"get":{"tags":["Personality Intelligence"],"summary":"List personality signals","parameters":[{"schema":{"type":"string"},"required":false,"name":"contactId","in":"query"},{"schema":{"type":"string","enum":["communication_frequency","detail_orientation","decision_speed","feedback_directness","trust_level","change_tolerance","engagement_style","autonomy_preference"]},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["email","meeting","project","feedback","manual","linkedin","company","prediction"]},"required":false,"name":"source","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sourceId","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":500,"default":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of personality signals","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"dimension":{"type":"string","enum":["communication_frequency","detail_orientation","decision_speed","feedback_directness","trust_level","change_tolerance","engagement_style","autonomy_preference"]},"value":{"type":"number"},"confidence":{"type":"number"},"weight":{"type":["number","null"]},"source":{"type":"string","enum":["email","meeting","project","feedback","manual","linkedin","company","prediction"]},"sourceId":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidence":{"type":["string","null"]},"rawData":{},"features":{},"createdAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","dimension","value","confidence","weight","source","sourceId","sourceType","evidence","createdAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["signals","total","limit","offset"]}}}}}},"post":{"tags":["Personality Intelligence"],"summary":"Create personality signal","description":"Record a personality signal from an interaction","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contactId":{"type":"string","minLength":1},"dimension":{"type":"string","enum":["communication_frequency","detail_orientation","decision_speed","feedback_directness","trust_level","change_tolerance","engagement_style","autonomy_preference"]},"value":{"type":"number","minimum":1,"maximum":10},"confidence":{"type":"number","minimum":0,"maximum":1},"weight":{"type":"number","minimum":0,"maximum":10,"default":1},"source":{"type":"string","enum":["email","meeting","project","feedback","manual","linkedin","company","prediction"]},"sourceId":{"type":"string"},"sourceType":{"type":"string"},"evidence":{"type":"string"},"rawData":{},"features":{}},"required":["contactId","dimension","value","confidence","source"]}}}},"responses":{"201":{"description":"Created personality signal","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"dimension":{"type":"string","enum":["communication_frequency","detail_orientation","decision_speed","feedback_directness","trust_level","change_tolerance","engagement_style","autonomy_preference"]},"value":{"type":"number"},"confidence":{"type":"number"},"weight":{"type":["number","null"]},"source":{"type":"string","enum":["email","meeting","project","feedback","manual","linkedin","company","prediction"]},"sourceId":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidence":{"type":["string","null"]},"rawData":{},"features":{},"createdAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","dimension","value","confidence","weight","source","sourceId","sourceType","evidence","createdAt"]}}}}}}},"//personality/signals/bulk":{"post":{"tags":["Personality Intelligence"],"summary":"Create multiple personality signals","description":"Record multiple personality signals at once","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"contactId":{"type":"string","minLength":1},"dimension":{"type":"string","enum":["communication_frequency","detail_orientation","decision_speed","feedback_directness","trust_level","change_tolerance","engagement_style","autonomy_preference"]},"value":{"type":"number","minimum":1,"maximum":10},"confidence":{"type":"number","minimum":0,"maximum":1},"weight":{"type":"number","minimum":0,"maximum":10,"default":1},"source":{"type":"string","enum":["email","meeting","project","feedback","manual","linkedin","company","prediction"]},"sourceId":{"type":"string"},"sourceType":{"type":"string"},"evidence":{"type":"string"},"rawData":{},"features":{}},"required":["contactId","dimension","value","confidence","source"]}}},"required":["signals"]}}}},"responses":{"201":{"description":"Bulk create result","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"number"},"contactsAffected":{"type":"number"}},"required":["created","contactsAffected"]}}}}}}},"//personality/calculate":{"post":{"tags":["Personality Intelligence"],"summary":"Calculate personality profile from signals","description":"Aggregate signals to compute personality profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contactId":{"type":"string","minLength":1},"force":{"type":"boolean","default":false}},"required":["contactId"]}}}},"responses":{"200":{"description":"Calculated personality profile","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]}}}}}}},"//personality/assign-cluster":{"post":{"tags":["Personality Intelligence"],"summary":"Assign contact to personality cluster","description":"Find and assign the nearest personality cluster","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contactId":{"type":"string","minLength":1},"force":{"type":"boolean","default":false}},"required":["contactId"]}}}},"responses":{"200":{"description":"Cluster assignment result","content":{"application/json":{"schema":{"type":"object","properties":{"contactId":{"type":"string"},"clusterId":{"type":"string"},"clusterName":{"type":"string"},"confidence":{"type":"number"}},"required":["contactId","clusterId","clusterName","confidence"]}}}}}}},"//personality/clusters":{"get":{"tags":["Personality Intelligence"],"summary":"List personality clusters","parameters":[{"schema":{"type":["boolean","null"],"default":true},"required":false,"name":"includeSystem","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of personality clusters","content":{"application/json":{"schema":{"type":"object","properties":{"clusters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"isSystem":{"type":"boolean"},"centroidCommunicationFrequency":{"type":["number","null"]},"centroidDetailOrientation":{"type":["number","null"]},"centroidDecisionSpeed":{"type":["number","null"]},"centroidFeedbackDirectness":{"type":["number","null"]},"centroidTrustLevel":{"type":["number","null"]},"centroidChangeTolerance":{"type":["number","null"]},"centroidEngagementStyle":{"type":["number","null"]},"centroidAutonomyPreference":{"type":["number","null"]},"discPrimaryTendency":{"type":["string","null"]},"discSecondaryTendency":{"type":["string","null"]},"playbook":{},"memberCount":{"type":"number"},"avgClusterSimilarity":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","name","description","isSystem","centroidCommunicationFrequency","centroidDetailOrientation","centroidDecisionSpeed","centroidFeedbackDirectness","centroidTrustLevel","centroidChangeTolerance","centroidEngagementStyle","centroidAutonomyPreference","discPrimaryTendency","discSecondaryTendency","memberCount","avgClusterSimilarity","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["clusters","total","limit","offset"]}}}}}}},"//personality/clusters/{clusterId}":{"get":{"tags":["Personality Intelligence"],"summary":"Get personality cluster by ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"clusterId","in":"path"}],"responses":{"200":{"description":"Personality cluster","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"isSystem":{"type":"boolean"},"centroidCommunicationFrequency":{"type":["number","null"]},"centroidDetailOrientation":{"type":["number","null"]},"centroidDecisionSpeed":{"type":["number","null"]},"centroidFeedbackDirectness":{"type":["number","null"]},"centroidTrustLevel":{"type":["number","null"]},"centroidChangeTolerance":{"type":["number","null"]},"centroidEngagementStyle":{"type":["number","null"]},"centroidAutonomyPreference":{"type":["number","null"]},"discPrimaryTendency":{"type":["string","null"]},"discSecondaryTendency":{"type":["string","null"]},"playbook":{},"memberCount":{"type":"number"},"avgClusterSimilarity":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","name","description","isSystem","centroidCommunicationFrequency","centroidDetailOrientation","centroidDecisionSpeed","centroidFeedbackDirectness","centroidTrustLevel","centroidChangeTolerance","centroidEngagementStyle","centroidAutonomyPreference","discPrimaryTendency","discSecondaryTendency","memberCount","avgClusterSimilarity","createdAt","updatedAt"]}}}}}}},"//personality/similar":{"get":{"tags":["Personality Intelligence"],"summary":"Find similar contacts","description":"Find contacts with similar personality profiles","parameters":[{"schema":{"type":"string"},"required":true,"name":"contactId","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":50,"default":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"default":0.5},"required":false,"name":"minSimilarity","in":"query"}],"responses":{"200":{"description":"Similar contacts","content":{"application/json":{"schema":{"type":"object","properties":{"sourceContactId":{"type":"string"},"similar":{"type":"array","items":{"type":"object","properties":{"contactId":{"type":"string"},"profile":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"communicationFrequency":{"type":["number","null"]},"detailOrientation":{"type":["number","null"]},"decisionSpeed":{"type":["number","null"]},"feedbackDirectness":{"type":["number","null"]},"trustLevel":{"type":["number","null"]},"changeTolerance":{"type":["number","null"]},"engagementStyle":{"type":["number","null"]},"autonomyPreference":{"type":["number","null"]},"communicationFrequencyConfidence":{"type":["number","null"]},"detailOrientationConfidence":{"type":["number","null"]},"decisionSpeedConfidence":{"type":["number","null"]},"feedbackDirectnessConfidence":{"type":["number","null"]},"trustLevelConfidence":{"type":["number","null"]},"changeToleranceConfidence":{"type":["number","null"]},"engagementStyleConfidence":{"type":["number","null"]},"autonomyPreferenceConfidence":{"type":["number","null"]},"discD":{"type":["number","null"]},"discI":{"type":["number","null"]},"discS":{"type":["number","null"]},"discC":{"type":["number","null"]},"discPrimary":{"type":["string","null"]},"discSecondary":{"type":["string","null"]},"discStyle":{"type":["string","null"]},"clusterId":{"type":["string","null"]},"clusterName":{"type":["string","null"]},"clusterConfidence":{"type":["number","null"]},"signalCount":{"type":"number"},"lastSignalAt":{"type":["string","null"]},"lastCalculatedAt":{"type":["string","null"]},"profileVersion":{"type":"number"},"isPredicted":{"type":"boolean"},"predictionSources":{"type":["array","null"],"items":{"type":"string"}},"predictionConfidence":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","communicationFrequency","detailOrientation","decisionSpeed","feedbackDirectness","trustLevel","changeTolerance","engagementStyle","autonomyPreference","communicationFrequencyConfidence","detailOrientationConfidence","decisionSpeedConfidence","feedbackDirectnessConfidence","trustLevelConfidence","changeToleranceConfidence","engagementStyleConfidence","autonomyPreferenceConfidence","discD","discI","discS","discC","discPrimary","discSecondary","discStyle","clusterId","clusterName","clusterConfidence","signalCount","lastSignalAt","lastCalculatedAt","profileVersion","isPredicted","predictionSources","predictionConfidence","createdAt","updatedAt"]},"similarity":{"type":"number"},"dimensionSimilarity":{"type":"object","additionalProperties":{"type":"number"}}},"required":["contactId","profile","similarity","dimensionSimilarity"]}},"total":{"type":"number"}},"required":["sourceContactId","similar","total"]}}}}}}},"//personality/playbooks":{"get":{"tags":["Personality Intelligence"],"summary":"List personality playbooks","parameters":[{"schema":{"type":"string","enum":["disc","cluster","custom"]},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"targetId","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of personality playbooks","content":{"application/json":{"schema":{"type":"object","properties":{"playbooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"type":{"type":"string"},"targetId":{"type":["string","null"]},"name":{"type":"string"},"summary":{"type":["string","null"]},"doList":{"type":["array","null"],"items":{"type":"string"}},"dontList":{"type":["array","null"],"items":{"type":"string"}},"emailTemplate":{"type":["string","null"]},"meetingStyle":{"type":["string","null"]},"communicationTips":{"type":["array","null"],"items":{"type":"string"}},"warningSignals":{"type":["array","null"],"items":{"type":"string"}},"successIndicators":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","type","targetId","name","summary","doList","dontList","emailTemplate","meetingStyle","communicationTips","warningSignals","successIndicators","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["playbooks","total","limit","offset"]}}}}}}},"//personality/playbooks/{playbookId}":{"get":{"tags":["Personality Intelligence"],"summary":"Get personality playbook by ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"playbookId","in":"path"}],"responses":{"200":{"description":"Personality playbook","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"type":{"type":"string"},"targetId":{"type":["string","null"]},"name":{"type":"string"},"summary":{"type":["string","null"]},"doList":{"type":["array","null"],"items":{"type":"string"}},"dontList":{"type":["array","null"],"items":{"type":"string"}},"emailTemplate":{"type":["string","null"]},"meetingStyle":{"type":["string","null"]},"communicationTips":{"type":["array","null"],"items":{"type":"string"}},"warningSignals":{"type":["array","null"],"items":{"type":"string"}},"successIndicators":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","type","targetId","name","summary","doList","dontList","emailTemplate","meetingStyle","communicationTips","warningSignals","successIndicators","createdAt","updatedAt"]}}}}}}},"//personality/contacts/{contactId}/playbook":{"get":{"tags":["Personality Intelligence"],"summary":"Get playbook for contact","description":"Get the recommended playbook based on contact DISC type","parameters":[{"schema":{"type":"string"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Personality playbook for contact","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"type":{"type":"string"},"targetId":{"type":["string","null"]},"name":{"type":"string"},"summary":{"type":["string","null"]},"doList":{"type":["array","null"],"items":{"type":"string"}},"dontList":{"type":["array","null"],"items":{"type":"string"}},"emailTemplate":{"type":["string","null"]},"meetingStyle":{"type":["string","null"]},"communicationTips":{"type":["array","null"],"items":{"type":"string"}},"warningSignals":{"type":["array","null"],"items":{"type":"string"}},"successIndicators":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","type","targetId","name","summary","doList","dontList","emailTemplate","meetingStyle","communicationTips","warningSignals","successIndicators","createdAt","updatedAt"]}}}}}}},"//personality/contacts/{contactId}/disc":{"get":{"tags":["Personality Intelligence"],"summary":"Get DISC profile for contact","description":"Get the DISC breakdown and playbook for a contact","parameters":[{"schema":{"type":"string"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"DISC profile with playbook","content":{"application/json":{"schema":{"type":"object","properties":{"disc":{"type":"object","properties":{"D":{"type":"number"},"I":{"type":"number"},"S":{"type":"number"},"C":{"type":"number"},"primaryType":{"type":"string","enum":["D","I","S","C"]},"secondaryType":{"type":["string","null"],"enum":["D","I","S","C",null]},"discStyle":{"type":"string"}},"required":["D","I","S","C","primaryType","secondaryType","discStyle"]},"description":{"type":"string"},"playbook":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"type":{"type":"string"},"targetId":{"type":["string","null"]},"name":{"type":"string"},"summary":{"type":["string","null"]},"doList":{"type":["array","null"],"items":{"type":"string"}},"dontList":{"type":["array","null"],"items":{"type":"string"}},"emailTemplate":{"type":["string","null"]},"meetingStyle":{"type":["string","null"]},"communicationTips":{"type":["array","null"],"items":{"type":"string"}},"warningSignals":{"type":["array","null"],"items":{"type":"string"}},"successIndicators":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","type","targetId","name","summary","doList","dontList","emailTemplate","meetingStyle","communicationTips","warningSignals","successIndicators","createdAt","updatedAt"]}},"required":["disc","description","playbook"]}}}}}}},"/conversations/knowledge":{"get":{"tags":["Conversation Intelligence"],"summary":"List knowledge items","description":"List extracted knowledge items across conversations.","parameters":[{"schema":{"type":"string"},"required":false,"name":"conversationId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"required":false,"name":"knowledgeType","in":"query"},{"schema":{"type":"string","enum":["brand","compliance","product","process","pricing","competitor","timeline","other"]},"required":false,"name":"category","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isVerified","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of knowledge items","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":["string","null"],"enum":["brand","compliance","product","process","pricing","competitor","timeline","other",null]},"content":{"type":"string"},"context":{"type":["string","null"]},"speaker":{"type":["string","null"]},"timestamp":{"type":["number","null"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"appliedTo":{"type":["string","null"]},"appliedId":{"type":["string","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","clientProfileId","knowledgeType","category","content","context","speaker","timestamp","confidence","isVerified","verifiedBy","appliedTo","appliedId","createdAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["items","total","limit","offset"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/knowledge/{knowledgeId}":{"get":{"tags":["Conversation Intelligence"],"summary":"Get knowledge item","description":"Get a specific knowledge item.","parameters":[{"schema":{"type":"string"},"required":true,"name":"knowledgeId","in":"path"}],"responses":{"200":{"description":"Knowledge item details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":["string","null"],"enum":["brand","compliance","product","process","pricing","competitor","timeline","other",null]},"content":{"type":"string"},"context":{"type":["string","null"]},"speaker":{"type":["string","null"]},"timestamp":{"type":["number","null"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"appliedTo":{"type":["string","null"]},"appliedId":{"type":["string","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","clientProfileId","knowledgeType","category","content","context","speaker","timestamp","confidence","isVerified","verifiedBy","appliedTo","appliedId","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Conversation Intelligence"],"summary":"Delete knowledge item","description":"Soft delete a knowledge item.","parameters":[{"schema":{"type":"string"},"required":true,"name":"knowledgeId","in":"path"}],"responses":{"200":{"description":"Knowledge item deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/knowledge/{knowledgeId}/verify":{"patch":{"tags":["Conversation Intelligence"],"summary":"Verify knowledge item","description":"Mark a knowledge item as verified or unverified.","parameters":[{"schema":{"type":"string"},"required":true,"name":"knowledgeId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isVerified":{"type":"boolean"}},"required":["isVerified"]}}}},"responses":{"200":{"description":"Knowledge item updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":["string","null"],"enum":["brand","compliance","product","process","pricing","competitor","timeline","other",null]},"content":{"type":"string"},"context":{"type":["string","null"]},"speaker":{"type":["string","null"]},"timestamp":{"type":["number","null"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"appliedTo":{"type":["string","null"]},"appliedId":{"type":["string","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","clientProfileId","knowledgeType","category","content","context","speaker","timestamp","confidence","isVerified","verifiedBy","appliedTo","appliedId","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/knowledge/{knowledgeId}/apply":{"post":{"tags":["Conversation Intelligence"],"summary":"Apply knowledge","description":"Apply a knowledge item to create a restriction, preference, or compliance rule.","parameters":[{"schema":{"type":"string"},"required":true,"name":"knowledgeId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"targetType":{"type":"string","enum":["restriction","preference","compliance_rule"]}},"required":["targetType"]}}}},"responses":{"200":{"description":"Knowledge applied","content":{"application/json":{"schema":{"type":"object","properties":{"knowledgeItem":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":["string","null"],"enum":["brand","compliance","product","process","pricing","competitor","timeline","other",null]},"content":{"type":"string"},"context":{"type":["string","null"]},"speaker":{"type":["string","null"]},"timestamp":{"type":["number","null"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"appliedTo":{"type":["string","null"]},"appliedId":{"type":["string","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","clientProfileId","knowledgeType","category","content","context","speaker","timestamp","confidence","isVerified","verifiedBy","appliedTo","appliedId","createdAt"]},"appliedTo":{"type":"string"},"appliedId":{"type":"string"}},"required":["knowledgeItem","appliedTo","appliedId"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations":{"get":{"tags":["Conversation Intelligence"],"summary":"List conversations","description":"List all conversations with optional filtering.","parameters":[{"schema":{"type":"string"},"required":false,"name":"clientProfileId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"crmAccountId","in":"query"},{"schema":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"required":false,"name":"source","in":"query"},{"schema":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"required":false,"name":"status","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"startedAfter","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"startedBefore","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of conversations","content":{"application/json":{"schema":{"type":"object","properties":{"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"crmAccountId":{"type":["string","null"]},"crmContactId":{"type":["string","null"]},"source":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"sourceId":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"scheduledAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"endedAt":{"type":["number","null"]},"durationSeconds":{"type":["number","null"]},"participants":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"participantCount":{"type":["number","null"]},"recordingUrl":{"type":["string","null"]},"recordingFormat":{"type":["string","null"]},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"errorMessage":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","crmAccountId","crmContactId","source","sourceId","sourceUrl","title","description","scheduledAt","startedAt","endedAt","durationSeconds","participants","participantCount","recordingUrl","recordingFormat","status","errorMessage","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["conversations","total","limit","offset"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Conversation Intelligence"],"summary":"Create conversation","description":"Create a new conversation record.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"sourceId":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":2000},"clientProfileId":{"type":"string"},"crmAccountId":{"type":"string"},"crmContactId":{"type":"string"},"scheduledAt":{"type":"number"},"startedAt":{"type":"number"},"endedAt":{"type":"number"},"durationSeconds":{"type":"number","minimum":0},"participants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"recordingUrl":{"type":"string","format":"uri"},"recordingFormat":{"type":"string"}},"required":["source"]}}}},"responses":{"201":{"description":"Conversation created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"crmAccountId":{"type":["string","null"]},"crmContactId":{"type":["string","null"]},"source":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"sourceId":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"scheduledAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"endedAt":{"type":["number","null"]},"durationSeconds":{"type":["number","null"]},"participants":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"participantCount":{"type":["number","null"]},"recordingUrl":{"type":["string","null"]},"recordingFormat":{"type":["string","null"]},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"errorMessage":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","crmAccountId","crmContactId","source","sourceId","sourceUrl","title","description","scheduledAt","startedAt","endedAt","durationSeconds","participants","participantCount","recordingUrl","recordingFormat","status","errorMessage","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}":{"get":{"tags":["Conversation Intelligence"],"summary":"Get conversation","description":"Get a specific conversation by ID.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Conversation details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"crmAccountId":{"type":["string","null"]},"crmContactId":{"type":["string","null"]},"source":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"sourceId":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"scheduledAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"endedAt":{"type":["number","null"]},"durationSeconds":{"type":["number","null"]},"participants":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"participantCount":{"type":["number","null"]},"recordingUrl":{"type":["string","null"]},"recordingFormat":{"type":["string","null"]},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"errorMessage":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","crmAccountId","crmContactId","source","sourceId","sourceUrl","title","description","scheduledAt","startedAt","endedAt","durationSeconds","participants","participantCount","recordingUrl","recordingFormat","status","errorMessage","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Conversation Intelligence"],"summary":"Update conversation","description":"Update a conversation record.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":2000},"clientProfileId":{"type":["string","null"]},"crmAccountId":{"type":["string","null"]},"crmContactId":{"type":["string","null"]},"participants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]}}}}}},"responses":{"200":{"description":"Conversation updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"crmAccountId":{"type":["string","null"]},"crmContactId":{"type":["string","null"]},"source":{"type":"string","enum":["zoom","google_meet","phone","chat","email","teams","other"]},"sourceId":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"scheduledAt":{"type":["number","null"]},"startedAt":{"type":["number","null"]},"endedAt":{"type":["number","null"]},"durationSeconds":{"type":["number","null"]},"participants":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"role":{"type":"string"},"isInternal":{"type":"boolean"}},"required":["name"]}},"participantCount":{"type":["number","null"]},"recordingUrl":{"type":["string","null"]},"recordingFormat":{"type":["string","null"]},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"errorMessage":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","crmAccountId","crmContactId","source","sourceId","sourceUrl","title","description","scheduledAt","startedAt","endedAt","durationSeconds","participants","participantCount","recordingUrl","recordingFormat","status","errorMessage","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Conversation Intelligence"],"summary":"Delete conversation","description":"Soft delete a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Conversation deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/transcript":{"get":{"tags":["Conversation Intelligence"],"summary":"Get transcript","description":"Get the transcript for a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Transcript content","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"fullText":{"type":["string","null"]},"wordCount":{"type":["number","null"]},"language":{"type":["string","null"]},"transcriptionModel":{"type":["string","null"]},"confidence":{"type":["number","null"]},"hasTimestamps":{"type":"boolean"},"segments":{"type":["array","null"],"items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"string"},"text":{"type":"string"},"confidence":{"type":"number"}},"required":["start","end","text"]}},"createdAt":{"type":"number"}},"required":["id","conversationId","fullText","wordCount","language","transcriptionModel","confidence","hasTimestamps","segments","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Conversation Intelligence"],"summary":"Upload transcript","description":"Upload a transcript for a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fullText":{"type":"string","minLength":1},"language":{"type":"string","default":"en"},"segments":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"string"},"text":{"type":"string"},"confidence":{"type":"number"}},"required":["start","end","text"]}}},"required":["fullText"]}}}},"responses":{"201":{"description":"Transcript uploaded","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"fullText":{"type":["string","null"]},"wordCount":{"type":["number","null"]},"language":{"type":["string","null"]},"transcriptionModel":{"type":["string","null"]},"confidence":{"type":["number","null"]},"hasTimestamps":{"type":"boolean"},"segments":{"type":["array","null"],"items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"string"},"text":{"type":"string"},"confidence":{"type":"number"}},"required":["start","end","text"]}},"createdAt":{"type":"number"}},"required":["id","conversationId","fullText","wordCount","language","transcriptionModel","confidence","hasTimestamps","segments","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/transcribe":{"post":{"tags":["Conversation Intelligence"],"summary":"Transcribe recording","description":"Start AI transcription of a conversation recording.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"recordingUrl":{"type":"string","format":"uri"},"model":{"type":"string","enum":["whisper-1","whisper-large"],"default":"whisper-1"}}}}}},"responses":{"202":{"description":"Transcription started","content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string"},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"progress":{"type":"number","minimum":0,"maximum":100},"currentStep":{"type":["string","null"]},"hasTranscript":{"type":"boolean"},"hasExtraction":{"type":"boolean"},"errorMessage":{"type":["string","null"]}},"required":["conversationId","status","progress","currentStep","hasTranscript","hasExtraction","errorMessage"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/extraction":{"get":{"tags":["Conversation Intelligence"],"summary":"Get extraction","description":"Get extracted knowledge from a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Extraction results","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"summary":{"type":["string","null"]},"keyPoints":{"type":["array","null"],"items":{"type":"string"}},"actionItems":{"type":["array","null"],"items":{"type":"object","properties":{"task":{"type":"string"},"assignee":{"type":"string"},"deadline":{"type":"string"},"priority":{"type":"string","enum":["high","medium","low"]}},"required":["task"]}},"restrictionsFound":{"type":["array","null"],"items":{"type":"string"}},"preferencesFound":{"type":["array","null"],"items":{"type":"string"}},"decisionsFound":{"type":["array","null"],"items":{"type":"string"}},"questionsRaised":{"type":["array","null"],"items":{"type":"string"}},"overallSentiment":{"type":["string","null"],"enum":["positive","neutral","negative",null]},"sentimentScore":{"type":["number","null"]},"clientMood":{"type":["string","null"]},"topics":{"type":["array","null"],"items":{"type":"object","properties":{"topic":{"type":"string"},"mentions":{"type":"number"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]}},"required":["topic","mentions"]}},"products":{"type":["array","null"],"items":{"type":"string"}},"competitors":{"type":["array","null"],"items":{"type":"string"}},"extractionModel":{"type":["string","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","summary","keyPoints","actionItems","restrictionsFound","preferencesFound","decisionsFound","questionsRaised","overallSentiment","sentimentScore","clientMood","topics","products","competitors","extractionModel","isVerified","verifiedBy","verifiedAt","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/extract":{"post":{"tags":["Conversation Intelligence"],"summary":"Extract knowledge","description":"Start AI extraction from a conversation transcript.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","enum":["claude-3-haiku","claude-3-sonnet","claude-3-opus"],"default":"claude-3-sonnet"},"extractRestrictions":{"type":"boolean","default":true},"extractPreferences":{"type":"boolean","default":true},"extractActionItems":{"type":"boolean","default":true},"extractDecisions":{"type":"boolean","default":true}}}}}},"responses":{"202":{"description":"Extraction started","content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string"},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"progress":{"type":"number","minimum":0,"maximum":100},"currentStep":{"type":["string","null"]},"hasTranscript":{"type":"boolean"},"hasExtraction":{"type":"boolean"},"errorMessage":{"type":["string","null"]}},"required":["conversationId","status","progress","currentStep","hasTranscript","hasExtraction","errorMessage"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/extraction/verify":{"post":{"tags":["Conversation Intelligence"],"summary":"Verify extraction","description":"Mark an extraction as human-verified.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Extraction verified","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"summary":{"type":["string","null"]},"keyPoints":{"type":["array","null"],"items":{"type":"string"}},"actionItems":{"type":["array","null"],"items":{"type":"object","properties":{"task":{"type":"string"},"assignee":{"type":"string"},"deadline":{"type":"string"},"priority":{"type":"string","enum":["high","medium","low"]}},"required":["task"]}},"restrictionsFound":{"type":["array","null"],"items":{"type":"string"}},"preferencesFound":{"type":["array","null"],"items":{"type":"string"}},"decisionsFound":{"type":["array","null"],"items":{"type":"string"}},"questionsRaised":{"type":["array","null"],"items":{"type":"string"}},"overallSentiment":{"type":["string","null"],"enum":["positive","neutral","negative",null]},"sentimentScore":{"type":["number","null"]},"clientMood":{"type":["string","null"]},"topics":{"type":["array","null"],"items":{"type":"object","properties":{"topic":{"type":"string"},"mentions":{"type":"number"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]}},"required":["topic","mentions"]}},"products":{"type":["array","null"],"items":{"type":"string"}},"competitors":{"type":["array","null"],"items":{"type":"string"}},"extractionModel":{"type":["string","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","summary","keyPoints","actionItems","restrictionsFound","preferencesFound","decisionsFound","questionsRaised","overallSentiment","sentimentScore","clientMood","topics","products","competitors","extractionModel","isVerified","verifiedBy","verifiedAt","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/speakers":{"get":{"tags":["Conversation Intelligence"],"summary":"List speakers","description":"List all speakers in a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"List of speakers","content":{"application/json":{"schema":{"type":"object","properties":{"speakers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"speakerLabel":{"type":"string"},"speakerName":{"type":["string","null"]},"speakerEmail":{"type":["string","null"]},"isInternal":{"type":["boolean","null"]},"talkTimeSeconds":{"type":["number","null"]},"talkTimePercent":{"type":["number","null"]},"wordCount":{"type":["number","null"]},"turnCount":{"type":["number","null"]},"sentiment":{"type":["string","null"]},"sentimentScore":{"type":["number","null"]},"keyPhrases":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"}},"required":["id","conversationId","speakerLabel","speakerName","speakerEmail","isInternal","talkTimeSeconds","talkTimePercent","wordCount","turnCount","sentiment","sentimentScore","keyPhrases","createdAt"]}}},"required":["speakers"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/speakers/{speakerId}":{"patch":{"tags":["Conversation Intelligence"],"summary":"Identify speaker","description":"Identify a speaker by name/email.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"speakerId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"speakerLabel":{"type":"string"},"speakerName":{"type":"string"},"speakerEmail":{"type":"string","format":"email"},"isInternal":{"type":"boolean"}},"required":["speakerLabel","speakerName"]}}}},"responses":{"200":{"description":"Speaker identified","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"speakerLabel":{"type":"string"},"speakerName":{"type":["string","null"]},"speakerEmail":{"type":["string","null"]},"isInternal":{"type":["boolean","null"]},"talkTimeSeconds":{"type":["number","null"]},"talkTimePercent":{"type":["number","null"]},"wordCount":{"type":["number","null"]},"turnCount":{"type":["number","null"]},"sentiment":{"type":["string","null"]},"sentimentScore":{"type":["number","null"]},"keyPhrases":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"}},"required":["id","conversationId","speakerLabel","speakerName","speakerEmail","isInternal","talkTimeSeconds","talkTimePercent","wordCount","turnCount","sentiment","sentimentScore","keyPhrases","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/knowledge":{"post":{"tags":["Conversation Intelligence"],"summary":"Create knowledge item","description":"Manually create a knowledge item from a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":"string","enum":["brand","compliance","product","process","pricing","competitor","timeline","other"]},"content":{"type":"string","minLength":1,"maxLength":2000},"context":{"type":"string","maxLength":5000},"speaker":{"type":"string"},"timestamp":{"type":"number"},"confidence":{"type":"number","minimum":0,"maximum":1},"clientProfileId":{"type":"string"}},"required":["knowledgeType","content"]}}}},"responses":{"201":{"description":"Knowledge item created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":["string","null"]},"knowledgeType":{"type":"string","enum":["restriction","preference","decision","action_item","insight","question"]},"category":{"type":["string","null"],"enum":["brand","compliance","product","process","pricing","competitor","timeline","other",null]},"content":{"type":"string"},"context":{"type":["string","null"]},"speaker":{"type":["string","null"]},"timestamp":{"type":["number","null"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"appliedTo":{"type":["string","null"]},"appliedId":{"type":["string","null"]},"createdAt":{"type":"number"}},"required":["id","conversationId","organizationId","clientProfileId","knowledgeType","category","content","context","speaker","timestamp","confidence","isVerified","verifiedBy","appliedTo","appliedId","createdAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/conversations/{conversationId}/status":{"get":{"tags":["Conversation Intelligence"],"summary":"Get processing status","description":"Get the current processing status of a conversation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"conversationId","in":"path"}],"responses":{"200":{"description":"Processing status","content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string"},"status":{"type":"string","enum":["pending","uploading","transcribing","extracting","complete","failed"]},"progress":{"type":"number","minimum":0,"maximum":100},"currentStep":{"type":["string","null"]},"hasTranscript":{"type":"boolean"},"hasExtraction":{"type":"boolean"},"errorMessage":{"type":["string","null"]}},"required":["conversationId","status","progress","currentStep","hasTranscript","hasExtraction","errorMessage"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/preferences/events":{"get":{"tags":["Preference Learning"],"summary":"List approval events","description":"List approval/rejection events with filtering and pagination.","parameters":[{"schema":{"type":"string","description":"Filter by client profile"},"required":false,"description":"Filter by client profile","name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"],"description":"Filter by content type"},"required":false,"description":"Filter by content type","name":"contentType","in":"query"},{"schema":{"type":"string","enum":["approved","rejected","revision_requested"],"description":"Filter by decision"},"required":false,"description":"Filter by decision","name":"decision","in":"query"},{"schema":{"type":["boolean","null"],"description":"Filter by processing status"},"required":false,"description":"Filter by processing status","name":"isProcessed","in":"query"},{"schema":{"type":["number","null"],"description":"Filter events after this date"},"required":false,"description":"Filter events after this date","name":"startDate","in":"query"},{"schema":{"type":["number","null"],"description":"Filter events before this date"},"required":false,"description":"Filter events before this date","name":"endDate","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"description":"Max results","name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"List of approval events","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"]},"contentId":{"type":["string","null"]},"contentHash":{"type":["string","null"]},"decision":{"type":"string","enum":["approved","rejected","revision_requested"]},"decisionBy":{"type":["string","null"]},"decisionAt":{"type":"number"},"revisionNotes":{"type":["string","null"]},"revisionType":{"type":["string","null"],"enum":["shorter","longer","different_tone","different_color","different_style","different_format","more_detail","less_detail","other",null]},"attributes":{"type":["object","null"],"additionalProperties":{}},"isProcessed":{"type":"boolean"},"processedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","contentType","contentId","contentHash","decision","decisionBy","decisionAt","revisionNotes","revisionType","attributes","isProcessed","processedAt","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["events","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Preference Learning"],"summary":"Record approval event","description":"Record a new approval, rejection, or revision request event.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","description":"Client profile to record event for"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"],"description":"Type of content reviewed"},"contentId":{"type":"string","description":"Reference to the content"},"contentHash":{"type":"string","description":"Hash for deduplication"},"decision":{"type":"string","enum":["approved","rejected","revision_requested"],"description":"The approval decision"},"decisionBy":{"type":"string","description":"Contact who made the decision"},"decisionAt":{"type":"number","description":"When the decision was made (epoch ms)"},"revisionNotes":{"type":"string","description":"Notes if revision requested"},"revisionType":{"type":"string","enum":["shorter","longer","different_tone","different_color","different_style","different_format","more_detail","less_detail","other"],"description":"Type of revision requested"},"attributes":{"type":"object","additionalProperties":{},"description":"Content attributes at time of decision","example":{"color":"blue","length":"short","style":"ugc"}}},"required":["clientProfileId","contentType","decision"]}}}},"responses":{"201":{"description":"Event created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"]},"contentId":{"type":["string","null"]},"contentHash":{"type":["string","null"]},"decision":{"type":"string","enum":["approved","rejected","revision_requested"]},"decisionBy":{"type":["string","null"]},"decisionAt":{"type":"number"},"revisionNotes":{"type":["string","null"]},"revisionType":{"type":["string","null"],"enum":["shorter","longer","different_tone","different_color","different_style","different_format","more_detail","less_detail","other",null]},"attributes":{"type":["object","null"],"additionalProperties":{}},"isProcessed":{"type":"boolean"},"processedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","contentType","contentId","contentHash","decision","decisionBy","decisionAt","revisionNotes","revisionType","attributes","isProcessed","processedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/events/{eventId}":{"get":{"tags":["Preference Learning"],"summary":"Get approval event","description":"Get details of a specific approval event.","parameters":[{"schema":{"type":"string"},"required":true,"name":"eventId","in":"path"}],"responses":{"200":{"description":"Approval event details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"]},"contentId":{"type":["string","null"]},"contentHash":{"type":["string","null"]},"decision":{"type":"string","enum":["approved","rejected","revision_requested"]},"decisionBy":{"type":["string","null"]},"decisionAt":{"type":"number"},"revisionNotes":{"type":["string","null"]},"revisionType":{"type":["string","null"],"enum":["shorter","longer","different_tone","different_color","different_style","different_format","more_detail","less_detail","other",null]},"attributes":{"type":["object","null"],"additionalProperties":{}},"isProcessed":{"type":"boolean"},"processedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","contentType","contentId","contentHash","decision","decisionBy","decisionAt","revisionNotes","revisionType","attributes","isProcessed","processedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Preference Learning"],"summary":"Delete approval event","description":"Soft delete an approval event.","parameters":[{"schema":{"type":"string"},"required":true,"name":"eventId","in":"path"}],"responses":{"200":{"description":"Event deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/learned":{"get":{"tags":["Preference Learning"],"summary":"List learned preferences","description":"List all learned preferences with filtering.","parameters":[{"schema":{"type":"string","description":"Filter by client profile"},"required":false,"description":"Filter by client profile","name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"],"description":"Filter by category"},"required":false,"description":"Filter by category","name":"category","in":"query"},{"schema":{"type":"string","description":"Filter by attribute"},"required":false,"description":"Filter by attribute","name":"attribute","in":"query"},{"schema":{"type":"string","enum":["implicit","explicit","manual","conversation"],"description":"Filter by source"},"required":false,"description":"Filter by source","name":"source","in":"query"},{"schema":{"type":["boolean","null"],"description":"Filter by verification"},"required":false,"description":"Filter by verification","name":"isVerified","in":"query"},{"schema":{"type":["boolean","null"],"description":"Filter by active status"},"required":false,"description":"Filter by active status","name":"isActive","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Minimum confidence"},"required":false,"description":"Minimum confidence","name":"minConfidence","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"description":"Max results","name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"List of learned preferences","content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"]},"attribute":{"type":"string"},"preferredValue":{"type":"string"},"approvalRate":{"type":"number"},"sampleSize":{"type":"number"},"confidenceScore":{"type":"number"},"totalApproved":{"type":"number"},"totalRejected":{"type":"number"},"totalRevisions":{"type":"number"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"]},"sourceIds":{"type":["array","null"],"items":{"type":"string"}},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"strength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"lastCalculatedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","category","attribute","preferredValue","approvalRate","sampleSize","confidenceScore","totalApproved","totalRejected","totalRevisions","source","sourceIds","isVerified","verifiedBy","verifiedAt","isActive","strength","lastCalculatedAt","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["preferences","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Preference Learning"],"summary":"Create learned preference","description":"Manually create a learned preference (explicit source).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","description":"Client profile this preference belongs to"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"],"description":"Preference category"},"attribute":{"type":"string","description":"Specific attribute (e.g., color, headline_length)"},"preferredValue":{"type":"string","description":"The preferred value (e.g., blue, short)"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"],"default":"manual","description":"How this was learned"},"sourceIds":{"type":"array","items":{"type":"string"},"description":"IDs of source events"}},"required":["clientProfileId","category","attribute","preferredValue"]}}}},"responses":{"201":{"description":"Preference created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"]},"attribute":{"type":"string"},"preferredValue":{"type":"string"},"approvalRate":{"type":"number"},"sampleSize":{"type":"number"},"confidenceScore":{"type":"number"},"totalApproved":{"type":"number"},"totalRejected":{"type":"number"},"totalRevisions":{"type":"number"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"]},"sourceIds":{"type":["array","null"],"items":{"type":"string"}},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"strength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"lastCalculatedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","category","attribute","preferredValue","approvalRate","sampleSize","confidenceScore","totalApproved","totalRejected","totalRevisions","source","sourceIds","isVerified","verifiedBy","verifiedAt","isActive","strength","lastCalculatedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/learned/{preferenceId}":{"get":{"tags":["Preference Learning"],"summary":"Get learned preference","description":"Get details of a specific learned preference.","parameters":[{"schema":{"type":"string"},"required":true,"name":"preferenceId","in":"path"}],"responses":{"200":{"description":"Preference details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"]},"attribute":{"type":"string"},"preferredValue":{"type":"string"},"approvalRate":{"type":"number"},"sampleSize":{"type":"number"},"confidenceScore":{"type":"number"},"totalApproved":{"type":"number"},"totalRejected":{"type":"number"},"totalRevisions":{"type":"number"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"]},"sourceIds":{"type":["array","null"],"items":{"type":"string"}},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"strength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"lastCalculatedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","category","attribute","preferredValue","approvalRate","sampleSize","confidenceScore","totalApproved","totalRejected","totalRevisions","source","sourceIds","isVerified","verifiedBy","verifiedAt","isActive","strength","lastCalculatedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Preference Learning"],"summary":"Update learned preference","description":"Update a learned preference (verify, enable/disable).","parameters":[{"schema":{"type":"string"},"required":true,"name":"preferenceId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isVerified":{"type":"boolean","description":"Mark as verified"},"isActive":{"type":"boolean","description":"Enable/disable this preference"}}}}}},"responses":{"200":{"description":"Preference updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"]},"attribute":{"type":"string"},"preferredValue":{"type":"string"},"approvalRate":{"type":"number"},"sampleSize":{"type":"number"},"confidenceScore":{"type":"number"},"totalApproved":{"type":"number"},"totalRejected":{"type":"number"},"totalRevisions":{"type":"number"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"]},"sourceIds":{"type":["array","null"],"items":{"type":"string"}},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"strength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"lastCalculatedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","category","attribute","preferredValue","approvalRate","sampleSize","confidenceScore","totalApproved","totalRejected","totalRevisions","source","sourceIds","isVerified","verifiedBy","verifiedAt","isActive","strength","lastCalculatedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Preference Learning"],"summary":"Delete learned preference","description":"Soft delete a learned preference.","parameters":[{"schema":{"type":"string"},"required":true,"name":"preferenceId","in":"path"}],"responses":{"200":{"description":"Preference deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/patterns":{"get":{"tags":["Preference Learning"],"summary":"List preference patterns","description":"List analyzed preference patterns.","parameters":[{"schema":{"type":"string","description":"Filter by client profile"},"required":false,"description":"Filter by client profile","name":"clientProfileId","in":"query"},{"schema":{"type":"string","enum":["color_preference","length_preference","style_preference","timing_preference","format_preference","tone_preference"],"description":"Filter by pattern type"},"required":false,"description":"Filter by pattern type","name":"patternType","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Minimum confidence"},"required":false,"description":"Minimum confidence","name":"minConfidence","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Max results"},"required":false,"description":"Max results","name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"default":0,"description":"Pagination offset"},"required":false,"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"List of patterns","content":{"application/json":{"schema":{"type":"object","properties":{"patterns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"patternType":{"type":"string","enum":["color_preference","length_preference","style_preference","timing_preference","format_preference","tone_preference"]},"summary":{"type":"string"},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"supportingPreferences":{"type":["array","null"],"items":{"type":"string"}},"evidenceCount":{"type":"number"},"overallConfidence":{"type":"number"},"trendDirection":{"type":["string","null"],"enum":["stable","improving","declining",null]},"lastAnalyzedAt":{"type":["number","null"]},"analysisVersion":{"type":"number"},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","patternType","summary","recommendations","supportingPreferences","evidenceCount","overallConfidence","trendDirection","lastAnalyzedAt","analysisVersion","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["patterns","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/patterns/{patternId}":{"get":{"tags":["Preference Learning"],"summary":"Get preference pattern","description":"Get details of a specific preference pattern.","parameters":[{"schema":{"type":"string"},"required":true,"name":"patternId","in":"path"}],"responses":{"200":{"description":"Pattern details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"patternType":{"type":"string","enum":["color_preference","length_preference","style_preference","timing_preference","format_preference","tone_preference"]},"summary":{"type":"string"},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"supportingPreferences":{"type":["array","null"],"items":{"type":"string"}},"evidenceCount":{"type":"number"},"overallConfidence":{"type":"number"},"trendDirection":{"type":["string","null"],"enum":["stable","improving","declining",null]},"lastAnalyzedAt":{"type":["number","null"]},"analysisVersion":{"type":"number"},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","patternType","summary","recommendations","supportingPreferences","evidenceCount","overallConfidence","trendDirection","lastAnalyzedAt","analysisVersion","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/context/{clientProfileId}":{"get":{"tags":["Preference Learning"],"summary":"Get pre-generation context","description":"Get cached recommendations for content generation.","parameters":[{"schema":{"type":"string"},"required":true,"name":"clientProfileId","in":"path"},{"schema":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"],"description":"Filter by content type"},"required":false,"description":"Filter by content type","name":"contentType","in":"query"},{"schema":{"type":["boolean","null"],"default":false,"description":"Include stale contexts"},"required":false,"description":"Include stale contexts","name":"includeStale","in":"query"}],"responses":{"200":{"description":"Pre-generation context","content":{"application/json":{"schema":{"type":"object","properties":{"contexts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"]},"recommended":{"type":["object","null"],"additionalProperties":{}},"avoid":{"type":["object","null"],"additionalProperties":{}},"positivePrompts":{"type":["array","null"],"items":{"type":"string"}},"negativePrompts":{"type":["array","null"],"items":{"type":"string"}},"basedOnSampleSize":{"type":"number"},"averageConfidence":{"type":"number"},"generatedAt":{"type":"number"},"expiresAt":{"type":["number","null"]},"isStale":{"type":"boolean"},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","contentType","recommended","avoid","positivePrompts","negativePrompts","basedOnSampleSize","averageConfidence","generatedAt","expiresAt","isStale","createdAt","updatedAt"]}}},"required":["contexts"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/context/{clientProfileId}/refresh":{"post":{"tags":["Preference Learning"],"summary":"Refresh pre-generation context","description":"Force refresh of pre-generation context for a client.","parameters":[{"schema":{"type":"string"},"required":true,"name":"clientProfileId","in":"path"}],"responses":{"200":{"description":"Context refreshed","content":{"application/json":{"schema":{"type":"object","properties":{"contextsUpdated":{"type":"number"},"generatedAt":{"type":"number"}},"required":["contextsUpdated","generatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/analyze":{"post":{"tags":["Preference Learning"],"summary":"Analyze preferences","description":"Trigger preference analysis for a client to detect patterns.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","description":"Client profile to analyze"},"forceRefresh":{"type":"boolean","default":false,"description":"Force recalculation"}},"required":["clientProfileId"]}}}},"responses":{"200":{"description":"Analysis complete","content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string"},"patternsFound":{"type":"number"},"preferencesUpdated":{"type":"number"},"contextsGenerated":{"type":"number"},"eventsProcessed":{"type":"number"},"analysisTime":{"type":"number"}},"required":["clientProfileId","patternsFound","preferencesUpdated","contextsGenerated","eventsProcessed","analysisTime"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/recommendations":{"post":{"tags":["Preference Learning"],"summary":"Get recommendations","description":"Get content creation recommendations based on learned preferences.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string","description":"Client profile to get recommendations for"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"],"description":"Type of content being created"}},"required":["clientProfileId","contentType"]}}}},"responses":{"200":{"description":"Recommendations","content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string"},"contentType":{"type":"string","enum":["ad_creative","headline","image","video","copy","email","social_post"]},"recommendations":{"type":"object","properties":{"visual":{"type":"object","additionalProperties":{}},"copy":{"type":"object","additionalProperties":{}},"format":{"type":"object","additionalProperties":{}},"timing":{"type":"object","additionalProperties":{}},"style":{"type":"object","additionalProperties":{}}}},"avoid":{"type":"object","properties":{"visual":{"type":"array","items":{"type":"string"}},"copy":{"type":"array","items":{"type":"string"}},"format":{"type":"array","items":{"type":"string"}},"style":{"type":"array","items":{"type":"string"}}}},"positivePrompts":{"type":"array","items":{"type":"string"}},"negativePrompts":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"basedOnSampleSize":{"type":"number"},"lastUpdated":{"type":"number"}},"required":["clientProfileId","contentType","recommendations","avoid","positivePrompts","negativePrompts","confidence","basedOnSampleSize","lastUpdated"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/preferences/summary/{clientProfileId}":{"get":{"tags":["Preference Learning"],"summary":"Get client preference summary","description":"Get a comprehensive summary of learned preferences for a client.","parameters":[{"schema":{"type":"string"},"required":true,"name":"clientProfileId","in":"path"}],"responses":{"200":{"description":"Preference summary","content":{"application/json":{"schema":{"type":"object","properties":{"clientProfileId":{"type":"string"},"totalEvents":{"type":"number"},"totalPreferences":{"type":"number"},"totalPatterns":{"type":"number"},"approvalRate":{"type":"number"},"topPreferences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"category":{"type":"string","enum":["visual","copy","format","timing","style","tone","length"]},"attribute":{"type":"string"},"preferredValue":{"type":"string"},"approvalRate":{"type":"number"},"sampleSize":{"type":"number"},"confidenceScore":{"type":"number"},"totalApproved":{"type":"number"},"totalRejected":{"type":"number"},"totalRevisions":{"type":"number"},"source":{"type":"string","enum":["implicit","explicit","manual","conversation"]},"sourceIds":{"type":["array","null"],"items":{"type":"string"}},"isVerified":{"type":"boolean"},"verifiedBy":{"type":["string","null"]},"verifiedAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"strength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"lastCalculatedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","category","attribute","preferredValue","approvalRate","sampleSize","confidenceScore","totalApproved","totalRejected","totalRevisions","source","sourceIds","isVerified","verifiedBy","verifiedAt","isActive","strength","lastCalculatedAt","createdAt","updatedAt"]}},"patterns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"clientProfileId":{"type":"string"},"patternType":{"type":"string","enum":["color_preference","length_preference","style_preference","timing_preference","format_preference","tone_preference"]},"summary":{"type":"string"},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"supportingPreferences":{"type":["array","null"],"items":{"type":"string"}},"evidenceCount":{"type":"number"},"overallConfidence":{"type":"number"},"trendDirection":{"type":["string","null"],"enum":["stable","improving","declining",null]},"lastAnalyzedAt":{"type":["number","null"]},"analysisVersion":{"type":"number"},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","clientProfileId","patternType","summary","recommendations","supportingPreferences","evidenceCount","overallConfidence","trendDirection","lastAnalyzedAt","analysisVersion","createdAt","updatedAt"]}},"lastAnalyzedAt":{"type":["number","null"]}},"required":["clientProfileId","totalEvents","totalPreferences","totalPatterns","approvalRate","topPreferences","patterns","lastAnalyzedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/trends":{"get":{"tags":["Pulse Generator"],"summary":"List platform trends","description":"List platform-specific trends and performance insights.","parameters":[{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"required":false,"name":"trendType","in":"query"},{"schema":{"type":"string","enum":["positive","negative","neutral"]},"required":false,"name":"impact","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isActive","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of platform trends","content":{"application/json":{"schema":{"type":"object","properties":{"trends":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":["string","null"]},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":["number","null"]},"avgCtrChange":{"type":["number","null"]},"avgCpmChange":{"type":["number","null"]},"avgConversionChange":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidenceStrength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"industries":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adFormats":{"type":["array","null"],"items":{"type":"string"}},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"actionableInsights":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","region","trendType","title","description","impact","impactScore","avgCtrChange","avgCpmChange","avgConversionChange","sampleSize","sourceUrl","sourceType","evidenceStrength","industries","contentTypes","adFormats","validFrom","validUntil","isActive","aiSummary","actionableInsights","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["trends","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create platform trend","description":"Create a new platform trend insight.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":"string"},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string","minLength":1},"description":{"type":"string"},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":"number","minimum":-100,"maximum":100},"avgCtrChange":{"type":"number"},"avgCpmChange":{"type":"number"},"avgConversionChange":{"type":"number"},"sampleSize":{"type":"integer","exclusiveMinimum":0},"sourceUrl":{"type":"string","format":"uri"},"sourceType":{"type":"string"},"evidenceStrength":{"type":"string","enum":["weak","moderate","strong"]},"industries":{"type":"array","items":{"type":"string"}},"contentTypes":{"type":"array","items":{"type":"string"}},"adFormats":{"type":"array","items":{"type":"string"}},"validFrom":{"type":"number"},"validUntil":{"type":"number"},"aiSummary":{"type":"string"},"actionableInsights":{"type":"array","items":{"type":"string"}}},"required":["platform","trendType","title","impact"]}}}},"responses":{"201":{"description":"Trend created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":["string","null"]},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":["number","null"]},"avgCtrChange":{"type":["number","null"]},"avgCpmChange":{"type":["number","null"]},"avgConversionChange":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidenceStrength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"industries":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adFormats":{"type":["array","null"],"items":{"type":"string"}},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"actionableInsights":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","region","trendType","title","description","impact","impactScore","avgCtrChange","avgCpmChange","avgConversionChange","sampleSize","sourceUrl","sourceType","evidenceStrength","industries","contentTypes","adFormats","validFrom","validUntil","isActive","aiSummary","actionableInsights","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/trends/{trendId}":{"get":{"tags":["Pulse Generator"],"summary":"Get platform trend","description":"Get details of a specific platform trend.","parameters":[{"schema":{"type":"string"},"required":true,"name":"trendId","in":"path"}],"responses":{"200":{"description":"Platform trend details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":["string","null"]},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":["number","null"]},"avgCtrChange":{"type":["number","null"]},"avgCpmChange":{"type":["number","null"]},"avgConversionChange":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidenceStrength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"industries":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adFormats":{"type":["array","null"],"items":{"type":"string"}},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"actionableInsights":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","region","trendType","title","description","impact","impactScore","avgCtrChange","avgCpmChange","avgConversionChange","sampleSize","sourceUrl","sourceType","evidenceStrength","industries","contentTypes","adFormats","validFrom","validUntil","isActive","aiSummary","actionableInsights","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update platform trend","description":"Update an existing platform trend.","parameters":[{"schema":{"type":"string"},"required":true,"name":"trendId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":"string"},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string","minLength":1},"description":{"type":"string"},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":"number","minimum":-100,"maximum":100},"avgCtrChange":{"type":"number"},"avgCpmChange":{"type":"number"},"avgConversionChange":{"type":"number"},"sampleSize":{"type":"integer","exclusiveMinimum":0},"sourceUrl":{"type":"string","format":"uri"},"sourceType":{"type":"string"},"evidenceStrength":{"type":"string","enum":["weak","moderate","strong"]},"industries":{"type":"array","items":{"type":"string"}},"contentTypes":{"type":"array","items":{"type":"string"}},"adFormats":{"type":"array","items":{"type":"string"}},"validFrom":{"type":"number"},"validUntil":{"type":"number"},"aiSummary":{"type":"string"},"actionableInsights":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Trend updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"region":{"type":["string","null"]},"trendType":{"type":"string","enum":["format","algorithm","cpm","creative_style","placement","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"impactScore":{"type":["number","null"]},"avgCtrChange":{"type":["number","null"]},"avgCpmChange":{"type":["number","null"]},"avgConversionChange":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"sourceType":{"type":["string","null"]},"evidenceStrength":{"type":["string","null"],"enum":["weak","moderate","strong",null]},"industries":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adFormats":{"type":["array","null"],"items":{"type":"string"}},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"actionableInsights":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","region","trendType","title","description","impact","impactScore","avgCtrChange","avgCpmChange","avgConversionChange","sampleSize","sourceUrl","sourceType","evidenceStrength","industries","contentTypes","adFormats","validFrom","validUntil","isActive","aiSummary","actionableInsights","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Pulse Generator"],"summary":"Delete platform trend","description":"Soft delete a platform trend.","parameters":[{"schema":{"type":"string"},"required":true,"name":"trendId","in":"path"}],"responses":{"204":{"description":"Trend deleted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/verticals":{"get":{"tags":["Pulse Generator"],"summary":"List vertical insights","description":"List industry-specific advertising insights.","parameters":[{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"required":false,"name":"insightType","in":"query"},{"schema":{"type":"string","enum":["rising","falling","stable"]},"required":false,"name":"trendDirection","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isActive","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of vertical insights","content":{"application/json":{"schema":{"type":"object","properties":{"insights":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":["string","null"]},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string"},"description":{"type":["string","null"]},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"topPlatforms":{"type":["array","null"],"items":{"type":"string"}},"topFormats":{"type":["array","null"],"items":{"type":"string"}},"topMessaging":{"type":["array","null"],"items":{"type":"string"}},"avoidPatterns":{"type":["array","null"],"items":{"type":"string"}},"sourceReferences":{"type":["array","null"],"items":{"type":"string"}},"sampleSize":{"type":["number","null"]},"dataDateRange":{"type":["string","null"]},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","vertical","subVertical","insightType","title","description","trendDirection","confidenceScore","avgCtr","avgCpm","avgConversionRate","avgRoas","topPlatforms","topFormats","topMessaging","avoidPatterns","sourceReferences","sampleSize","dataDateRange","validFrom","validUntil","isActive","aiSummary","recommendations","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["insights","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create vertical insight","description":"Create a new industry vertical insight.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":"string"},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string","minLength":1},"description":{"type":"string"},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":"number","minimum":0,"maximum":100},"avgCtr":{"type":"number"},"avgCpm":{"type":"number"},"avgConversionRate":{"type":"number"},"avgRoas":{"type":"number"},"topPlatforms":{"type":"array","items":{"type":"string"}},"topFormats":{"type":"array","items":{"type":"string"}},"topMessaging":{"type":"array","items":{"type":"string"}},"avoidPatterns":{"type":"array","items":{"type":"string"}},"sourceReferences":{"type":"array","items":{"type":"string"}},"sampleSize":{"type":"integer","exclusiveMinimum":0},"dataDateRange":{"type":"string"},"validFrom":{"type":"number"},"validUntil":{"type":"number"},"aiSummary":{"type":"string"},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["vertical","insightType","title","trendDirection"]}}}},"responses":{"201":{"description":"Insight created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":["string","null"]},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string"},"description":{"type":["string","null"]},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"topPlatforms":{"type":["array","null"],"items":{"type":"string"}},"topFormats":{"type":["array","null"],"items":{"type":"string"}},"topMessaging":{"type":["array","null"],"items":{"type":"string"}},"avoidPatterns":{"type":["array","null"],"items":{"type":"string"}},"sourceReferences":{"type":["array","null"],"items":{"type":"string"}},"sampleSize":{"type":["number","null"]},"dataDateRange":{"type":["string","null"]},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","vertical","subVertical","insightType","title","description","trendDirection","confidenceScore","avgCtr","avgCpm","avgConversionRate","avgRoas","topPlatforms","topFormats","topMessaging","avoidPatterns","sourceReferences","sampleSize","dataDateRange","validFrom","validUntil","isActive","aiSummary","recommendations","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/verticals/{insightId}":{"get":{"tags":["Pulse Generator"],"summary":"Get vertical insight","description":"Get details of a specific vertical insight.","parameters":[{"schema":{"type":"string"},"required":true,"name":"insightId","in":"path"}],"responses":{"200":{"description":"Vertical insight details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":["string","null"]},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string"},"description":{"type":["string","null"]},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"topPlatforms":{"type":["array","null"],"items":{"type":"string"}},"topFormats":{"type":["array","null"],"items":{"type":"string"}},"topMessaging":{"type":["array","null"],"items":{"type":"string"}},"avoidPatterns":{"type":["array","null"],"items":{"type":"string"}},"sourceReferences":{"type":["array","null"],"items":{"type":"string"}},"sampleSize":{"type":["number","null"]},"dataDateRange":{"type":["string","null"]},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","vertical","subVertical","insightType","title","description","trendDirection","confidenceScore","avgCtr","avgCpm","avgConversionRate","avgRoas","topPlatforms","topFormats","topMessaging","avoidPatterns","sourceReferences","sampleSize","dataDateRange","validFrom","validUntil","isActive","aiSummary","recommendations","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update vertical insight","description":"Update an existing vertical insight.","parameters":[{"schema":{"type":"string"},"required":true,"name":"insightId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":"string"},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string","minLength":1},"description":{"type":"string"},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":"number","minimum":0,"maximum":100},"avgCtr":{"type":"number"},"avgCpm":{"type":"number"},"avgConversionRate":{"type":"number"},"avgRoas":{"type":"number"},"topPlatforms":{"type":"array","items":{"type":"string"}},"topFormats":{"type":"array","items":{"type":"string"}},"topMessaging":{"type":"array","items":{"type":"string"}},"avoidPatterns":{"type":"array","items":{"type":"string"}},"sourceReferences":{"type":"array","items":{"type":"string"}},"sampleSize":{"type":"integer","exclusiveMinimum":0},"dataDateRange":{"type":"string"},"validFrom":{"type":"number"},"validUntil":{"type":"number"},"aiSummary":{"type":"string"},"recommendations":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Insight updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"subVertical":{"type":["string","null"]},"insightType":{"type":"string","enum":["messaging","creative","targeting","compliance","pricing","seasonal"]},"title":{"type":"string"},"description":{"type":["string","null"]},"trendDirection":{"type":"string","enum":["rising","falling","stable"]},"confidenceScore":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"topPlatforms":{"type":["array","null"],"items":{"type":"string"}},"topFormats":{"type":["array","null"],"items":{"type":"string"}},"topMessaging":{"type":["array","null"],"items":{"type":"string"}},"avoidPatterns":{"type":["array","null"],"items":{"type":"string"}},"sourceReferences":{"type":["array","null"],"items":{"type":"string"}},"sampleSize":{"type":["number","null"]},"dataDateRange":{"type":["string","null"]},"validFrom":{"type":["number","null"]},"validUntil":{"type":["number","null"]},"isActive":{"type":"boolean"},"aiSummary":{"type":["string","null"]},"recommendations":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","vertical","subVertical","insightType","title","description","trendDirection","confidenceScore","avgCtr","avgCpm","avgConversionRate","avgRoas","topPlatforms","topFormats","topMessaging","avoidPatterns","sourceReferences","sampleSize","dataDateRange","validFrom","validUntil","isActive","aiSummary","recommendations","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Pulse Generator"],"summary":"Delete vertical insight","description":"Soft delete a vertical insight.","parameters":[{"schema":{"type":"string"},"required":true,"name":"insightId","in":"path"}],"responses":{"204":{"description":"Insight deleted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/tactics":{"get":{"tags":["Pulse Generator"],"summary":"List tactics","description":"List proven ad formulas, hooks, and frameworks.","parameters":[{"schema":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"subcategory","in":"query"},{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["easy","medium","hard"]},"required":false,"name":"difficulty","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isVerified","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isFeatured","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of tactics","content":{"application/json":{"schema":{"type":"object","properties":{"tactics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["tactics","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create tactic","description":"Create a new tactic/formula.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":"string"},"description":{"type":"string"},"template":{"type":"string"},"examples":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]}},"verticals":{"type":"array","items":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]}},"contentTypes":{"type":"array","items":{"type":"string"}},"adObjectives":{"type":"array","items":{"type":"string"}},"avgHookRate":{"type":"number","minimum":0,"maximum":100},"avgCtr":{"type":"number"},"avgEngagementRate":{"type":"number"},"avgConversionLift":{"type":"number"},"sampleSize":{"type":"integer","exclusiveMinimum":0},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":"string"},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}}},"required":["name","category"]}}}},"responses":{"201":{"description":"Tactic created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/tactics/{tacticId}":{"get":{"tags":["Pulse Generator"],"summary":"Get tactic","description":"Get details of a specific tactic.","parameters":[{"schema":{"type":"string"},"required":true,"name":"tacticId","in":"path"}],"responses":{"200":{"description":"Tactic details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update tactic","description":"Update an existing tactic.","parameters":[{"schema":{"type":"string"},"required":true,"name":"tacticId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":"string"},"description":{"type":"string"},"template":{"type":"string"},"examples":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]}},"verticals":{"type":"array","items":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]}},"contentTypes":{"type":"array","items":{"type":"string"}},"adObjectives":{"type":"array","items":{"type":"string"}},"avgHookRate":{"type":"number","minimum":0,"maximum":100},"avgCtr":{"type":"number"},"avgEngagementRate":{"type":"number"},"avgConversionLift":{"type":"number"},"sampleSize":{"type":"integer","exclusiveMinimum":0},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":"string"},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Tactic updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Pulse Generator"],"summary":"Delete tactic","description":"Soft delete a tactic.","parameters":[{"schema":{"type":"string"},"required":true,"name":"tacticId","in":"path"}],"responses":{"204":{"description":"Tactic deleted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/tactics/{tacticId}/verify":{"post":{"tags":["Pulse Generator"],"summary":"Verify tactic","description":"Mark a tactic as verified.","parameters":[{"schema":{"type":"string"},"required":true,"name":"tacticId","in":"path"}],"responses":{"200":{"description":"Tactic verified","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/tactics/{tacticId}/feature":{"post":{"tags":["Pulse Generator"],"summary":"Feature tactic","description":"Toggle featured status of a tactic.","parameters":[{"schema":{"type":"string"},"required":true,"name":"tacticId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"featured":{"type":"boolean"}},"required":["featured"]}}}},"responses":{"200":{"description":"Tactic updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]},"subcategory":{"type":["string","null"]},"description":{"type":["string","null"]},"template":{"type":["string","null"]},"examples":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"contentTypes":{"type":["array","null"],"items":{"type":"string"}},"adObjectives":{"type":["array","null"],"items":{"type":"string"}},"avgHookRate":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgEngagementRate":{"type":["number","null"]},"avgConversionLift":{"type":["number","null"]},"sampleSize":{"type":["number","null"]},"difficulty":{"type":"string","enum":["easy","medium","hard"]},"estimatedProductionTime":{"type":["string","null"]},"requiresVideo":{"type":"boolean"},"requiresUgc":{"type":"boolean"},"lastValidated":{"type":["number","null"]},"validationNotes":{"type":["string","null"]},"isVerified":{"type":"boolean"},"isFeatured":{"type":"boolean"},"isActive":{"type":"boolean"},"tags":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","name","category","subcategory","description","template","examples","platforms","verticals","contentTypes","adObjectives","avgHookRate","avgCtr","avgEngagementRate","avgConversionLift","sampleSize","difficulty","estimatedProductionTime","requiresVideo","requiresUgc","lastValidated","validationNotes","isVerified","isFeatured","isActive","tags","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/alerts":{"get":{"tags":["Pulse Generator"],"summary":"List alerts","description":"List smart alerts based on intelligence changes.","parameters":[{"schema":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"required":false,"name":"alertType","in":"query"},{"schema":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string","enum":["high","medium","low"]},"required":false,"name":"impact","in":"query"},{"schema":{"type":"string","enum":["immediate","soon","informational"]},"required":false,"name":"urgency","in":"query"},{"schema":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of alerts","content":{"application/json":{"schema":{"type":"object","properties":{"alerts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["alerts","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create alert","description":"Create a new alert.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string","minLength":1},"summary":{"type":"string","minLength":1},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":"string"},"sourceId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]},"relevantClients":{"type":"array","items":{"type":"string"}},"expiresAt":{"type":"number"}},"required":["alertType","category","title","summary","impact","urgency"]}}}},"responses":{"201":{"description":"Alert created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/alerts/{alertId}":{"get":{"tags":["Pulse Generator"],"summary":"Get alert","description":"Get details of a specific alert.","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"responses":{"200":{"description":"Alert details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update alert","description":"Update alert status or add actions taken.","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"summary":{"type":"string","minLength":1},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"actionsTaken":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Alert updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/alerts/{alertId}/acknowledge":{"post":{"tags":["Pulse Generator"],"summary":"Acknowledge alert","description":"Mark an alert as acknowledged.","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"responses":{"200":{"description":"Alert acknowledged","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/alerts/{alertId}/dismiss":{"post":{"tags":["Pulse Generator"],"summary":"Dismiss alert","description":"Dismiss an alert.","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}}}}}},"responses":{"200":{"description":"Alert dismissed","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]},"category":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]},"title":{"type":"string"},"summary":{"type":"string"},"details":{},"impact":{"type":"string","enum":["high","medium","low"]},"urgency":{"type":"string","enum":["immediate","soon","informational"]},"sourceType":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"platform":{"type":["string","null"]},"vertical":{"type":["string","null"]},"relevantClients":{"type":["array","null"],"items":{"type":"string"}},"priorityScore":{"type":"number"},"priorityFactors":{},"status":{"type":"string","enum":["active","acknowledged","dismissed","expired"]},"acknowledgedAt":{"type":["number","null"]},"acknowledgedBy":{"type":["string","null"]},"dismissedAt":{"type":["number","null"]},"dismissedBy":{"type":["string","null"]},"dismissReason":{"type":["string","null"]},"expiresAt":{"type":["number","null"]},"actionsTaken":{"type":["array","null"],"items":{"type":"string"}},"notificationSent":{"type":"boolean"},"notificationChannels":{"type":["array","null"],"items":{"type":"string"}},"sentAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","alertType","category","title","summary","impact","urgency","sourceType","sourceId","platform","vertical","relevantClients","priorityScore","status","acknowledgedAt","acknowledgedBy","dismissedAt","dismissedBy","dismissReason","expiresAt","actionsTaken","notificationSent","notificationChannels","sentAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/subscriptions":{"get":{"tags":["Pulse Generator"],"summary":"List alert subscriptions","description":"List alert subscriptions for the current user.","responses":{"200":{"description":"List of subscriptions","content":{"application/json":{"schema":{"type":"object","properties":{"subscriptions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"alertTypes":{"type":["array","null"],"items":{"type":"string"}},"categories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]}},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"number"},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":["string","null"]},"quietHoursEnd":{"type":["string","null"]},"quietHoursTimezone":{"type":["string","null"]},"isActive":{"type":"boolean"},"pausedUntil":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","userId","alertTypes","categories","platforms","verticals","channels","frequency","minPriority","minImpact","quietHoursEnabled","quietHoursStart","quietHoursEnd","quietHoursTimezone","isActive","pausedUntil","createdAt","updatedAt"]}}},"required":["subscriptions"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create alert subscription","description":"Create a new alert subscription.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alertTypes":{"type":"array","items":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]}},"categories":{"type":"array","items":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]}},"platforms":{"type":"array","items":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]}},"verticals":{"type":"array","items":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]},"minItems":1},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"integer","minimum":0,"maximum":100},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":"string"},"quietHoursEnd":{"type":"string"},"quietHoursTimezone":{"type":"string"}},"required":["channels"]}}}},"responses":{"201":{"description":"Subscription created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"alertTypes":{"type":["array","null"],"items":{"type":"string"}},"categories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]}},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"number"},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":["string","null"]},"quietHoursEnd":{"type":["string","null"]},"quietHoursTimezone":{"type":["string","null"]},"isActive":{"type":"boolean"},"pausedUntil":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","userId","alertTypes","categories","platforms","verticals","channels","frequency","minPriority","minImpact","quietHoursEnabled","quietHoursStart","quietHoursEnd","quietHoursTimezone","isActive","pausedUntil","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/subscriptions/{subscriptionId}":{"get":{"tags":["Pulse Generator"],"summary":"Get alert subscription","description":"Get details of a specific subscription.","parameters":[{"schema":{"type":"string"},"required":true,"name":"subscriptionId","in":"path"}],"responses":{"200":{"description":"Subscription details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"alertTypes":{"type":["array","null"],"items":{"type":"string"}},"categories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]}},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"number"},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":["string","null"]},"quietHoursEnd":{"type":["string","null"]},"quietHoursTimezone":{"type":["string","null"]},"isActive":{"type":"boolean"},"pausedUntil":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","userId","alertTypes","categories","platforms","verticals","channels","frequency","minPriority","minImpact","quietHoursEnabled","quietHoursStart","quietHoursEnd","quietHoursTimezone","isActive","pausedUntil","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update alert subscription","description":"Update an existing subscription.","parameters":[{"schema":{"type":"string"},"required":true,"name":"subscriptionId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alertTypes":{"type":"array","items":{"type":"string","enum":["platform_change","competitor_price","trend_emerging","trend_declining","algorithm_shift","compliance_update"]}},"categories":{"type":"array","items":{"type":"string","enum":["platform","vertical","competitor","compliance","performance"]}},"platforms":{"type":"array","items":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]}},"verticals":{"type":"array","items":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]}},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"integer","minimum":0,"maximum":100},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":"string"},"quietHoursEnd":{"type":"string"},"quietHoursTimezone":{"type":"string"},"isActive":{"type":"boolean"},"pausedUntil":{"type":"number"}}}}}},"responses":{"200":{"description":"Subscription updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"alertTypes":{"type":["array","null"],"items":{"type":"string"}},"categories":{"type":["array","null"],"items":{"type":"string"}},"platforms":{"type":["array","null"],"items":{"type":"string"}},"verticals":{"type":["array","null"],"items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["email","in_app","slack"]}},"frequency":{"type":"string","enum":["immediate","daily_digest","weekly_digest"]},"minPriority":{"type":"number"},"minImpact":{"type":"string","enum":["high","medium","low"]},"quietHoursEnabled":{"type":"boolean"},"quietHoursStart":{"type":["string","null"]},"quietHoursEnd":{"type":["string","null"]},"quietHoursTimezone":{"type":["string","null"]},"isActive":{"type":"boolean"},"pausedUntil":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","userId","alertTypes","categories","platforms","verticals","channels","frequency","minPriority","minImpact","quietHoursEnabled","quietHoursStart","quietHoursEnd","quietHoursTimezone","isActive","pausedUntil","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Pulse Generator"],"summary":"Delete alert subscription","description":"Delete a subscription.","parameters":[{"schema":{"type":"string"},"required":true,"name":"subscriptionId","in":"path"}],"responses":{"204":{"description":"Subscription deleted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/updates":{"get":{"tags":["Pulse Generator"],"summary":"List platform updates","description":"List platform algorithm and policy changes.","parameters":[{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"required":false,"name":"updateType","in":"query"},{"schema":{"type":"string","enum":["major","moderate","minor"]},"required":false,"name":"impactLevel","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isConfirmed","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of platform updates","content":{"application/json":{"schema":{"type":"object","properties":{"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"updateType":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"changeDate":{"type":"number"},"announcementDate":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":["array","null"],"items":{"type":"string"}},"recommendedActions":{"type":["array","null"],"items":{"type":"string"}},"isConfirmed":{"type":"boolean"},"confirmedBy":{"type":["string","null"]},"confirmedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","updateType","title","description","changeDate","announcementDate","sourceUrl","impactLevel","affectedAreas","recommendedActions","isConfirmed","confirmedBy","confirmedAt","createdAt","updatedAt"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["updates","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Pulse Generator"],"summary":"Create platform update","description":"Record a new platform update/change.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"updateType":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"title":{"type":"string","minLength":1},"description":{"type":"string"},"changeDate":{"type":"number"},"announcementDate":{"type":"number"},"sourceUrl":{"type":"string","format":"uri"},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":"array","items":{"type":"string"}},"recommendedActions":{"type":"array","items":{"type":"string"}}},"required":["platform","updateType","title","changeDate","impactLevel"]}}}},"responses":{"201":{"description":"Update created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"updateType":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"changeDate":{"type":"number"},"announcementDate":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":["array","null"],"items":{"type":"string"}},"recommendedActions":{"type":["array","null"],"items":{"type":"string"}},"isConfirmed":{"type":"boolean"},"confirmedBy":{"type":["string","null"]},"confirmedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","updateType","title","description","changeDate","announcementDate","sourceUrl","impactLevel","affectedAreas","recommendedActions","isConfirmed","confirmedBy","confirmedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/updates/{updateId}":{"get":{"tags":["Pulse Generator"],"summary":"Get platform update","description":"Get details of a specific platform update.","parameters":[{"schema":{"type":"string"},"required":true,"name":"updateId","in":"path"}],"responses":{"200":{"description":"Platform update details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"updateType":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"changeDate":{"type":"number"},"announcementDate":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":["array","null"],"items":{"type":"string"}},"recommendedActions":{"type":["array","null"],"items":{"type":"string"}},"isConfirmed":{"type":"boolean"},"confirmedBy":{"type":["string","null"]},"confirmedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","updateType","title","description","changeDate","announcementDate","sourceUrl","impactLevel","affectedAreas","recommendedActions","isConfirmed","confirmedBy","confirmedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Pulse Generator"],"summary":"Update platform update","description":"Update or confirm a platform update.","parameters":[{"schema":{"type":"string"},"required":true,"name":"updateId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"description":{"type":"string"},"changeDate":{"type":"number"},"announcementDate":{"type":"number"},"sourceUrl":{"type":"string","format":"uri"},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":"array","items":{"type":"string"}},"recommendedActions":{"type":"array","items":{"type":"string"}},"isConfirmed":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Update updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"updateType":{"type":"string","enum":["algorithm","policy","feature","pricing","targeting"]},"title":{"type":"string"},"description":{"type":["string","null"]},"changeDate":{"type":"number"},"announcementDate":{"type":["number","null"]},"sourceUrl":{"type":["string","null"]},"impactLevel":{"type":"string","enum":["major","moderate","minor"]},"affectedAreas":{"type":["array","null"],"items":{"type":"string"}},"recommendedActions":{"type":["array","null"],"items":{"type":"string"}},"isConfirmed":{"type":"boolean"},"confirmedBy":{"type":["string","null"]},"confirmedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","platform","updateType","title","description","changeDate","announcementDate","sourceUrl","impactLevel","affectedAreas","recommendedActions","isConfirmed","confirmedBy","confirmedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Pulse Generator"],"summary":"Delete platform update","description":"Soft delete a platform update.","parameters":[{"schema":{"type":"string"},"required":true,"name":"updateId","in":"path"}],"responses":{"204":{"description":"Update deleted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/pulse/recommendations":{"post":{"tags":["Pulse Generator"],"summary":"Get recommendations","description":"Get AI recommendations based on platform trends, vertical insights, and tactics.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"platforms":{"type":"array","items":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]}},"verticals":{"type":"array","items":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment"]}},"tacticCategories":{"type":"array","items":{"type":"string","enum":["hook","structure","copy_framework","visual_pattern","cta"]}},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":50}}}}}},"responses":{"200":{"description":"Recommendations","content":{"application/json":{"schema":{"type":"object","properties":{"recommendations":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["trend","insight","tactic"]},"title":{"type":"string"},"description":{"type":"string"},"confidence":{"type":"number"},"source":{},"actions":{"type":"array","items":{"type":"string"}}},"required":["type","title","description","confidence","actions"]}},"generatedAt":{"type":"number"},"basedOn":{"type":"object","properties":{"trendsCount":{"type":"number"},"insightsCount":{"type":"number"},"tacticsCount":{"type":"number"}},"required":["trendsCount","insightsCount","tacticsCount"]}},"required":["recommendations","generatedAt","basedOn"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/campaigns":{"get":{"tags":["Performance Intelligence"],"summary":"List campaign performance data","description":"List campaign performance data for the organization. Used for collecting and viewing performance metrics.","parameters":[{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"required":false,"name":"creativeType","in":"query"},{"schema":{"type":"string","enum":["active","paused","completed","archived"]},"required":false,"name":"status","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"startDate","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"endDate","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"minSpend","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"maxSpend","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"minRoas","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","enum":["createdAt","spend","roas","ctr","cpa","impressions"],"default":"createdAt"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"List of campaign performance records","content":{"application/json":{"schema":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["campaigns","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"post":{"tags":["Performance Intelligence"],"summary":"Create campaign performance record","description":"Create a new campaign performance record. Used for data collection from campaigns.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1},"campaignName":{"type":"string"},"externalCampaignId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":"string"},"creativeType":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"hookStyle":{"type":"string","enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy"]},"videoDuration":{"type":"integer","minimum":0},"hasUgc":{"type":"boolean","default":false},"hasTestimonial":{"type":"boolean","default":false},"impressions":{"type":"integer","minimum":0,"default":0},"clicks":{"type":"integer","minimum":0,"default":0},"spend":{"type":"number","minimum":0,"default":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"conversions":{"type":"integer","minimum":0,"default":0},"revenue":{"type":"number","minimum":0,"default":0},"engagements":{"type":"integer","minimum":0,"default":0},"videoViews":{"type":"integer","minimum":0},"videoCompletions":{"type":"integer","minimum":0},"campaignStartDate":{"type":"integer"},"campaignEndDate":{"type":"integer"},"status":{"type":"string","enum":["active","paused","completed","archived"],"default":"active"}},"required":["campaignId","platform","vertical"]}}}},"responses":{"201":{"description":"Campaign performance record created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/campaigns/{campaignId}":{"get":{"tags":["Performance Intelligence"],"summary":"Get campaign performance record","description":"Get a specific campaign performance record by ID.","parameters":[{"schema":{"type":"string"},"required":true,"name":"campaignId","in":"path"}],"responses":{"200":{"description":"Campaign performance record details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Performance Intelligence"],"summary":"Update campaign performance record","description":"Update an existing campaign performance record with new metrics.","parameters":[{"schema":{"type":"string"},"required":true,"name":"campaignId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"campaignName":{"type":"string"},"externalCampaignId":{"type":"string"},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":"string"},"creativeType":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"hookStyle":{"type":"string","enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy"]},"videoDuration":{"type":"integer","minimum":0},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer","minimum":0},"clicks":{"type":"integer","minimum":0},"spend":{"type":"number","minimum":0},"conversions":{"type":"integer","minimum":0},"revenue":{"type":"number","minimum":0},"engagements":{"type":"integer","minimum":0},"videoViews":{"type":"integer","minimum":0},"videoCompletions":{"type":"integer","minimum":0},"campaignStartDate":{"type":"integer"},"campaignEndDate":{"type":"integer"},"status":{"type":"string","enum":["active","paused","completed","archived"]}}}}}},"responses":{"200":{"description":"Campaign performance record updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"delete":{"tags":["Performance Intelligence"],"summary":"Delete campaign performance record","description":"Delete a campaign performance record.","parameters":[{"schema":{"type":"string"},"required":true,"name":"campaignId","in":"path"}],"responses":{"200":{"description":"Campaign performance record deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/campaigns/sync":{"post":{"tags":["Performance Intelligence"],"summary":"Bulk sync campaign performance","description":"Bulk create or update campaign performance records. Used for batch data imports.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1},"campaignName":{"type":"string"},"externalCampaignId":{"type":"string"},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":"string"},"creativeType":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"hookStyle":{"type":"string","enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy"]},"videoDuration":{"type":"integer","minimum":0},"hasUgc":{"type":"boolean","default":false},"hasTestimonial":{"type":"boolean","default":false},"impressions":{"type":"integer","minimum":0,"default":0},"clicks":{"type":"integer","minimum":0,"default":0},"spend":{"type":"number","minimum":0,"default":0},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"conversions":{"type":"integer","minimum":0,"default":0},"revenue":{"type":"number","minimum":0,"default":0},"engagements":{"type":"integer","minimum":0,"default":0},"videoViews":{"type":"integer","minimum":0},"videoCompletions":{"type":"integer","minimum":0},"campaignStartDate":{"type":"integer"},"campaignEndDate":{"type":"integer"},"status":{"type":"string","enum":["active","paused","completed","archived"],"default":"active"}},"required":["campaignId","platform","vertical"]},"minItems":1,"maxItems":100}},"required":["campaigns"]}}}},"responses":{"200":{"description":"Sync results","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"integer"},"updated":{"type":"integer"},"failed":{"type":"integer"},"errors":{"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string"},"error":{"type":"string"}},"required":["campaignId","error"]}}},"required":["created","updated","failed"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/benchmarks":{"get":{"tags":["Performance Intelligence"],"summary":"Get performance benchmarks","description":"Get aggregated, anonymized performance benchmarks. K-anonymity enforced (min 10 campaigns).","parameters":[{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"required":false,"name":"creativeType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"timePeriod","in":"query"},{"schema":{"type":"string","enum":["month","quarter","year","all_time"]},"required":false,"name":"periodType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Performance benchmarks","content":{"application/json":{"schema":{"type":"object","properties":{"benchmarks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":["string","null"],"enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat",null]},"vertical":{"type":["string","null"],"enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other",null]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"timePeriod":{"type":"string"},"periodType":{"type":"string","enum":["month","quarter","year","all_time"]},"sampleSize":{"type":"integer"},"campaignCount":{"type":"integer"},"organizationCount":{"type":"integer"},"avgCtr":{"type":["number","null"]},"medianCtr":{"type":["number","null"]},"p25Ctr":{"type":["number","null"]},"p75Ctr":{"type":["number","null"]},"p90Ctr":{"type":["number","null"]},"minCtr":{"type":["number","null"]},"maxCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"medianCpm":{"type":["number","null"]},"p25Cpm":{"type":["number","null"]},"p75Cpm":{"type":["number","null"]},"avgCpc":{"type":["number","null"]},"medianCpc":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"medianCpa":{"type":["number","null"]},"p25Cpa":{"type":["number","null"]},"p75Cpa":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"medianRoas":{"type":["number","null"]},"p25Roas":{"type":["number","null"]},"p75Roas":{"type":["number","null"]},"p90Roas":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"medianConversionRate":{"type":["number","null"]},"totalSpend":{"type":["number","null"]},"avgSpendPerCampaign":{"type":["number","null"]},"topCreativeTypes":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"count":{"type":"integer"},"percentage":{"type":"number"}},"required":["type","count","percentage"]}},"topHookStyles":{"type":["array","null"],"items":{"type":"object","properties":{"style":{"type":"string","enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy"]},"count":{"type":"integer"},"percentage":{"type":"number"}},"required":["style","count","percentage"]}},"avgVideoDuration":{"type":["number","null"]},"calculatedAt":{"type":"number"},"calculationVersion":{"type":["string","null"]},"isStale":{"type":"boolean"}},"required":["id","platform","vertical","subVertical","creativeType","timePeriod","periodType","sampleSize","campaignCount","organizationCount","avgCtr","medianCtr","p25Ctr","p75Ctr","p90Ctr","minCtr","maxCtr","avgCpm","medianCpm","p25Cpm","p75Cpm","avgCpc","medianCpc","avgCpa","medianCpa","p25Cpa","p75Cpa","avgRoas","medianRoas","p25Roas","p75Roas","p90Roas","avgConversionRate","medianConversionRate","totalSpend","avgSpendPerCampaign","topCreativeTypes","topHookStyles","avgVideoDuration","calculatedAt","calculationVersion","isStale"]}},"total":{"type":"integer"},"kThreshold":{"type":"integer"}},"required":["benchmarks","total","kThreshold"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/benchmarks/compare":{"get":{"tags":["Performance Intelligence"],"summary":"Compare performance to benchmark","description":"Compare your organization's performance to the benchmark for your vertical/platform.","parameters":[{"schema":{"type":"string"},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string"},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string"},"required":false,"name":"timePeriod","in":"query"}],"responses":{"200":{"description":"Benchmark comparison","content":{"application/json":{"schema":{"type":"object","properties":{"benchmark":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":["string","null"],"enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat",null]},"vertical":{"type":["string","null"],"enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other",null]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"timePeriod":{"type":"string"},"periodType":{"type":"string","enum":["month","quarter","year","all_time"]},"sampleSize":{"type":"integer"},"campaignCount":{"type":"integer"},"organizationCount":{"type":"integer"},"avgCtr":{"type":["number","null"]},"medianCtr":{"type":["number","null"]},"p25Ctr":{"type":["number","null"]},"p75Ctr":{"type":["number","null"]},"p90Ctr":{"type":["number","null"]},"minCtr":{"type":["number","null"]},"maxCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"medianCpm":{"type":["number","null"]},"p25Cpm":{"type":["number","null"]},"p75Cpm":{"type":["number","null"]},"avgCpc":{"type":["number","null"]},"medianCpc":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"medianCpa":{"type":["number","null"]},"p25Cpa":{"type":["number","null"]},"p75Cpa":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"medianRoas":{"type":["number","null"]},"p25Roas":{"type":["number","null"]},"p75Roas":{"type":["number","null"]},"p90Roas":{"type":["number","null"]},"avgConversionRate":{"type":["number","null"]},"medianConversionRate":{"type":["number","null"]},"totalSpend":{"type":["number","null"]},"avgSpendPerCampaign":{"type":["number","null"]},"topCreativeTypes":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"count":{"type":"integer"},"percentage":{"type":"number"}},"required":["type","count","percentage"]}},"topHookStyles":{"type":["array","null"],"items":{"type":"object","properties":{"style":{"type":"string","enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy"]},"count":{"type":"integer"},"percentage":{"type":"number"}},"required":["style","count","percentage"]}},"avgVideoDuration":{"type":["number","null"]},"calculatedAt":{"type":"number"},"calculationVersion":{"type":["string","null"]},"isStale":{"type":"boolean"}},"required":["id","platform","vertical","subVertical","creativeType","timePeriod","periodType","sampleSize","campaignCount","organizationCount","avgCtr","medianCtr","p25Ctr","p75Ctr","p90Ctr","minCtr","maxCtr","avgCpm","medianCpm","p25Cpm","p75Cpm","avgCpc","medianCpc","avgCpa","medianCpa","p25Cpa","p75Cpa","avgRoas","medianRoas","p25Roas","p75Roas","p90Roas","avgConversionRate","medianConversionRate","totalSpend","avgSpendPerCampaign","topCreativeTypes","topHookStyles","avgVideoDuration","calculatedAt","calculationVersion","isStale"]},"yourPerformance":{"type":["object","null"],"properties":{"avgCtr":{"type":["number","null"]},"avgCpm":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"avgRoas":{"type":["number","null"]},"campaignCount":{"type":"integer"},"totalSpend":{"type":"number"}},"required":["avgCtr","avgCpm","avgCpa","avgRoas","campaignCount","totalSpend"]},"comparison":{"type":["object","null"],"properties":{"ctrVsBenchmark":{"type":["number","null"]},"cpmVsBenchmark":{"type":["number","null"]},"cpaVsBenchmark":{"type":["number","null"]},"roasVsBenchmark":{"type":["number","null"]},"percentile":{"type":["integer","null"]}},"required":["ctrVsBenchmark","cpmVsBenchmark","cpaVsBenchmark","roasVsBenchmark","percentile"]}},"required":["benchmark","yourPerformance","comparison"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/settings":{"get":{"tags":["Performance Intelligence"],"summary":"Get data settings","description":"Get the data collection settings for the current organization.","responses":{"200":{"description":"Data settings","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"excludedAt":{"type":["number","null"]},"excludedBy":{"type":["string","null"]},"exclusionReason":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]},"createdBy":{"type":["string","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","includeInBenchmarks","includeMetrics","includeCreativeTypes","includePlatformData","includeVerticalData","canViewBenchmarks","canExportData","excludedAt","excludedBy","exclusionReason","createdAt","updatedAt","createdBy","updatedBy"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}},"patch":{"tags":["Performance Intelligence"],"summary":"Update data settings","description":"Update data collection settings. Admin only - used for excluding organizations from benchmarks.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"exclusionReason":{"type":"string"}}}}}},"responses":{"200":{"description":"Data settings updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"excludedAt":{"type":["number","null"]},"excludedBy":{"type":["string","null"]},"exclusionReason":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]},"createdBy":{"type":["string","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","includeInBenchmarks","includeMetrics","includeCreativeTypes","includePlatformData","includeVerticalData","canViewBenchmarks","canExportData","excludedAt","excludedBy","exclusionReason","createdAt","updatedAt","createdBy","updatedBy"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/overview":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"Get platform overview","description":"Get platform-wide performance overview. Platform operator only.","parameters":[{"schema":{"type":["integer","null"]},"required":false,"name":"startDate","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"endDate","in":"query"}],"responses":{"200":{"description":"Platform overview","content":{"application/json":{"schema":{"type":"object","properties":{"totalCampaigns":{"type":"integer"},"activeCampaigns":{"type":"integer"},"activeOrganizations":{"type":"integer"},"totalSpend":{"type":"number"},"avgRoas":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"periodSpend":{"type":"number"},"periodSpendChange":{"type":["number","null"]},"periodCampaigns":{"type":"integer"},"periodCampaignsChange":{"type":["number","null"]},"topPlatforms":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"campaignCount":{"type":"integer"},"totalSpend":{"type":"number"},"avgRoas":{"type":["number","null"]}},"required":["platform","campaignCount","totalSpend","avgRoas"]}},"topVerticals":{"type":"array","items":{"type":"object","properties":{"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"campaignCount":{"type":"integer"},"totalSpend":{"type":"number"},"avgRoas":{"type":["number","null"]}},"required":["vertical","campaignCount","totalSpend","avgRoas"]}}},"required":["totalCampaigns","activeCampaigns","activeOrganizations","totalSpend","avgRoas","avgCtr","avgCpa","periodSpend","periodSpendChange","periodCampaigns","periodCampaignsChange","topPlatforms","topVerticals"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/accounts":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"List all accounts with performance data","description":"List all accounts with aggregated performance data. Platform operator only.","parameters":[{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"minSpend","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"maxSpend","in":"query"},{"schema":{"type":["boolean","null"]},"required":false,"name":"isActive","in":"query"},{"schema":{"type":["boolean","null"],"default":false},"required":false,"name":"includeExcluded","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","enum":["totalSpend","campaignCount","avgRoas","lastCampaignAt"],"default":"totalSpend"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"sortOrder","in":"query"}],"responses":{"200":{"description":"Account list","content":{"application/json":{"schema":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"organizationName":{"type":["string","null"]},"campaignCount":{"type":"integer"},"totalSpend":{"type":"number"},"avgRoas":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"topPlatform":{"type":["string","null"],"enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat",null]},"topVertical":{"type":["string","null"],"enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other",null]},"lastCampaignAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"includeInBenchmarks":{"type":"boolean"}},"required":["organizationId","organizationName","campaignCount","totalSpend","avgRoas","avgCtr","avgCpa","topPlatform","topVertical","lastCampaignAt","isActive","includeInBenchmarks"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["accounts","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/accounts/{accountId}":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"Get account detail","description":"Get detailed performance data for a specific account. Platform operator only.","parameters":[{"schema":{"type":"string"},"required":true,"name":"accountId","in":"path"}],"responses":{"200":{"description":"Account detail","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"organizationId":{"type":"string"},"organizationName":{"type":["string","null"]},"campaignCount":{"type":"integer"},"totalSpend":{"type":"number"},"avgRoas":{"type":["number","null"]},"avgCtr":{"type":["number","null"]},"avgCpa":{"type":["number","null"]},"topPlatform":{"type":["string","null"],"enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat",null]},"topVertical":{"type":["string","null"],"enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other",null]},"lastCampaignAt":{"type":["number","null"]},"isActive":{"type":"boolean"},"includeInBenchmarks":{"type":"boolean"}},"required":["organizationId","organizationName","campaignCount","totalSpend","avgRoas","avgCtr","avgCpa","topPlatform","topVertical","lastCampaignAt","isActive","includeInBenchmarks"]},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}},"settings":{"type":["object","null"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"excludedAt":{"type":["number","null"]},"excludedBy":{"type":["string","null"]},"exclusionReason":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]},"createdBy":{"type":["string","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","includeInBenchmarks","includeMetrics","includeCreativeTypes","includePlatformData","includeVerticalData","canViewBenchmarks","canExportData","excludedAt","excludedBy","exclusionReason","createdAt","updatedAt","createdBy","updatedBy"]}},"required":["account","campaigns","settings"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/accounts/{accountId}/settings":{"patch":{"tags":["Performance Intelligence - Admin"],"summary":"Update account data settings","description":"Update data settings for a specific account. Platform operator only.","parameters":[{"schema":{"type":"string"},"required":true,"name":"accountId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"exclusionReason":{"type":"string"}}}}}},"responses":{"200":{"description":"Settings updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"includeInBenchmarks":{"type":"boolean"},"includeMetrics":{"type":"boolean"},"includeCreativeTypes":{"type":"boolean"},"includePlatformData":{"type":"boolean"},"includeVerticalData":{"type":"boolean"},"canViewBenchmarks":{"type":"boolean"},"canExportData":{"type":"boolean"},"excludedAt":{"type":["number","null"]},"excludedBy":{"type":["string","null"]},"exclusionReason":{"type":["string","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]},"createdBy":{"type":["string","null"]},"updatedBy":{"type":["string","null"]}},"required":["id","organizationId","includeInBenchmarks","includeMetrics","includeCreativeTypes","includePlatformData","includeVerticalData","canViewBenchmarks","canExportData","excludedAt","excludedBy","exclusionReason","createdAt","updatedAt","createdBy","updatedBy"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/campaigns":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"List all campaigns across accounts","description":"List all campaigns across all accounts with full details. Platform operator only.","parameters":[{"schema":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"required":false,"name":"vertical","in":"query"},{"schema":{"type":"string","enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels"]},"required":false,"name":"creativeType","in":"query"},{"schema":{"type":"string","enum":["active","paused","completed","archived"]},"required":false,"name":"status","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"startDate","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"endDate","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"minSpend","in":"query"},{"schema":{"type":["number","null"],"minimum":0},"required":false,"name":"maxSpend","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"minRoas","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string","enum":["createdAt","spend","roas","ctr","cpa","impressions"],"default":"createdAt"},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"sortOrder","in":"query"},{"schema":{"type":"string"},"required":false,"name":"accountId","in":"query"}],"responses":{"200":{"description":"Campaign list","content":{"application/json":{"schema":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["campaigns","total","limit","offset"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/campaigns/{campaignId}":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"Get campaign detail","description":"Get detailed campaign analysis. Platform operator only.","parameters":[{"schema":{"type":"string"},"required":true,"name":"campaignId","in":"path"}],"responses":{"200":{"description":"Campaign detail with analysis","content":{"application/json":{"schema":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"campaignId":{"type":"string"},"campaignName":{"type":["string","null"]},"externalCampaignId":{"type":["string","null"]},"platform":{"type":"string","enum":["meta","tiktok","google","youtube","amazon","linkedin","twitter","pinterest","snapchat"]},"vertical":{"type":"string","enum":["supplements","ecommerce","finance","saas","cpg","local","beauty","health","fitness","education","real_estate","automotive","travel","food_beverage","fashion","technology","gaming","entertainment","home_garden","pets","sports","other"]},"subVertical":{"type":["string","null"]},"creativeType":{"type":["string","null"],"enum":["ugc","studio","static","carousel","video","image","slideshow","stories","reels",null]},"hookStyle":{"type":["string","null"],"enum":["problem_first","curiosity","social_proof","demonstration","testimonial","before_after","pov","question","statistic","controversy",null]},"videoDuration":{"type":["integer","null"]},"hasUgc":{"type":"boolean"},"hasTestimonial":{"type":"boolean"},"impressions":{"type":"integer"},"clicks":{"type":"integer"},"ctr":{"type":["number","null"]},"spend":{"type":"number"},"currency":{"type":"string"},"cpm":{"type":["number","null"]},"cpc":{"type":["number","null"]},"conversions":{"type":"integer"},"conversionRate":{"type":["number","null"]},"cpa":{"type":["number","null"]},"revenue":{"type":"number"},"roas":{"type":["number","null"]},"engagements":{"type":"integer"},"videoViews":{"type":["integer","null"]},"videoCompletions":{"type":["integer","null"]},"videoCompletionRate":{"type":["number","null"]},"campaignStartDate":{"type":["number","null"]},"campaignEndDate":{"type":["number","null"]},"status":{"type":"string","enum":["active","paused","completed","archived"]},"dataCollectedAt":{"type":"number"},"lastSyncedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":["number","null"]}},"required":["id","organizationId","campaignId","campaignName","externalCampaignId","platform","vertical","subVertical","creativeType","hookStyle","videoDuration","hasUgc","hasTestimonial","impressions","clicks","ctr","spend","currency","cpm","cpc","conversions","conversionRate","cpa","revenue","roas","engagements","videoViews","videoCompletions","videoCompletionRate","campaignStartDate","campaignEndDate","status","dataCollectedAt","lastSyncedAt","createdAt","updatedAt"]},"analysis":{"type":["object","null"],"properties":{"performanceScore":{"type":["number","null"]},"strengthIndicators":{"type":"array","items":{"type":"string"}},"improvementAreas":{"type":"array","items":{"type":"string"}},"similarCampaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"campaignName":{"type":["string","null"]},"similarity":{"type":"number"},"roas":{"type":["number","null"]}},"required":["id","campaignName","similarity","roas"]}}},"required":["performanceScore","strengthIndicators","improvementAreas","similarCampaigns"]}},"required":["campaign","analysis"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/admin/access-logs":{"get":{"tags":["Performance Intelligence - Admin"],"summary":"Get access logs","description":"Get audit logs of platform operator access. Platform operator only.","parameters":[{"schema":{"type":"string"},"required":false,"name":"userId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"accessType","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"startDate","in":"query"},{"schema":{"type":["integer","null"]},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Access logs","content":{"application/json":{"schema":{"type":"object","properties":{"logs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userEmail":{"type":["string","null"]},"accessType":{"type":"string","enum":["overview","account_list","account_detail","campaign_list","campaign_detail","benchmark_view","export"]},"resourceType":{"type":["string","null"]},"resourceId":{"type":["string","null"]},"queryParams":{"type":["object","null"],"additionalProperties":{}},"filters":{"type":["object","null"],"additionalProperties":{}},"resultCount":{"type":["integer","null"]},"responseTimeMs":{"type":["integer","null"]},"ipAddress":{"type":["string","null"]},"userAgent":{"type":["string","null"]},"accessedAt":{"type":"number"}},"required":["id","userId","userEmail","accessType","resourceType","resourceId","queryParams","filters","resultCount","responseTimeMs","ipAddress","userAgent","accessedAt"]}},"total":{"type":"integer"}},"required":["logs","total"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"403":{"description":"Forbidden - Platform operator access required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"details":{}},"required":["error"]}}}}}}},"/performance/aggregation/run":{"post":{"tags":["Performance Intelligence","Aggregation"],"summary":"Run aggregation job","description":"Run full benchmark aggregation across all dimension combinations. Platform operator only.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunAggregationJobInput"}}}},"responses":{"200":{"description":"Aggregation job completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregationJobResult"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Platform operator access required"}}}},"/performance/aggregation/calculate":{"post":{"tags":["Performance Intelligence","Aggregation"],"summary":"Calculate single benchmark","description":"Calculate or refresh a single benchmark for specific dimensions. Platform operator only.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculateBenchmarkInput"}}}},"responses":{"200":{"description":"Benchmark calculated","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"result":{"$ref":"#/components/schemas/AggregationResult"}},"required":["success","result"]}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Platform operator access required"}}}},"/performance/aggregation/stats":{"get":{"tags":["Performance Intelligence","Aggregation"],"summary":"Get aggregation statistics","description":"Get current aggregation statistics including benchmark counts and status. Platform operator only.","responses":{"200":{"description":"Aggregation statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregationStats"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Platform operator access required"}}}},"/performance/aggregation/mark-stale":{"post":{"tags":["Performance Intelligence","Aggregation"],"summary":"Mark benchmarks as stale","description":"Mark benchmarks as stale for refresh. Can filter by platform/vertical/creative type. Platform operator only.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkStaleInput"}}}},"responses":{"200":{"description":"Benchmarks marked as stale","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkStaleResult"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Platform operator access required"}}}},"/performance/aggregation/refresh":{"post":{"tags":["Performance Intelligence","Aggregation"],"summary":"Refresh stale benchmarks","description":"Recalculate all benchmarks marked as stale. Platform operator only.","responses":{"200":{"description":"Stale benchmarks refreshed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregationJobResult"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Platform operator access required"}}}},"/performance/aggregation/scheduled/daily":{"post":{"tags":["Performance Intelligence","Aggregation","Scheduled"],"summary":"Daily scheduled aggregation","description":"Triggered by cron job to run daily aggregation. Aggregates current month and all_time periods.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"secret":{"type":"string","description":"Cron secret for authentication"}}}}}},"responses":{"200":{"description":"Daily aggregation completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregationJobResult"}}}},"401":{"description":"Unauthorized - Invalid cron secret"}}}},"/performance/aggregation/scheduled/weekly":{"post":{"tags":["Performance Intelligence","Aggregation","Scheduled"],"summary":"Weekly scheduled aggregation","description":"Triggered by cron job to run weekly aggregation. Aggregates all period types.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"secret":{"type":"string","description":"Cron secret for authentication"}}}}}},"responses":{"200":{"description":"Weekly aggregation completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AggregationJobResult"}}}},"401":{"description":"Unauthorized - Invalid cron secret"}}}},"/enrichment/contacts":{"get":{"operationId":"listEnrichedProfiles","summary":"List enriched profiles","description":"Get paginated list of enriched contact profiles with filtering","tags":["Enrichment - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":100},"required":false,"name":"minEnrichmentScore","in":"query"},{"schema":{"type":"string","enum":["low","medium","high","very_high","unknown"]},"required":false,"name":"creditBand","in":"query"},{"schema":{"type":"string","enum":["c_level","vp","director","manager","senior","staff","entry","intern"]},"required":false,"name":"seniority","in":"query"},{"schema":{"type":"string"},"required":false,"name":"companyDomain","in":"query"}],"responses":{"200":{"description":"Enriched profiles list","content":{"application/json":{"schema":{"type":"object","properties":{"profiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"fullName":{"type":["string","null"]},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"photoUrl":{"type":["string","null"]},"jobTitle":{"type":["string","null"]},"seniority":{"type":["string","null"],"enum":["c_level","vp","director","manager","senior","staff","entry","intern",null]},"department":{"type":["string","null"]},"companyName":{"type":["string","null"]},"companyDomain":{"type":["string","null"]},"companySize":{"type":["string","null"]},"companyIndustry":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"country":{"type":["string","null"]},"timezone":{"type":["string","null"]},"phoneDirect":{"type":["string","null"]},"phoneMobile":{"type":["string","null"]},"emailVerified":{"type":"boolean"},"enrichmentScore":{"type":["number","null"]},"dataFreshnessScore":{"type":["number","null"]},"identityConfidence":{"type":["number","null"]},"softCreditScore":{"type":["number","null"]},"softCreditBand":{"type":["string","null"],"enum":["low","medium","high","very_high","unknown",null]},"recommendedPaymentTerms":{"type":["string","null"],"enum":["prepay","net15","net30","net45","net60",null]},"recommendedCreditLimit":{"type":["number","null"]},"lastEnrichedAt":{"type":["string","null"]},"enrichmentVersion":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","fullName","firstName","lastName","photoUrl","jobTitle","seniority","department","companyName","companyDomain","companySize","companyIndustry","city","state","country","timezone","phoneDirect","phoneMobile","emailVerified","enrichmentScore","dataFreshnessScore","identityConfidence","softCreditScore","softCreditBand","recommendedPaymentTerms","recommendedCreditLimit","lastEnrichedAt","enrichmentVersion","createdAt","updatedAt"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["profiles","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/profile":{"get":{"operationId":"getEnrichedProfile","summary":"Get enriched profile","description":"Get complete enriched profile with social profiles and credit scores","tags":["Enrichment - Profiles"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Enriched profile with full data","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"fullName":{"type":["string","null"]},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"photoUrl":{"type":["string","null"]},"jobTitle":{"type":["string","null"]},"seniority":{"type":["string","null"],"enum":["c_level","vp","director","manager","senior","staff","entry","intern",null]},"department":{"type":["string","null"]},"companyName":{"type":["string","null"]},"companyDomain":{"type":["string","null"]},"companySize":{"type":["string","null"]},"companyIndustry":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"country":{"type":["string","null"]},"timezone":{"type":["string","null"]},"phoneDirect":{"type":["string","null"]},"phoneMobile":{"type":["string","null"]},"emailVerified":{"type":"boolean"},"enrichmentScore":{"type":["number","null"]},"dataFreshnessScore":{"type":["number","null"]},"identityConfidence":{"type":["number","null"]},"softCreditScore":{"type":["number","null"]},"softCreditBand":{"type":["string","null"],"enum":["low","medium","high","very_high","unknown",null]},"recommendedPaymentTerms":{"type":["string","null"],"enum":["prepay","net15","net30","net45","net60",null]},"recommendedCreditLimit":{"type":["number","null"]},"lastEnrichedAt":{"type":["string","null"]},"enrichmentVersion":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","fullName","firstName","lastName","photoUrl","jobTitle","seniority","department","companyName","companyDomain","companySize","companyIndustry","city","state","country","timezone","phoneDirect","phoneMobile","emailVerified","enrichmentScore","dataFreshnessScore","identityConfidence","softCreditScore","softCreditBand","recommendedPaymentTerms","recommendedCreditLimit","lastEnrichedAt","enrichmentVersion","createdAt","updatedAt"]},"socialProfiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"platform":{"type":"string","enum":["linkedin","twitter","github","facebook","instagram","youtube","tiktok","medium","angellist","crunchbase"]},"profileUrl":{"type":"string"},"username":{"type":["string","null"]},"profileData":{"type":["object","null"],"additionalProperties":{}},"followers":{"type":["number","null"]},"following":{"type":["number","null"]},"postsCount":{"type":["number","null"]},"engagementRate":{"type":["number","null"]},"verified":{"type":"boolean"},"lastCrawledAt":{"type":["string","null"]},"crawlStatus":{"type":["string","null"],"enum":["success","failed","blocked","not_found",null]},"discoveredBy":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","enrichedProfileId","platform","profileUrl","username","profileData","followers","following","postsCount","engagementRate","verified","lastCrawledAt","crawlStatus","discoveredBy","confidence","createdAt","updatedAt"]}},"creditScores":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"scoreType":{"type":"string","enum":["email_risk","phone_risk","soft_credit","business_credit"]},"provider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"score":{"type":["number","null"]},"scoreBand":{"type":["string","null"],"enum":["low","medium","high","very_high","unknown",null]},"rawScore":{"type":["string","null"]},"factors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"}]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"weight":{"type":"number"}},"required":["name","value","impact","weight"]}},"riskSignals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"description":{"type":"string"}},"required":["type","severity","description"]}},"costCents":{"type":["number","null"]},"scoredAt":{"type":"string"},"expiresAt":{"type":["string","null"]}},"required":["id","enrichedProfileId","scoreType","provider","score","scoreBand","rawScore","factors","riskSignals","costCents","scoredAt","expiresAt"]}},"dataQuality":{"type":"object","properties":{"enrichmentScore":{"type":"number"},"freshnessScore":{"type":"number"},"missingFields":{"type":"array","items":{"type":"string"}},"stalestField":{"type":["object","null"],"properties":{"field":{"type":"string"},"age":{"type":"string"}},"required":["field","age"]}},"required":["enrichmentScore","freshnessScore","missingFields","stalestField"]}},"required":["profile","socialProfiles","creditScores","dataQuality"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/enrich":{"post":{"operationId":"triggerEnrichment","summary":"Trigger enrichment","description":"Start enrichment process for a contact","tags":["Enrichment - Requests"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"requestBody":{"description":"Enrichment options","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["full","refresh","social_only","credit_only"],"default":"full"},"priority":{"type":"number","minimum":1,"maximum":10,"default":5},"providers":{"type":"array","items":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"minItems":1},"email":{"type":"string","format":"email"},"phone":{"type":"string"},"name":{"type":"string"}}}}}},"responses":{"201":{"description":"Enrichment started","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string"},"status":{"type":"string","enum":["queued","processing","completed","failed","partial"]},"estimatedCompletionSeconds":{"type":"number"}},"required":["requestId","status","estimatedCompletionSeconds"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/requests/{requestId}":{"get":{"operationId":"getEnrichmentRequest","summary":"Get enrichment request status","description":"Get status and progress of an enrichment request","tags":["Enrichment - Requests"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"req_abc123"},"required":true,"name":"requestId","in":"path"}],"responses":{"200":{"description":"Enrichment request status","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"requestType":{"type":"string","enum":["full","refresh","social_only","credit_only"]},"priority":{"type":"number"},"inputData":{"type":["object","null"],"properties":{"email":{"type":"string"},"phone":{"type":"string"},"name":{"type":"string"},"companyName":{"type":"string"},"linkedInUrl":{"type":"string"}}},"status":{"type":"string","enum":["queued","processing","completed","failed","partial"]},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"providersCalled":{"type":"array","items":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]}},"dataPointsAdded":{"type":"number"},"enrichmentScoreBefore":{"type":["number","null"]},"enrichmentScoreAfter":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"retryCount":{"type":"number"},"createdAt":{"type":"string"},"createdBy":{"type":"string"}},"required":["id","organizationId","contactId","requestType","priority","inputData","status","startedAt","completedAt","providersCalled","dataPointsAdded","enrichmentScoreBefore","enrichmentScoreAfter","errorMessage","retryCount","createdAt","createdBy"]},"progress":{"type":"object","properties":{"providersTotal":{"type":"number"},"providersCompleted":{"type":"number"},"currentProvider":{"type":["string","null"]}},"required":["providersTotal","providersCompleted","currentProvider"]},"result":{"type":["object","null"],"properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"fullName":{"type":["string","null"]},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"photoUrl":{"type":["string","null"]},"jobTitle":{"type":["string","null"]},"seniority":{"type":["string","null"],"enum":["c_level","vp","director","manager","senior","staff","entry","intern",null]},"department":{"type":["string","null"]},"companyName":{"type":["string","null"]},"companyDomain":{"type":["string","null"]},"companySize":{"type":["string","null"]},"companyIndustry":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"country":{"type":["string","null"]},"timezone":{"type":["string","null"]},"phoneDirect":{"type":["string","null"]},"phoneMobile":{"type":["string","null"]},"emailVerified":{"type":"boolean"},"enrichmentScore":{"type":["number","null"]},"dataFreshnessScore":{"type":["number","null"]},"identityConfidence":{"type":["number","null"]},"softCreditScore":{"type":["number","null"]},"softCreditBand":{"type":["string","null"],"enum":["low","medium","high","very_high","unknown",null]},"recommendedPaymentTerms":{"type":["string","null"],"enum":["prepay","net15","net30","net45","net60",null]},"recommendedCreditLimit":{"type":["number","null"]},"lastEnrichedAt":{"type":["string","null"]},"enrichmentVersion":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","contactId","fullName","firstName","lastName","photoUrl","jobTitle","seniority","department","companyName","companyDomain","companySize","companyIndustry","city","state","country","timezone","phoneDirect","phoneMobile","emailVerified","enrichmentScore","dataFreshnessScore","identityConfidence","softCreditScore","softCreditBand","recommendedPaymentTerms","recommendedCreditLimit","lastEnrichedAt","enrichmentVersion","createdAt","updatedAt"]}},"required":["request","progress","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Request not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/requests":{"get":{"operationId":"listEnrichmentRequests","summary":"List enrichment requests","description":"Get paginated list of enrichment requests","tags":["Enrichment - Requests"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["queued","processing","completed","failed","partial"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"contactId","in":"query"}],"responses":{"200":{"description":"Enrichment requests list","content":{"application/json":{"schema":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"contactId":{"type":"string"},"requestType":{"type":"string","enum":["full","refresh","social_only","credit_only"]},"priority":{"type":"number"},"inputData":{"type":["object","null"],"properties":{"email":{"type":"string"},"phone":{"type":"string"},"name":{"type":"string"},"companyName":{"type":"string"},"linkedInUrl":{"type":"string"}}},"status":{"type":"string","enum":["queued","processing","completed","failed","partial"]},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"providersCalled":{"type":"array","items":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]}},"dataPointsAdded":{"type":"number"},"enrichmentScoreBefore":{"type":["number","null"]},"enrichmentScoreAfter":{"type":["number","null"]},"errorMessage":{"type":["string","null"]},"retryCount":{"type":"number"},"createdAt":{"type":"string"},"createdBy":{"type":"string"}},"required":["id","organizationId","contactId","requestType","priority","inputData","status","startedAt","completedAt","providersCalled","dataPointsAdded","enrichmentScoreBefore","enrichmentScoreAfter","errorMessage","retryCount","createdAt","createdBy"]}},"total":{"type":"number"},"page":{"type":"number"},"limit":{"type":"number"}},"required":["requests","total","page","limit"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/bulk":{"post":{"operationId":"bulkEnrichment","summary":"Bulk enrichment","description":"Start enrichment for multiple contacts","tags":["Enrichment - Requests"],"security":[{"Bearer":[]}],"requestBody":{"description":"Bulk enrichment options","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contactIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":100},"type":{"type":"string","enum":["full","refresh","social_only","credit_only"],"default":"full"},"priority":{"type":"number","minimum":1,"maximum":10,"default":5}},"required":["contactIds"]}}}},"responses":{"201":{"description":"Bulk enrichment started","content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string"},"requests":{"type":"array","items":{"type":"object","properties":{"contactId":{"type":"string"},"requestId":{"type":"string"}},"required":["contactId","requestId"]}},"estimatedCompletionMinutes":{"type":"number"}},"required":["batchId","requests","estimatedCompletionMinutes"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/social":{"get":{"operationId":"getSocialProfiles","summary":"Get social profiles","description":"Get discovered social profiles for a contact","tags":["Enrichment - Social"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Social profiles with discovery status","content":{"application/json":{"schema":{"type":"object","properties":{"profiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"platform":{"type":"string","enum":["linkedin","twitter","github","facebook","instagram","youtube","tiktok","medium","angellist","crunchbase"]},"profileUrl":{"type":"string"},"username":{"type":["string","null"]},"profileData":{"type":["object","null"],"additionalProperties":{}},"followers":{"type":["number","null"]},"following":{"type":["number","null"]},"postsCount":{"type":["number","null"]},"engagementRate":{"type":["number","null"]},"verified":{"type":"boolean"},"lastCrawledAt":{"type":["string","null"]},"crawlStatus":{"type":["string","null"],"enum":["success","failed","blocked","not_found",null]},"discoveredBy":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","enrichedProfileId","platform","profileUrl","username","profileData","followers","following","postsCount","engagementRate","verified","lastCrawledAt","crawlStatus","discoveredBy","confidence","createdAt","updatedAt"]}},"discoveryStatus":{"type":"object","properties":{"linkedin":{"type":"string","enum":["found","not_found","not_searched"]},"twitter":{"type":"string","enum":["found","not_found","not_searched"]},"github":{"type":"string","enum":["found","not_found","not_searched"]},"facebook":{"type":"string","enum":["found","not_found","not_searched"]},"instagram":{"type":"string","enum":["found","not_found","not_searched"]},"youtube":{"type":"string","enum":["found","not_found","not_searched"]},"tiktok":{"type":"string","enum":["found","not_found","not_searched"]},"medium":{"type":"string","enum":["found","not_found","not_searched"]},"angellist":{"type":"string","enum":["found","not_found","not_searched"]},"crunchbase":{"type":"string","enum":["found","not_found","not_searched"]}}}},"required":["profiles","discoveryStatus"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"addSocialProfile","summary":"Add social profile","description":"Manually add a social profile for a contact","tags":["Enrichment - Social"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"requestBody":{"description":"Social profile data","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["linkedin","twitter","github","facebook","instagram","youtube","tiktok","medium","angellist","crunchbase"]},"profileUrl":{"type":"string","format":"uri"},"username":{"type":"string"},"followers":{"type":"integer"},"following":{"type":"integer"},"postsCount":{"type":"integer"},"engagementRate":{"type":"number"}},"required":["platform","profileUrl"]}}}},"responses":{"201":{"description":"Social profile added","content":{"application/json":{"schema":{"type":"object","properties":{"socialProfile":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"platform":{"type":"string","enum":["linkedin","twitter","github","facebook","instagram","youtube","tiktok","medium","angellist","crunchbase"]},"profileUrl":{"type":"string"},"username":{"type":["string","null"]},"profileData":{"type":["object","null"],"additionalProperties":{}},"followers":{"type":["number","null"]},"following":{"type":["number","null"]},"postsCount":{"type":["number","null"]},"engagementRate":{"type":["number","null"]},"verified":{"type":"boolean"},"lastCrawledAt":{"type":["string","null"]},"crawlStatus":{"type":["string","null"],"enum":["success","failed","blocked","not_found",null]},"discoveredBy":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","enrichedProfileId","platform","profileUrl","username","profileData","followers","following","postsCount","engagementRate","verified","lastCrawledAt","crawlStatus","discoveredBy","confidence","createdAt","updatedAt"]}},"required":["socialProfile"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Profile already exists","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/social/{profileId}":{"delete":{"operationId":"deleteSocialProfile","summary":"Delete social profile","description":"Remove a social profile from a contact","tags":["Enrichment - Social"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"},{"schema":{"type":"string","example":"sp_abc123"},"required":true,"name":"profileId","in":"path"}],"responses":{"200":{"description":"Social profile deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Profile not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/credit":{"get":{"operationId":"getCreditAssessment","summary":"Get credit assessment","description":"Get credit/risk assessment and payment recommendations","tags":["Enrichment - Credit"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Credit assessment with recommendations","content":{"application/json":{"schema":{"type":"object","properties":{"softCreditScore":{"type":["number","null"]},"riskBand":{"type":"string","enum":["low","medium","high","very_high","unknown"]},"scores":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"scoreType":{"type":"string","enum":["email_risk","phone_risk","soft_credit","business_credit"]},"provider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"score":{"type":["number","null"]},"scoreBand":{"type":["string","null"],"enum":["low","medium","high","very_high","unknown",null]},"rawScore":{"type":["string","null"]},"factors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"}]},"impact":{"type":"string","enum":["positive","negative","neutral"]},"weight":{"type":"number"}},"required":["name","value","impact","weight"]}},"riskSignals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"description":{"type":"string"}},"required":["type","severity","description"]}},"costCents":{"type":["number","null"]},"scoredAt":{"type":"string"},"expiresAt":{"type":["string","null"]}},"required":["id","enrichedProfileId","scoreType","provider","score","scoreBand","rawScore","factors","riskSignals","costCents","scoredAt","expiresAt"]}},"recommendations":{"type":"object","properties":{"paymentTerms":{"type":"string","enum":["prepay","net15","net30","net45","net60"]},"creditLimit":{"type":"number"},"requireDeposit":{"type":"boolean"},"depositPercent":{"type":"number"},"reasoning":{"type":"array","items":{"type":"string"}}},"required":["paymentTerms","creditLimit","requireDeposit","reasoning"]}},"required":["softCreditScore","riskBand","scores","recommendations"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/credit/refresh":{"post":{"operationId":"refreshCreditScore","summary":"Refresh credit score","description":"Request a fresh credit/risk score check","tags":["Enrichment - Credit"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Credit refresh initiated","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/providers":{"get":{"operationId":"listProviders","summary":"List providers","description":"Get list of configured enrichment providers","tags":["Enrichment - Providers"],"security":[{"Bearer":[]}],"responses":{"200":{"description":"Provider configurations","content":{"application/json":{"schema":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"enabled":{"type":"boolean"},"monthlyLimit":{"type":["number","null"]},"monthlyUsed":{"type":"number"},"averageCost":{"type":"number"},"averageConfidence":{"type":"number"},"fields":{"type":"array","items":{"type":"string"}}},"required":["name","enabled","monthlyLimit","monthlyUsed","averageCost","averageConfidence","fields"]}}},"required":["providers"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/providers/{provider}":{"patch":{"operationId":"updateProviderConfig","summary":"Update provider config","description":"Update configuration for an enrichment provider","tags":["Enrichment - Providers"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"],"example":"clearbit"},"required":true,"name":"provider","in":"path"}],"requestBody":{"description":"Provider config updates","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"monthlyLimit":{"type":"number","exclusiveMinimum":0},"priority":{"type":"number","minimum":1,"maximum":10},"autoEnrichNewContacts":{"type":"boolean"},"refreshIntervalDays":{"type":"number","minimum":1,"maximum":365}}}}}},"responses":{"200":{"description":"Updated provider config","content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"provider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"enabled":{"type":"boolean"},"monthlyLimit":{"type":["number","null"]},"monthlyUsed":{"type":"number"},"limitResetAt":{"type":["string","null"]},"autoEnrichNewContacts":{"type":"boolean"},"refreshIntervalDays":{"type":"number"},"priority":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","provider","enabled","monthlyLimit","monthlyUsed","limitResetAt","autoEnrichNewContacts","refreshIntervalDays","priority","createdAt","updatedAt"]}},"required":["config"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Provider not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/data-points":{"get":{"operationId":"getDataPoints","summary":"Get data points","description":"Get all data points with provenance for a contact","tags":["Enrichment - Data Points"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"}],"responses":{"200":{"description":"Data points with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"dataPoints":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"fieldName":{"type":"string"},"fieldValue":{"type":"string"},"sourceProvider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"isPrimary":{"type":"boolean"},"observedAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","enrichedProfileId","fieldName","fieldValue","sourceProvider","confidence","isVerified","isPrimary","observedAt","createdAt"]}},"byField":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"fieldName":{"type":"string"},"fieldValue":{"type":"string"},"sourceProvider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"isPrimary":{"type":"boolean"},"observedAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","enrichedProfileId","fieldName","fieldValue","sourceProvider","confidence","isVerified","isPrimary","observedAt","createdAt"]}}}},"required":["dataPoints","byField"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Contact not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/enrichment/contacts/{contactId}/data-points/{dataPointId}/verify":{"post":{"operationId":"verifyDataPoint","summary":"Verify data point","description":"Mark a data point as verified and optionally make it primary","tags":["Enrichment - Data Points"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","example":"cnt_abc123"},"required":true,"name":"contactId","in":"path"},{"schema":{"type":"string","example":"dp_abc123"},"required":true,"name":"dataPointId","in":"path"}],"requestBody":{"description":"Verification options","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"verified":{"type":"boolean"},"makePrimary":{"type":"boolean"}},"required":["verified"]}}}},"responses":{"200":{"description":"Data point verified","content":{"application/json":{"schema":{"type":"object","properties":{"dataPoint":{"type":"object","properties":{"id":{"type":"string"},"enrichedProfileId":{"type":"string"},"fieldName":{"type":"string"},"fieldValue":{"type":"string"},"sourceProvider":{"type":"string","enum":["clearbit","zoominfo","apollo","fullcontact","hunter","linkedin","twitter","github","emailage","telesign","plaid","dnb","manual"]},"confidence":{"type":["number","null"]},"isVerified":{"type":"boolean"},"isPrimary":{"type":"boolean"},"observedAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","enrichedProfileId","fieldName","fieldValue","sourceProvider","confidence","isVerified","isPrimary","observedAt","createdAt"]}},"required":["dataPoint"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Data point not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/amazon/search":{"get":{"tags":["Marketplace"],"summary":"Search Amazon products","description":"Search for products on Amazon marketplace","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":10,"default":1,"description":"Page number"},"required":false,"description":"Page number","name":"page","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"},"source":{"type":"string","enum":["amazon","walmart","target"]},"sourceUrl":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"description":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"currency":{"type":"string"},"originalPrice":{"type":["number","null"]},"rating":{"type":["number","null"]},"reviewCount":{"type":"number"},"inStock":{"type":"boolean"},"amazonBsr":{"type":["number","null"]},"amazonBsrCategory":{"type":["string","null"]},"walmartBestSeller":{"type":["boolean","null"]},"fetchedAt":{"type":"number"},"dataQuality":{"type":"string","enum":["complete","partial","minimal"]}},"required":["sourceId","source","sourceUrl","name","brand","description","category","subcategory","images","price","currency","originalPrice","rating","reviewCount","inStock","amazonBsr","amazonBsrCategory","walmartBestSeller","fetchedAt","dataQuality"]}},"query":{"type":"string"},"page":{"type":"number"},"cached":{"type":"boolean"}},"required":["products","query","page","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/amazon/product/{asin}":{"get":{"tags":["Marketplace"],"summary":"Get Amazon product details","description":"Get detailed product information from Amazon by ASIN","parameters":[{"schema":{"type":"string","description":"Amazon ASIN"},"required":true,"description":"Amazon ASIN","name":"asin","in":"path"}],"responses":{"200":{"description":"Product details","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":["object","null"],"properties":{"sourceId":{"type":"string"},"source":{"type":"string","enum":["amazon","walmart","target"]},"sourceUrl":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"description":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"currency":{"type":"string"},"originalPrice":{"type":["number","null"]},"rating":{"type":["number","null"]},"reviewCount":{"type":"number"},"inStock":{"type":"boolean"},"amazonBsr":{"type":["number","null"]},"amazonBsrCategory":{"type":["string","null"]},"walmartBestSeller":{"type":["boolean","null"]},"fetchedAt":{"type":"number"},"dataQuality":{"type":"string","enum":["complete","partial","minimal"]}},"required":["sourceId","source","sourceUrl","name","brand","description","category","subcategory","images","price","currency","originalPrice","rating","reviewCount","inStock","amazonBsr","amazonBsrCategory","walmartBestSeller","fetchedAt","dataQuality"]},"cached":{"type":"boolean"}},"required":["product","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/walmart/search":{"get":{"tags":["Marketplace"],"summary":"Search Walmart products","description":"Search for products on Walmart marketplace","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":10,"default":1,"description":"Page number"},"required":false,"description":"Page number","name":"page","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"},"source":{"type":"string","enum":["amazon","walmart","target"]},"sourceUrl":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"description":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"currency":{"type":"string"},"originalPrice":{"type":["number","null"]},"rating":{"type":["number","null"]},"reviewCount":{"type":"number"},"inStock":{"type":"boolean"},"amazonBsr":{"type":["number","null"]},"amazonBsrCategory":{"type":["string","null"]},"walmartBestSeller":{"type":["boolean","null"]},"fetchedAt":{"type":"number"},"dataQuality":{"type":"string","enum":["complete","partial","minimal"]}},"required":["sourceId","source","sourceUrl","name","brand","description","category","subcategory","images","price","currency","originalPrice","rating","reviewCount","inStock","amazonBsr","amazonBsrCategory","walmartBestSeller","fetchedAt","dataQuality"]}},"query":{"type":"string"},"page":{"type":"number"},"cached":{"type":"boolean"}},"required":["products","query","page","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/walmart/product/{itemId}":{"get":{"tags":["Marketplace"],"summary":"Get Walmart product details","description":"Get detailed product information from Walmart by item ID","parameters":[{"schema":{"type":"string","description":"Walmart item ID"},"required":true,"description":"Walmart item ID","name":"itemId","in":"path"}],"responses":{"200":{"description":"Product details","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":["object","null"],"properties":{"sourceId":{"type":"string"},"source":{"type":"string","enum":["amazon","walmart","target"]},"sourceUrl":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"description":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"currency":{"type":"string"},"originalPrice":{"type":["number","null"]},"rating":{"type":["number","null"]},"reviewCount":{"type":"number"},"inStock":{"type":"boolean"},"amazonBsr":{"type":["number","null"]},"amazonBsrCategory":{"type":["string","null"]},"walmartBestSeller":{"type":["boolean","null"]},"fetchedAt":{"type":"number"},"dataQuality":{"type":"string","enum":["complete","partial","minimal"]}},"required":["sourceId","source","sourceUrl","name","brand","description","category","subcategory","images","price","currency","originalPrice","rating","reviewCount","inStock","amazonBsr","amazonBsrCategory","walmartBestSeller","fetchedAt","dataQuality"]},"cached":{"type":"boolean"}},"required":["product","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/trends":{"get":{"tags":["Marketplace"],"summary":"Get Google Trends data","description":"Get search interest and related queries for a keyword","parameters":[{"schema":{"type":"string","minLength":1,"description":"Keyword to analyze"},"required":true,"description":"Keyword to analyze","name":"keyword","in":"query"},{"schema":{"type":"string","enum":["1d","7d","30d","90d","12m","5y"],"default":"12m","description":"Time range for trend data"},"required":false,"description":"Time range for trend data","name":"timeframe","in":"query"},{"schema":{"type":"string","default":"US","description":"Geographic region"},"required":false,"description":"Geographic region","name":"geo","in":"query"}],"responses":{"200":{"description":"Trends data","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":["object","null"],"properties":{"keyword":{"type":"string"},"timeframe":{"type":"string"},"geo":{"type":"string"},"interestOverTime":{"type":"array","items":{"type":"object","properties":{"date":{"type":"number"},"value":{"type":"number"}},"required":["date","value"]}},"averageInterest":{"type":"number"},"peakInterest":{"type":"number"},"currentInterest":{"type":"number"},"trend":{"type":"string","enum":["rising","stable","declining"]},"trendStrength":{"type":"number"},"relatedQueries":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"value":{"type":"number"},"type":{"type":"string","enum":["top","rising"]}},"required":["query","value","type"]}},"relatedTopics":{"type":"array","items":{"type":"object","properties":{"topic":{"type":"string"},"value":{"type":"number"},"type":{"type":"string","enum":["top","rising"]}},"required":["topic","value","type"]}},"fetchedAt":{"type":"number"}},"required":["keyword","timeframe","geo","interestOverTime","averageInterest","peakInterest","currentInterest","trend","trendStrength","relatedQueries","relatedTopics","fetchedAt"]},"cached":{"type":"boolean"}},"required":["data","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/ads/search":{"get":{"tags":["Marketplace"],"summary":"Search Meta Ad Library","description":"Search for ads across Meta platforms","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search terms for ads"},"required":true,"description":"Search terms for ads","name":"q","in":"query"},{"schema":{"type":"string","default":"US","description":"Country code"},"required":false,"description":"Country code","name":"country","in":"query"}],"responses":{"200":{"description":"Ad search results","content":{"application/json":{"schema":{"type":"object","properties":{"ads":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["meta","tiktok","google"]},"pageName":{"type":"string"},"pageId":{"type":["string","null"]},"headline":{"type":["string","null"]},"bodyText":{"type":["string","null"]},"callToAction":{"type":["string","null"]},"mediaUrls":{"type":"array","items":{"type":"string"}},"landingPageUrl":{"type":["string","null"]},"startDate":{"type":["number","null"]},"endDate":{"type":["number","null"]},"impressions":{"type":["object","null"],"properties":{"lowerBound":{"type":"number"},"upperBound":{"type":"number"}},"required":["lowerBound","upperBound"]},"spend":{"type":["object","null"],"properties":{"lowerBound":{"type":"number"},"upperBound":{"type":"number"},"currency":{"type":"string"}},"required":["lowerBound","upperBound","currency"]},"countries":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"snapshotUrl":{"type":["string","null"]},"fetchedAt":{"type":"number"}},"required":["id","source","pageName","pageId","headline","bodyText","callToAction","mediaUrls","landingPageUrl","startDate","endDate","impressions","spend","countries","platforms","snapshotUrl","fetchedAt"]}},"query":{"type":"string"},"cached":{"type":"boolean"}},"required":["ads","query","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"/v1/intelligence/marketplace/ads/page/{pageId}":{"get":{"tags":["Marketplace"],"summary":"Get ads for a Meta page","description":"Get active ads for a specific Facebook/Instagram page","parameters":[{"schema":{"type":"string","description":"Meta Page ID"},"required":true,"description":"Meta Page ID","name":"pageId","in":"path"}],"responses":{"200":{"description":"Page ads","content":{"application/json":{"schema":{"type":"object","properties":{"ads":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["meta","tiktok","google"]},"pageName":{"type":"string"},"pageId":{"type":["string","null"]},"headline":{"type":["string","null"]},"bodyText":{"type":["string","null"]},"callToAction":{"type":["string","null"]},"mediaUrls":{"type":"array","items":{"type":"string"}},"landingPageUrl":{"type":["string","null"]},"startDate":{"type":["number","null"]},"endDate":{"type":["number","null"]},"impressions":{"type":["object","null"],"properties":{"lowerBound":{"type":"number"},"upperBound":{"type":"number"}},"required":["lowerBound","upperBound"]},"spend":{"type":["object","null"],"properties":{"lowerBound":{"type":"number"},"upperBound":{"type":"number"},"currency":{"type":"string"}},"required":["lowerBound","upperBound","currency"]},"countries":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"snapshotUrl":{"type":["string","null"]},"fetchedAt":{"type":"number"}},"required":["id","source","pageName","pageId","headline","bodyText","callToAction","mediaUrls","landingPageUrl","startDate","endDate","impressions","spend","countries","platforms","snapshotUrl","fetchedAt"]}},"pageId":{"type":"string"},"analysis":{"type":"object","properties":{"totalAds":{"type":"number"},"activeAds":{"type":"number"},"estimatedMonthlySpend":{"type":["object","null"],"properties":{"min":{"type":"number"},"max":{"type":"number"}},"required":["min","max"]},"platforms":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}}},"required":["totalAds","activeAds","estimatedMonthlySpend","platforms","countries"]},"cached":{"type":"boolean"}},"required":["ads","pageId","analysis","cached"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}},"503":{"description":"Provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message"]}},"required":["error"]}}}}}}},"//v1/intelligence/providers/health":{"get":{"tags":["Analytics"],"summary":"Get provider health status","description":"Returns health status for all integrated data providers","responses":{"200":{"description":"Provider health status","content":{"application/json":{"schema":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"object","properties":{"providerName":{"type":"string"},"status":{"type":"string","enum":["healthy","degraded","unhealthy"]},"successRate":{"type":"number"},"avgLatencyMs":{"type":["number","null"]},"errorCount":{"type":"number"},"circuitBreakerState":{"type":["string","null"],"enum":["closed","open","half-open",null]},"lastSuccessAt":{"type":["string","null"]},"lastFailureAt":{"type":["string","null"]}},"required":["providerName","status","successRate","avgLatencyMs","errorCount","circuitBreakerState","lastSuccessAt","lastFailureAt"]}},"overallStatus":{"type":"string","enum":["healthy","degraded","unhealthy"]},"lastUpdated":{"type":"string"}},"required":["providers","overallStatus","lastUpdated"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/analytics/usage":{"get":{"tags":["Analytics"],"summary":"Get provider usage analytics","description":"Returns usage statistics for data providers","parameters":[{"schema":{"type":"string","enum":["hourly","daily","weekly","monthly"],"default":"daily"},"required":false,"name":"period","in":"query"},{"schema":{"type":"string"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"provider","in":"query"}],"responses":{"200":{"description":"Usage analytics","content":{"application/json":{"schema":{"type":"object","properties":{"usage":{"type":"array","items":{"type":"object","properties":{"providerName":{"type":"string"},"requestCount":{"type":"number"},"errorCount":{"type":"number"},"cacheHits":{"type":"number"},"cacheMisses":{"type":"number"},"avgLatencyMs":{"type":"number"},"period":{"type":"string"},"periodStart":{"type":"string"}},"required":["providerName","requestCount","errorCount","cacheHits","cacheMisses","avgLatencyMs","period","periodStart"]}},"period":{"type":"string"},"totalRequests":{"type":"number"}},"required":["usage","period","totalRequests"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/analytics/cache":{"get":{"tags":["Analytics"],"summary":"Get cache statistics","description":"Returns cache hit/miss statistics","parameters":[{"schema":{"type":"string","enum":["hourly","daily","weekly","monthly"],"default":"daily"},"required":false,"name":"period","in":"query"},{"schema":{"type":"string"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"provider","in":"query"}],"responses":{"200":{"description":"Cache statistics","content":{"application/json":{"schema":{"type":"object","properties":{"stats":{"type":"array","items":{"type":"object","properties":{"dataType":{"type":"string"},"totalRequests":{"type":"number"},"cacheHits":{"type":"number"},"cacheMisses":{"type":"number"},"hitRatio":{"type":"number"},"avgFetchTimeMs":{"type":"number"}},"required":["dataType","totalRequests","cacheHits","cacheMisses","hitRatio","avgFetchTimeMs"]}},"overallHitRate":{"type":"number"},"totalRequests":{"type":"number"}},"required":["stats","overallHitRate","totalRequests"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/analytics/overview":{"get":{"tags":["Analytics"],"summary":"Get analytics overview","description":"Returns summary analytics for the Intelligence service","parameters":[{"schema":{"type":"string","enum":["hourly","daily","weekly","monthly"],"default":"daily"},"required":false,"name":"period","in":"query"},{"schema":{"type":"string"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"provider","in":"query"}],"responses":{"200":{"description":"Analytics overview","content":{"application/json":{"schema":{"type":"object","properties":{"totalRequests":{"type":"number"},"totalErrors":{"type":"number"},"cacheHitRate":{"type":"number"},"avgLatencyMs":{"type":"number"},"topProviders":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"requests":{"type":"number"},"percentage":{"type":"number"}},"required":["provider","requests","percentage"]}},"period":{"type":"string"}},"required":["totalRequests","totalErrors","cacheHitRate","avgLatencyMs","topProviders","period"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts/configs":{"get":{"tags":["Alerts"],"summary":"List alert configurations","description":"Get all alert configurations for the organization","responses":{"200":{"description":"List of alert configurations","content":{"application/json":{"schema":{"type":"object","properties":{"configs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"providerName":{"type":["string","null"]},"isEnabled":{"type":"boolean"},"errorRateThreshold":{"type":"number","minimum":0,"maximum":1},"latencyThresholdMs":{"type":"integer","exclusiveMinimum":0},"cacheHitRateThreshold":{"type":"number","minimum":0,"maximum":1},"consecutiveFailures":{"type":"integer","exclusiveMinimum":0},"notifyEmail":{"type":"boolean"},"notifyWebhook":{"type":"boolean"},"webhookUrl":{"type":["string","null"]},"cooldownMinutes":{"type":"integer","exclusiveMinimum":0},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","alertType","providerName","isEnabled","errorRateThreshold","latencyThresholdMs","cacheHitRateThreshold","consecutiveFailures","notifyEmail","notifyWebhook","webhookUrl","cooldownMinutes","createdAt","updatedAt"]}}},"required":["configs"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"tags":["Alerts"],"summary":"Create alert configuration","description":"Create a new alert configuration","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"providerName":{"type":"string"},"isEnabled":{"type":"boolean","default":true},"errorRateThreshold":{"type":"number","minimum":0,"maximum":1,"default":0.1},"latencyThresholdMs":{"type":"integer","exclusiveMinimum":0,"default":5000},"cacheHitRateThreshold":{"type":"number","minimum":0,"maximum":1,"default":0.5},"consecutiveFailures":{"type":"integer","exclusiveMinimum":0,"default":5},"notifyEmail":{"type":"boolean","default":true},"notifyWebhook":{"type":"boolean","default":false},"webhookUrl":{"type":"string"},"cooldownMinutes":{"type":"integer","exclusiveMinimum":0,"default":30}},"required":["alertType"]}}}},"responses":{"201":{"description":"Alert configuration created","content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"providerName":{"type":["string","null"]},"isEnabled":{"type":"boolean"},"errorRateThreshold":{"type":"number","minimum":0,"maximum":1},"latencyThresholdMs":{"type":"integer","exclusiveMinimum":0},"cacheHitRateThreshold":{"type":"number","minimum":0,"maximum":1},"consecutiveFailures":{"type":"integer","exclusiveMinimum":0},"notifyEmail":{"type":"boolean"},"notifyWebhook":{"type":"boolean"},"webhookUrl":{"type":["string","null"]},"cooldownMinutes":{"type":"integer","exclusiveMinimum":0},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","alertType","providerName","isEnabled","errorRateThreshold","latencyThresholdMs","cacheHitRateThreshold","consecutiveFailures","notifyEmail","notifyWebhook","webhookUrl","cooldownMinutes","createdAt","updatedAt"]}},"required":["config"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts/configs/{configId}":{"patch":{"tags":["Alerts"],"summary":"Update alert configuration","description":"Update an existing alert configuration","parameters":[{"schema":{"type":"string"},"required":true,"name":"configId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"providerName":{"type":"string"},"isEnabled":{"type":"boolean","default":true},"errorRateThreshold":{"type":"number","minimum":0,"maximum":1,"default":0.1},"latencyThresholdMs":{"type":"integer","exclusiveMinimum":0,"default":5000},"cacheHitRateThreshold":{"type":"number","minimum":0,"maximum":1,"default":0.5},"consecutiveFailures":{"type":"integer","exclusiveMinimum":0,"default":5},"notifyEmail":{"type":"boolean","default":true},"notifyWebhook":{"type":"boolean","default":false},"webhookUrl":{"type":"string"},"cooldownMinutes":{"type":"integer","exclusiveMinimum":0,"default":30}}}}}},"responses":{"200":{"description":"Alert configuration updated","content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"providerName":{"type":["string","null"]},"isEnabled":{"type":"boolean"},"errorRateThreshold":{"type":"number","minimum":0,"maximum":1},"latencyThresholdMs":{"type":"integer","exclusiveMinimum":0},"cacheHitRateThreshold":{"type":"number","minimum":0,"maximum":1},"consecutiveFailures":{"type":"integer","exclusiveMinimum":0},"notifyEmail":{"type":"boolean"},"notifyWebhook":{"type":"boolean"},"webhookUrl":{"type":["string","null"]},"cooldownMinutes":{"type":"integer","exclusiveMinimum":0},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","alertType","providerName","isEnabled","errorRateThreshold","latencyThresholdMs","cacheHitRateThreshold","consecutiveFailures","notifyEmail","notifyWebhook","webhookUrl","cooldownMinutes","createdAt","updatedAt"]}},"required":["config"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Configuration not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Alerts"],"summary":"Delete alert configuration","description":"Delete an alert configuration","parameters":[{"schema":{"type":"string"},"required":true,"name":"configId","in":"path"}],"responses":{"200":{"description":"Alert configuration deleted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts":{"get":{"tags":["Alerts"],"summary":"List alerts","description":"Get alerts with optional filtering","parameters":[{"schema":{"type":"string","enum":["active","acknowledged","resolved"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"required":false,"name":"alertType","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"List of alerts","content":{"application/json":{"schema":{"type":"object","properties":{"alerts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"alertConfigId":{"type":["string","null"]},"alertType":{"type":"string","enum":["provider_unhealthy","error_rate_spike","cache_degradation","latency_spike"]},"severity":{"type":"string","enum":["warning","critical"]},"providerName":{"type":["string","null"]},"title":{"type":"string"},"message":{"type":"string"},"metricValue":{"type":["number","null"]},"thresholdValue":{"type":["number","null"]},"status":{"type":"string","enum":["active","acknowledged","resolved"]},"acknowledgedBy":{"type":["string","null"]},"acknowledgedAt":{"type":["string","null"]},"resolvedAt":{"type":["string","null"]},"emailSentAt":{"type":["string","null"]},"webhookSentAt":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":["string","null"]}},"required":["id","organizationId","alertConfigId","alertType","severity","providerName","title","message","metricValue","thresholdValue","status","acknowledgedBy","acknowledgedAt","resolvedAt","emailSentAt","webhookSentAt","createdAt","updatedAt"]}}},"required":["alerts"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts/{alertId}/acknowledge":{"post":{"tags":["Alerts"],"summary":"Acknowledge alert","description":"Mark an alert as acknowledged","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"responses":{"200":{"description":"Alert acknowledged","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Alert not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts/{alertId}/resolve":{"post":{"tags":["Alerts"],"summary":"Resolve alert","description":"Mark an alert as resolved","parameters":[{"schema":{"type":"string"},"required":true,"name":"alertId","in":"path"}],"responses":{"200":{"description":"Alert resolved","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Alert not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"//v1/intelligence/alerts/providers/{providerName}/history":{"get":{"tags":["Alerts"],"summary":"Get provider health history","description":"Get health history for a specific provider","parameters":[{"schema":{"type":"string"},"required":true,"name":"providerName","in":"path"},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":168,"default":24},"required":false,"name":"hours","in":"query"}],"responses":{"200":{"description":"Provider health history","content":{"application/json":{"schema":{"type":"object","properties":{"history":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"providerName":{"type":"string"},"organizationId":{"type":["string","null"]},"status":{"type":"string","enum":["healthy","degraded","unhealthy"]},"successRate":{"type":["number","null"]},"avgLatencyMs":{"type":["number","null"]},"errorCount":{"type":"number"},"requestCount":{"type":"number"},"circuitState":{"type":["string","null"],"enum":["closed","open","half_open",null]},"circuitOpenedAt":{"type":["string","null"]},"checkAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","providerName","organizationId","status","successRate","avgLatencyMs","errorCount","requestCount","circuitState","circuitOpenedAt","checkAt","createdAt"]}}},"required":["history"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}},"webhooks":{}}