{"openapi":"3.1.0","info":{"title":"ILC Agent API","description":"Pay-per-use data and AI utilities for autonomous agents.","version":"1.3.0"},"paths":{"/":{"get":{"summary":"Service status","description":"Free health check and links to the agent documentation.","operationId":"root_status__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Root Status  Get"}}}}}}},"/api/v1/weather/alerts":{"post":{"tags":["Authoritative Sources"],"summary":"Weather Alerts","operationId":"weather_alerts_api_v1_weather_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeatherQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/finance/sec-company":{"post":{"tags":["Authoritative Sources"],"summary":"Sec Company","operationId":"sec_company_api_v1_finance_sec_company_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/finance/treasury-debt":{"post":{"tags":["Authoritative Sources"],"summary":"Treasury Snapshot","operationId":"treasury_snapshot_api_v1_finance_treasury_debt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreasuryQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public-safety/disasters":{"post":{"tags":["Authoritative Sources"],"summary":"Disaster Declarations","operationId":"disaster_declarations_api_v1_public_safety_disasters_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisasterQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/food/drug-recalls":{"post":{"tags":["Authoritative Sources"],"summary":"Drug Recalls","operationId":"drug_recalls_api_v1_food_drug_recalls_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecallQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/geo/resolve":{"post":{"tags":["Authoritative Sources"],"summary":"Resolve Address","operationId":"resolve_address_api_v1_geo_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health/hospital-quality":{"post":{"tags":["Authoritative Sources"],"summary":"Hospital Quality","operationId":"hospital_quality_api_v1_health_hospital_quality_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HospitalQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows/company-brief":{"post":{"tags":["Authoritative Sources"],"summary":"Company Brief","operationId":"company_brief_api_v1_workflows_company_brief_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBriefQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows/property-due-diligence":{"post":{"tags":["Authoritative Sources"],"summary":"Property Due Diligence","operationId":"property_due_diligence_api_v1_workflows_property_due_diligence_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyWorkflowQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows/location-pulse":{"post":{"tags":["Authoritative Sources"],"summary":"Location Pulse","operationId":"location_pulse_api_v1_workflows_location_pulse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationPulseQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows/property-pulse":{"post":{"tags":["Authoritative Sources"],"summary":"Property Pulse","operationId":"property_pulse_api_v1_workflows_property_pulse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyPulseQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows/provider-area-pulse":{"post":{"tags":["Authoritative Sources"],"summary":"Provider Area Pulse","operationId":"provider_area_pulse_api_v1_workflows_provider_area_pulse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderAreaPulseQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/verify":{"post":{"tags":["Agent Loop"],"summary":"Verify Evidence","operationId":"verify_evidence_api_v1_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Evidence Api V1 Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/state/compare":{"post":{"tags":["Agent Loop"],"summary":"Compare State","operationId":"compare_state_api_v1_state_compare_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateCompareQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compare State Api V1 State Compare Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feedback":{"post":{"tags":["Agent Loop"],"summary":"Receive Feedback","operationId":"receive_feedback_api_v1_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Receive Feedback Api V1 Feedback Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/data/validate":{"post":{"tags":["Data Integrity"],"summary":"Validate Data Payload","operationId":"validate_data_payload_api_v1_data_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/finance/valuation":{"post":{"tags":["Financial Settlement"],"summary":"Calculate Asset Settlement","operationId":"calculate_asset_settlement_api_v1_finance_valuation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gaming/metrics":{"post":{"tags":["Gaming Metrics"],"summary":"Get Gaming Metrics","operationId":"get_gaming_metrics_api_v1_gaming_metrics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GamingQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GamingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health/verify":{"post":{"tags":["Medical Data Integrity"],"summary":"Verify Medical Data","operationId":"verify_medical_data_api_v1_health_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MedicalQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MedicalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/municipal/query":{"post":{"tags":["Municipal Data"],"summary":"Get Municipal Records","operationId":"get_municipal_records_api_v1_municipal_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunicipalQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunicipalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/social/analyze":{"post":{"tags":["Social Media Analytics"],"summary":"Analyze social presence","description":"Use this paid endpoint when an agent needs estimated engagement, sentiment, bot-density, or trend signals for a handle or hashtag. Send a JSON body with handle_or_hashtag and optionally platform.","operationId":"analyze_social_presence_api_v1_social_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/health":{"get":{"tags":["User-controlled AI context"],"summary":"Readiness for the selected context storage mode","operationId":"context_health_api_v1_context_health_get","parameters":[{"name":"storage_mode","in":"query","required":false,"schema":{"enum":["ilc_managed","client_managed","user_postgres"],"type":"string","default":"ilc_managed","title":"Storage Mode"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Context Health Api V1 Context Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/admin/tenants":{"post":{"tags":["User-controlled AI context"],"summary":"Create an integrating application tenant","operationId":"create_tenant_api_v1_context_admin_tenants_post","parameters":[{"name":"X-Context-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Context-Admin-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Create Tenant Api V1 Context Admin Tenants Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/admin/tenants/{tenant_id}/rotate-key":{"post":{"tags":["User-controlled AI context"],"summary":"Rotate an integrating application tenant key","operationId":"rotate_tenant_key_api_v1_context_admin_tenants__tenant_id__rotate_key_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tenant Id"}},{"name":"X-Context-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Context-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Rotate Tenant Key Api V1 Context Admin Tenants  Tenant Id  Rotate Key Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/admin/tenants/{tenant_id}":{"delete":{"tags":["User-controlled AI context"],"summary":"Delete an integrating application tenant","operationId":"delete_tenant_api_v1_context_admin_tenants__tenant_id__delete","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tenant Id"}},{"name":"X-Context-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Context-Admin-Key"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/admin/learning/aggregate":{"get":{"tags":["User-controlled AI context"],"summary":"Read privacy-thresholded shared-learning aggregates","operationId":"learning_aggregate_api_v1_context_admin_learning_aggregate_get","parameters":[{"name":"X-Context-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Context-Admin-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Learning Aggregate Api V1 Context Admin Learning Aggregate Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/read":{"post":{"tags":["User-controlled AI context"],"summary":"Read confirmed personal context","operationId":"get_context_api_v1_context_read_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextReadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Context Api V1 Context Read Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/packet":{"post":{"tags":["User-controlled AI context"],"summary":"Prepare a context packet for a client-side AI assistant","description":"Validate and package user-supplied context without persistence or model inference.","operationId":"prepare_context_packet_api_v1_context_packet_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPacketRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Prepare Context Packet Api V1 Context Packet Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/context/memories/save":{"post":{"tags":["User-controlled AI context"],"summary":"Save user-confirmed personal context","operationId":"create_memory_api_v1_context_memories_save_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Memory Api V1 Context Memories Save Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/memories/update":{"post":{"tags":["User-controlled AI context"],"summary":"Update user-confirmed personal context","operationId":"update_memory_api_v1_context_memories_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Update Memory Api V1 Context Memories Update Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/memories/delete":{"post":{"tags":["User-controlled AI context"],"summary":"Delete one memory without a payment charge","operationId":"delete_memory_api_v1_context_memories_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryDelete"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Delete Memory Api V1 Context Memories Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/memories/clear":{"post":{"tags":["User-controlled AI context"],"summary":"Clear all personal memories without a payment charge","operationId":"clear_memories_api_v1_context_memories_clear_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Response Clear Memories Api V1 Context Memories Clear Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/subject/erase":{"post":{"tags":["User-controlled AI context"],"summary":"Erase a subject's context and feedback without a payment charge","operationId":"erase_subject_api_v1_context_subject_erase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"object","title":"Response Erase Subject Api V1 Context Subject Erase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/shared-learning":{"put":{"tags":["User-controlled AI context"],"summary":"Set explicit shared-learning consent without a payment charge","operationId":"set_shared_learning_api_v1_context_shared_learning_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedLearningUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Set Shared Learning Api V1 Context Shared Learning Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/shared-learning/feedback":{"post":{"tags":["User-controlled AI context"],"summary":"Submit structured, opt-in learning feedback","operationId":"submit_learning_feedback_api_v1_context_shared_learning_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LearningFeedbackCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Submit Learning Feedback Api V1 Context Shared Learning Feedback Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/workflows/budget-recovery":{"post":{"tags":["User-controlled AI context"],"summary":"Replan after a missed budget plan","operationId":"budget_recovery_api_v1_context_workflows_budget_recovery_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetRecoveryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Budget Recovery Api V1 Context Workflows Budget Recovery Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/context/workflows/budget-recovery/preview":{"post":{"tags":["User-controlled AI context"],"summary":"Try the budget-recovery workflow without database-backed memory","description":"Stateless calculation for integration testing; no context is loaded or saved.","operationId":"budget_recovery_preview_api_v1_context_workflows_budget_recovery_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetRecoveryPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Budget Recovery Preview Api V1 Context Workflows Budget Recovery Preview Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BudgetRecoveryPreviewRequest":{"properties":{"period_budget":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Period Budget"},"spent_so_far":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Spent So Far"},"days_remaining":{"type":"integer","maximum":366.0,"minimum":0.0,"title":"Days Remaining"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency","default":"USD"},"plan_was_missed":{"type":"boolean","title":"Plan Was Missed"},"what_changed":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"What Changed"}},"additionalProperties":false,"type":"object","required":["period_budget","spent_so_far","days_remaining","plan_was_missed"],"title":"BudgetRecoveryPreviewRequest"},"BudgetRecoveryRequest":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"period_budget":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Period Budget"},"spent_so_far":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Spent So Far"},"days_remaining":{"type":"integer","maximum":366.0,"minimum":0.0,"title":"Days Remaining"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency","default":"USD"},"plan_was_missed":{"type":"boolean","title":"Plan Was Missed"},"what_changed":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"What Changed"}},"additionalProperties":false,"type":"object","required":["subject_id","period_budget","spent_so_far","days_remaining","plan_was_missed"],"title":"BudgetRecoveryRequest"},"CompanyBriefQuery":{"properties":{"ticker_or_cik":{"type":"string","title":"Ticker Or Cik"}},"type":"object","required":["ticker_or_cik"],"title":"CompanyBriefQuery"},"CompanyQuery":{"properties":{"ticker_or_cik":{"type":"string","title":"Ticker Or Cik","description":"SEC ticker symbol or 10-digit CIK."}},"type":"object","required":["ticker_or_cik"],"title":"CompanyQuery"},"ContextItem":{"properties":{"content":{"type":"string","maxLength":4000,"minLength":1,"title":"Content"},"source":{"type":"string","maxLength":120,"minLength":1,"title":"Source"},"user_confirmed":{"type":"boolean","title":"User Confirmed","default":false},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"}},"additionalProperties":false,"type":"object","required":["content","source"],"title":"ContextItem"},"ContextPacketRequest":{"properties":{"objective":{"type":"string","maxLength":2000,"minLength":1,"title":"Objective"},"constraints":{"items":{"type":"string"},"type":"array","maxItems":40,"title":"Constraints"},"context":{"items":{"$ref":"#/components/schemas/ContextItem"},"type":"array","maxItems":100,"title":"Context"},"storage_mode":{"type":"string","enum":["client_managed","user_postgres"],"title":"Storage Mode"}},"additionalProperties":false,"type":"object","required":["objective","storage_mode"],"title":"ContextPacketRequest"},"ContextReadRequest":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."}},"additionalProperties":false,"type":"object","required":["subject_id"],"title":"ContextReadRequest"},"DataPayload":{"properties":{"payload_to_check":{"additionalProperties":true,"type":"object","title":"Payload To Check"}},"type":"object","required":["payload_to_check"],"title":"DataPayload"},"DataValidationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"is_valid":{"type":"boolean","title":"Is Valid"},"token_savings_est_usd":{"type":"number","title":"Token Savings Est Usd","description":"Estimated savings from avoiding a malformed downstream request."},"inspection_result":{"type":"string","title":"Inspection Result"},"data_status":{"type":"string","title":"Data Status","description":"This result is computed locally from the submitted payload.","default":"deterministic"},"source":{"type":"string","title":"Source","default":"local_payload_validation"}},"type":"object","required":["is_valid","token_savings_est_usd","inspection_result"],"title":"DataValidationResponse"},"DisasterQuery":{"properties":{"state":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"State"},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","title":"DisasterQuery"},"FeedbackQuery":{"properties":{"workflow":{"type":"string","maxLength":200,"minLength":1,"title":"Workflow"},"outcome":{"type":"string","maxLength":100,"minLength":1,"title":"Outcome"},"useful":{"type":"boolean","title":"Useful"},"request_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Request Id"},"snapshot_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Snapshot Id"},"correction_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Correction Type"}},"type":"object","required":["workflow","outcome","useful"],"title":"FeedbackQuery"},"GamingData":{"properties":{"active_daily_players_est":{"type":"integer","title":"Active Daily Players Est"},"in_game_asset_floor_usd":{"type":"number","title":"In Game Asset Floor Usd"},"liquidity_depth_score":{"type":"number","title":"Liquidity Depth Score"},"bot_activity_index":{"type":"number","title":"Bot Activity Index"}},"type":"object","required":["active_daily_players_est","in_game_asset_floor_usd","liquidity_depth_score","bot_activity_index"],"title":"GamingData"},"GamingQuery":{"properties":{"game_or_asset_id":{"type":"string","title":"Game Or Asset Id"},"network":{"type":"string","title":"Network","default":"onchain"}},"type":"object","required":["game_or_asset_id"],"title":"GamingQuery"},"GamingResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"asset_id":{"type":"string","title":"Asset Id"},"network":{"type":"string","title":"Network"},"data":{"$ref":"#/components/schemas/GamingData"},"data_status":{"type":"string","title":"Data Status","description":"These metrics are not fetched from a live game or chain indexer.","default":"demonstration"},"source":{"type":"string","title":"Source","default":"not_connected"},"warning":{"type":"string","title":"Warning","default":"Demonstration metrics only; live gaming data is not connected."}},"type":"object","required":["asset_id","network","data"],"title":"GamingResponse"},"GeoQuery":{"properties":{"address":{"type":"string","minLength":5,"title":"Address"}},"type":"object","required":["address"],"title":"GeoQuery"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HospitalQuery":{"properties":{"state":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"State"},"zip_code":{"anyOf":[{"type":"string","maxLength":5,"minLength":5},{"type":"null"}],"title":"Zip Code"},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","title":"HospitalQuery"},"LearningFeedbackCreate":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"category":{"type":"string","enum":["missing_context","misread_intent","plan_fit","tone","helpful"],"title":"Category"},"signal":{"type":"string","enum":["positive","negative","correction"],"title":"Signal"}},"additionalProperties":false,"type":"object","required":["subject_id","category","signal"],"title":"LearningFeedbackCreate"},"LocationPulseQuery":{"properties":{"address":{"anyOf":[{"type":"string","minLength":5},{"type":"null"}],"title":"Address","description":"US street address to monitor."},"state":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"State","description":"Two-letter state code when no address is supplied."},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10},"previous_snapshot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Snapshot","description":"Snapshot ID returned by a previous call."},"changes_only":{"type":"boolean","title":"Changes Only","description":"Return an empty payload when the snapshot has not changed.","default":false}},"type":"object","title":"LocationPulseQuery"},"MedicalQuery":{"properties":{"npi_or_code":{"type":"string","maxLength":10,"minLength":10,"title":"Npi Or Code","description":"A 10-digit National Provider Identifier (NPI).","examples":["1679576722"]},"query_type":{"type":"string","title":"Query Type","description":"Live CMS NPPES lookup type.","default":"npi_lookup"}},"type":"object","required":["npi_or_code"],"title":"MedicalQuery"},"MedicalResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"identifier":{"type":"string","title":"Identifier"},"query_type":{"type":"string","title":"Query Type"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"data_status":{"type":"string","title":"Data Status","description":"Live data returned from the CMS NPPES registry.","default":"live"},"source":{"type":"string","title":"Source","default":"CMS NPPES NPI Registry"},"source_url":{"type":"string","title":"Source Url","default":"https://npiregistry.cms.hhs.gov/api/"},"retrieved_at":{"type":"string","title":"Retrieved At"},"warning":{"type":"string","title":"Warning","default":"An NPI identifies a provider in NPPES; it does not prove state licensure, credentialing, or ability to practice."}},"type":"object","required":["identifier","query_type","data","retrieved_at"],"title":"MedicalResponse"},"MemoryCreate":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"category":{"type":"string","enum":["preference","goal","constraint","life_context","support_style"],"title":"Category"},"content":{"type":"string","maxLength":2000,"minLength":1,"title":"Content"},"confirmed_by_user":{"type":"boolean","const":true,"title":"Confirmed By User"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"additionalProperties":false,"type":"object","required":["subject_id","category","content","confirmed_by_user"],"title":"MemoryCreate"},"MemoryDelete":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"memory_id":{"type":"string","format":"uuid","title":"Memory Id"}},"additionalProperties":false,"type":"object","required":["subject_id","memory_id"],"title":"MemoryDelete"},"MemoryUpdate":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"memory_id":{"type":"string","format":"uuid","title":"Memory Id"},"category":{"anyOf":[{"type":"string","enum":["preference","goal","constraint","life_context","support_style"]},{"type":"null"}],"title":"Category"},"content":{"anyOf":[{"type":"string","maxLength":2000,"minLength":1},{"type":"null"}],"title":"Content"},"confirmed_by_user":{"type":"boolean","const":true,"title":"Confirmed By User"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"additionalProperties":false,"type":"object","required":["subject_id","memory_id","confirmed_by_user"],"title":"MemoryUpdate"},"MunicipalQuery":{"properties":{"county_or_zip":{"type":"string","title":"County Or Zip","description":"A Texas county name or ZIP code. Austin/Travis coverage is live first."},"record_type":{"type":"string","title":"Record Type","description":"permits, taxes, zoning, liens, or all.","default":"permits"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","description":"Street address for an Austin zoning or Travis tax lookup."}},"type":"object","required":["county_or_zip"],"title":"MunicipalQuery"},"MunicipalResponse":{"properties":{"status":{"type":"string","title":"Status"},"location":{"type":"string","title":"Location"},"record_type":{"type":"string","title":"Record Type"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"data_status":{"type":"string","title":"Data Status"},"source":{"type":"string","title":"Source"},"source_url":{"type":"string","title":"Source Url"},"retrieved_at":{"type":"string","title":"Retrieved At"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"}},"type":"object","required":["status","location","record_type","data","data_status","source","source_url","retrieved_at"],"title":"MunicipalResponse"},"PropertyPulseQuery":{"properties":{"county_or_zip":{"type":"string","title":"County Or Zip"},"address":{"type":"string","minLength":5,"title":"Address"},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10},"previous_snapshot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Snapshot","description":"Snapshot ID returned by a previous call."},"changes_only":{"type":"boolean","title":"Changes Only","description":"Return an empty payload when the snapshot has not changed.","default":false}},"type":"object","required":["county_or_zip","address"],"title":"PropertyPulseQuery"},"PropertyWorkflowQuery":{"properties":{"county_or_zip":{"type":"string","title":"County Or Zip"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"}},"type":"object","required":["county_or_zip"],"title":"PropertyWorkflowQuery"},"ProviderAreaPulseQuery":{"properties":{"npi":{"type":"string","maxLength":10,"minLength":10,"title":"Npi"},"zip_code":{"anyOf":[{"type":"string","maxLength":5,"minLength":5},{"type":"null"}],"title":"Zip Code"},"state":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"State"},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10},"previous_snapshot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Snapshot","description":"Snapshot ID returned by a previous call."},"changes_only":{"type":"boolean","title":"Changes Only","description":"Return an empty payload when the snapshot has not changed.","default":false}},"type":"object","required":["npi"],"title":"ProviderAreaPulseQuery"},"RecallQuery":{"properties":{"term":{"type":"string","minLength":2,"title":"Term","description":"Drug recall search term, such as a product or manufacturer."},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","required":["term"],"title":"RecallQuery"},"SettlementQuery":{"properties":{"asset_id":{"type":"string","title":"Asset Id"},"target_value_usd":{"type":"number","title":"Target Value Usd"}},"type":"object","required":["asset_id","target_value_usd"],"title":"SettlementQuery"},"SettlementResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"asset_id":{"type":"string","title":"Asset Id"},"input_value_usd":{"type":"number","title":"Input Value Usd"},"net_settlement_usd":{"type":"number","title":"Net Settlement Usd"},"suggested_stablecoin":{"type":"string","title":"Suggested Stablecoin","default":"USDC"},"settlement_network":{"type":"string","title":"Settlement Network","default":"Base"},"routing_fee_rate":{"type":"number","title":"Routing Fee Rate","description":"The deterministic 0.5% routing fee applied by this calculation.","default":0.005},"data_status":{"type":"string","title":"Data Status","description":"This result is computed locally; it is not a market valuation.","default":"deterministic"},"source":{"type":"string","title":"Source","default":"local_settlement_calculation"}},"type":"object","required":["asset_id","input_value_usd","net_settlement_usd"],"title":"SettlementResponse"},"SharedLearningUpdate":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."},"enabled":{"type":"boolean","title":"Enabled"},"confirmed_by_user":{"type":"boolean","const":true,"title":"Confirmed By User"}},"additionalProperties":false,"type":"object","required":["subject_id","enabled","confirmed_by_user"],"title":"SharedLearningUpdate"},"SocialAnalysisResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success"},"target":{"type":"string","title":"Target","description":"The handle or hashtag that was analyzed."},"platform":{"type":"string","title":"Platform","description":"The platform scope used for the analysis."},"data":{"$ref":"#/components/schemas/SocialMetrics"},"note":{"type":"string","title":"Note","description":"Clarifies whether the metrics are live or demonstration data."},"data_status":{"type":"string","title":"Data Status","description":"These values are not fetched from a live social platform.","default":"demonstration"},"source":{"type":"string","title":"Source","description":"The upstream source used for the metrics.","default":"not_connected"}},"type":"object","required":["target","platform","data","note"],"title":"SocialAnalysisResponse","description":"Response returned after a successful social analysis."},"SocialMetrics":{"properties":{"engagement_rate_pct":{"type":"number","title":"Engagement Rate Pct","description":"Estimated engagement rate as a percentage."},"sentiment_score_index":{"type":"number","title":"Sentiment Score Index","description":"Sentiment score from 0.0 (negative) to 1.0 (positive)."},"bot_density_estimate_pct":{"type":"number","title":"Bot Density Estimate Pct","description":"Estimated percentage of activity associated with bots."},"trending_relevance_score":{"type":"integer","title":"Trending Relevance Score","description":"Estimated relevance score from 0 to 100."}},"type":"object","required":["engagement_rate_pct","sentiment_score_index","bot_density_estimate_pct","trending_relevance_score"],"title":"SocialMetrics","description":"Social metrics returned by the analysis endpoint."},"SocialQuery":{"properties":{"handle_or_hashtag":{"type":"string","minLength":1,"title":"Handle Or Hashtag","description":"A social handle or hashtag, such as @example or #topic.","examples":["#example"]},"platform":{"type":"string","title":"Platform","description":"Platform to analyze. Use all when no single platform is required.","default":"all","examples":["all","x","instagram","tiktok"]}},"type":"object","required":["handle_or_hashtag"],"title":"SocialQuery","description":"Input for a social profile or hashtag analysis."},"SourceResponse":{"properties":{"status":{"type":"string","title":"Status"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sources"},"retrieved_at":{"type":"string","title":"Retrieved At"},"workflow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning"},"freshness":{"type":"string","title":"Freshness","default":"retrieved_at_request"},"verification_status":{"type":"string","title":"Verification Status","default":"source_backed"},"coverage":{"additionalProperties":true,"type":"object","title":"Coverage"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"next_actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Next Actions"}},"type":"object","required":["status","data","sources","retrieved_at"],"title":"SourceResponse"},"StateCompareQuery":{"properties":{"previous":{"title":"Previous"},"current":{"title":"Current"},"max_changed_paths":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Max Changed Paths","default":100}},"type":"object","required":["previous","current"],"title":"StateCompareQuery"},"SubjectRequest":{"properties":{"subject_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:-]+$","title":"Subject Id","description":"Stable pseudonymous identifier from the integrating application; never a name or email."}},"additionalProperties":false,"type":"object","required":["subject_id"],"title":"SubjectRequest"},"TenantCreate":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"TenantCreate"},"TreasuryQuery":{"properties":{"limit":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Limit","default":1}},"type":"object","title":"TreasuryQuery"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyQuery":{"properties":{"claim":{"type":"string","maxLength":2000,"minLength":1,"title":"Claim","description":"Claim or decision that needs evidence-quality checking."},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence","description":"An ILC response or evidence packet containing data and sources."},"required_source_types":{"items":{"type":"string"},"type":"array","title":"Required Source Types","description":"Optional source types that must be present."},"max_age_seconds":{"anyOf":[{"type":"integer","maximum":31536000.0,"minimum":1.0},{"type":"null"}],"title":"Max Age Seconds"}},"type":"object","required":["claim","evidence"],"title":"VerifyQuery"},"WeatherQuery":{"properties":{"location":{"type":"string","title":"Location","description":"US state code or latitude,longitude pair."},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","required":["location"],"title":"WeatherQuery"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}