{"openapi":"3.1.0","info":{"title":"AEGLIX MIND Integration API","description":"Premium server-to-server Guardian assessments, stored public intelligence, relationships and indexed CVEs. Authentication uses scoped Bearer API keys. See https://aeglixmind.com/developers for consent, request budgets and processing limits.","version":"1.0.0"},"servers":[{"url":"https://aeglixmind.com"}],"paths":{"/api/v1/integrations/guardian/analyze":{"post":{"tags":["Integrations"],"summary":"Analyze a URL, message or screenshot","operationId":"analyzeGuardian","requestBody":{"content":{"application/json":{"schema":{"properties":{"kind":{"type":"string","enum":["url","message","screenshot"],"title":"Kind"},"consent":{"type":"boolean","const":true,"title":"Consent"},"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text"},"url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Url"},"image_base64":{"anyOf":[{"type":"string","maxLength":5600000},{"type":"null"}],"title":"Image Base64"},"deep_scan":{"type":"boolean","title":"Deep Scan","default":false}},"additionalProperties":false,"type":"object","required":["kind","consent"],"title":"AnalysisInput"},"examples":{"url":{"summary":"Analyze a URL","value":{"kind":"url","url":"example.com","deep_scan":false,"consent":true}},"message":{"summary":"Assess message text","value":{"kind":"message","text":"Hello, our team meeting is tomorrow at 10 AM.","consent":true}},"screenshot":{"summary":"Assess screenshot text","description":"Replace the placeholder with standard base64 for your own redacted PNG, JPEG or WebP screenshot.","value":{"kind":"screenshot","image_base64":"REPLACE_WITH_YOUR_BASE64_IMAGE","consent":true}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentResponse"}}}},"400":{"description":"Invalid target","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"401":{"description":"Invalid api key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}},"security":[{"IntegrationKey":[]}]}},"/api/v1/integrations/guardian/analyses/{analysis_id}":{"get":{"tags":["Integrations"],"summary":"Retrieve an assessment created by this key","operationId":"getGuardianAssessment","security":[{"IntegrationKey":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentResponse"}}}},"400":{"description":"Invalid target","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"401":{"description":"Invalid api key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}}}},"/api/v1/integrations/intelligence/lookup":{"post":{"tags":["Integrations"],"summary":"Look up a stored public indicator; no live target visit","operationId":"lookupIntelligence","requestBody":{"content":{"application/json":{"schema":{"properties":{"kind":{"type":"string","enum":["domain","url","ip","hash","cve"],"title":"Kind"},"value":{"type":"string","maxLength":2048,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["kind","value"],"title":"LookupInput"},"example":{"kind":"domain","value":"example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedGraphResponse"}}}},"400":{"description":"Invalid target","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"401":{"description":"Invalid api key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}},"security":[{"IntegrationKey":[]}]}},"/api/v1/integrations/entities/{entity_id}/relationships":{"get":{"tags":["Integrations"],"summary":"Read bounded public feed relationships","operationId":"getEntityRelationships","security":[{"IntegrationKey":[]}],"parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedGraphResponse"}}}},"400":{"description":"Invalid target","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"401":{"description":"Invalid api key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}}}},"/api/v1/integrations/cves/{cve_id}":{"get":{"tags":["Integrations"],"summary":"Read an indexed NVD vulnerability with CISA context","operationId":"getCVE","security":[{"IntegrationKey":[]}],"parameters":[{"name":"cve_id","in":"path","required":true,"schema":{"type":"string","title":"Cve Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CVESnapshot"}}}},"400":{"description":"Invalid target","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"401":{"description":"Invalid api key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"413":{"description":"Payload too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}}}}},"components":{"schemas":{"APIError":{"properties":{"detail":{"type":"string","title":"Detail"},"error":{"$ref":"#/components/schemas/APIErrorDetail"}},"type":"object","required":["detail","error"],"title":"APIError"},"APIErrorDetail":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"request_id":{"type":"string","title":"Request Id"}},"type":"object","required":["code","message","request_id"],"title":"APIErrorDetail"},"AssessmentResponse":{"properties":{"schema_version":{"type":"string","const":"guardian-assessment-v1","title":"Schema Version"},"id":{"type":"string","title":"Id"},"kind":{"type":"string","enum":["url","message","screenshot"],"title":"Kind"},"status":{"type":"string","const":"completed","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"result":{"anyOf":[{"$ref":"#/components/schemas/URLAssessment"},{"$ref":"#/components/schemas/MessageAssessment"}],"title":"Result"}},"type":"object","required":["schema_version","id","kind","status","created_at","expires_at","result"],"title":"AssessmentResponse"},"CVESnapshot":{"properties":{"id":{"type":"string","title":"Id"},"source":{"type":"string","const":"nvd","title":"Source"},"description":{"type":"string","title":"Description"},"retrieved_at":{"type":"string","format":"date-time","title":"Retrieved At"},"published":{"type":"string","title":"Published"},"modified":{"type":"string","title":"Modified"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"severity":{"type":"string","title":"Severity"},"exploited":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Exploited"},"kev_checked":{"type":"boolean","title":"Kev Checked"},"kev_stale":{"type":"boolean","title":"Kev Stale"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"vector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vector"},"cvss_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cvss Version"},"affected":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Affected"},"weaknesses":{"items":{"type":"string"},"type":"array","title":"Weaknesses"},"references":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"References"},"kev":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kev"},"products":{"items":{"type":"string"},"type":"array","title":"Products"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"configurations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Configurations"}},"additionalProperties":true,"type":"object","required":["id","source","description","retrieved_at","published","modified","score","severity","exploited","kev_checked","kev_stale"],"title":"CVESnapshot"},"FeedGraphResponse":{"properties":{"schema_version":{"type":"string","const":"public-evidence-graph-v1","title":"Schema Version"},"status":{"type":"string","const":"ready","title":"Status"},"anchor":{"additionalProperties":{"type":"string"},"type":"object","title":"Anchor"},"nodes":{"items":{"$ref":"#/components/schemas/PublicEntity"},"type":"array","title":"Nodes"},"edges":{"items":{"$ref":"#/components/schemas/PublicRelationship"},"type":"array","title":"Edges"},"coverage":{"$ref":"#/components/schemas/GraphCoverage"}},"type":"object","required":["schema_version","status","anchor","nodes","edges","coverage"],"title":"FeedGraphResponse"},"GraphCoverage":{"properties":{"scope":{"type":"string","title":"Scope"},"truncated":{"type":"boolean","title":"Truncated"},"stale_excluded":{"type":"integer","title":"Stale Excluded"},"limit":{"type":"integer","title":"Limit"},"notice":{"type":"string","title":"Notice"}},"type":"object","required":["scope","truncated","stale_excluded","limit","notice"],"title":"GraphCoverage"},"MLDetail":{"properties":{"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"probability_calibrated":{"type":"boolean","title":"Probability Calibrated","default":false},"available":{"type":"boolean","title":"Available"},"phishing_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Phishing Probability"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"}},"type":"object","required":["available"],"title":"MLDetail"},"MessageAssessment":{"properties":{"verdict":{"type":"string","enum":["LIKELY_SCAM","SUSPICIOUS","NO_CLEAR_SCAM_SIGNALS"],"title":"Verdict"},"scam_type":{"type":"string","maxLength":100,"minLength":1,"title":"Scam Type"},"summary":{"type":"string","maxLength":2000,"minLength":1,"title":"Summary"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"warning_signs":{"items":{"type":"string"},"type":"array","maxItems":15,"title":"Warning Signs"},"recommended_actions":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Recommended Actions"},"limitations":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Limitations"}},"type":"object","required":["verdict","scam_type","summary","confidence","warning_signs","recommended_actions","limitations"],"title":"MessageAssessment","description":"Validated model output; confidence expresses certainty, never safety."},"PublicEntity":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"value":{"type":"string","title":"Value"},"scope":{"type":"string","const":"public","title":"Scope"}},"type":"object","required":["id","type","value","scope"],"title":"PublicEntity"},"PublicRelationship":{"properties":{"id":{"type":"string","title":"Id"},"source":{"type":"string","title":"Source"},"target":{"type":"string","title":"Target"},"relation":{"type":"string","title":"Relation"},"relation_label":{"type":"string","title":"Relation Label"},"source_name":{"type":"string","title":"Source Name"},"source_url":{"type":"string","title":"Source Url"},"source_record":{"type":"string","title":"Source Record"},"observation_id":{"type":"string","title":"Observation Id"},"source_observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Observed At"},"retrieved_at":{"type":"string","format":"date-time","title":"Retrieved At"},"projection_version":{"type":"string","title":"Projection Version"},"source_fingerprint":{"type":"string","title":"Source Fingerprint"}},"type":"object","required":["id","source","target","relation","relation_label","source_name","source_url","source_record","observation_id","source_observed_at","retrieved_at","projection_version","source_fingerprint"],"title":"PublicRelationship"},"URLAssessment":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"url":{"type":"string","title":"Url"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score"},"risk_level":{"type":"string","title":"Risk Level"},"factors":{"items":{"type":"string"},"type":"array","title":"Factors"},"factor_count":{"type":"integer","title":"Factor Count"},"explanation":{"type":"string","title":"Explanation"},"deep_scan_used":{"type":"boolean","title":"Deep Scan Used"},"providers_unavailable":{"items":{"type":"string"},"type":"array","title":"Providers Unavailable"},"cached":{"type":"boolean","title":"Cached"},"ml":{"$ref":"#/components/schemas/MLDetail"},"ml_analysis":{"additionalProperties":true,"type":"object","title":"Ml Analysis"},"nemotron_analysis":{"additionalProperties":true,"type":"object","title":"Nemotron Analysis"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"}},"type":"object","required":["url","risk_score","risk_level","factors","factor_count","explanation","deep_scan_used","providers_unavailable","cached","ml","ml_analysis","nemotron_analysis"],"title":"URLAssessment"}},"securitySchemes":{"IntegrationKey":{"type":"http","scheme":"bearer"}}}}