{"openapi":"3.1.0","info":{"title":"Deal Rescue and Forecast Truth API","description":"A governed deal control plane that compares seller forecast with buyer evidence, classifies exact objections, tests commitment quality, and drafts an approval-bound rescue plan. The public deployment uses synthetic data and never mutates CRM or sends buyer communication.","version":"1.0.0"},"paths":{"/api/v1/health":{"get":{"tags":["system"],"summary":"Health","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/ready":{"get":{"tags":["system"],"summary":"Ready","operationId":"ready_api_v1_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyResponse"}}}}}}},"/api/v1/capabilities":{"get":{"tags":["system"],"summary":"Capabilities","operationId":"capabilities_api_v1_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}}}}},"/api/v1/scenarios":{"get":{"tags":["datasets"],"summary":"Scenarios","operationId":"scenarios_api_v1_scenarios_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ScenarioView"},"type":"array","title":"Response Scenarios Api V1 Scenarios Get"}}}}}}},"/api/v1/scenarios/{scenario_id}":{"get":{"tags":["datasets"],"summary":"Scenario Detail","operationId":"scenario_detail_api_v1_scenarios__scenario_id__get","parameters":[{"name":"scenario_id","in":"path","required":true,"schema":{"type":"string","title":"Scenario Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealBundle"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sessions":{"post":{"tags":["sessions"],"summary":"Create Session","operationId":"create_session_api_v1_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/deals/analyze":{"post":{"tags":["runs"],"summary":"Start Deal Analysis","operationId":"start_deal_analysis_api_v1_deals_analyze_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealRunRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}":{"get":{"tags":["runs"],"summary":"Get Run","operationId":"get_run_api_v1_runs__run_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/decisions":{"post":{"tags":["approvals"],"summary":"Decide Run","operationId":"decide_run_api_v1_runs__run_id__decisions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/audit":{"get":{"tags":["audit"],"summary":"Run Audit","operationId":"run_audit_api_v1_runs__run_id__audit_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditEventView"},"title":"Response Run Audit Api V1 Runs  Run Id  Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AgentStepView":{"properties":{"sequence":{"type":"integer","title":"Sequence"},"agent":{"type":"string","title":"Agent"},"status":{"type":"string","title":"Status"},"summary":{"type":"string","title":"Summary"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"},"duration_ms":{"type":"integer","title":"Duration Ms","default":0}},"type":"object","required":["sequence","agent","status","summary"],"title":"AgentStepView"},"AuditEventView":{"properties":{"sequence":{"type":"integer","title":"Sequence"},"event_type":{"type":"string","title":"Event Type"},"actor_type":{"type":"string","title":"Actor Type"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"previous_event_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Event Hash"},"event_hash":{"type":"string","title":"Event Hash"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["sequence","event_type","actor_type","payload","previous_event_hash","event_hash"],"title":"AuditEventView"},"CapabilitiesResponse":{"properties":{"product":{"type":"string","title":"Product"},"version":{"type":"string","title":"Version"},"modes":{"items":{"type":"string"},"type":"array","title":"Modes"},"agents":{"items":{"type":"string"},"type":"array","title":"Agents"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"checkpoint_mode":{"type":"string","enum":["ephemeral","local","durable"],"title":"Checkpoint Mode"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"},"external_mutations":{"type":"boolean","const":false,"title":"External Mutations","default":false}},"type":"object","required":["product","version","modes","agents","controls","checkpoint_mode","limits"],"title":"CapabilitiesResponse"},"ClaimView":{"properties":{"statement":{"type":"string","title":"Statement"},"claim_class":{"type":"string","enum":["observed","inferred","recommendation"],"title":"Claim Class"},"supported":{"type":"boolean","title":"Supported"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"},"limitation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Limitation"}},"type":"object","required":["statement","claim_class","supported"],"title":"ClaimView"},"DealActivity":{"properties":{"sequence":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Sequence"},"kind":{"type":"string","enum":["meeting","email","call","proposal","security_questionnaire","legal_redline","demo","other"],"title":"Kind"},"actor_side":{"type":"string","enum":["buyer","seller","system"],"title":"Actor Side"},"outcome":{"type":"string","enum":["scheduled","completed","cancelled","replied","no_reply","viewed","sent"],"title":"Outcome"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"summary":{"type":"string","maxLength":300,"minLength":2,"title":"Summary"},"source_hash":{"type":"string","maxLength":128,"minLength":8,"title":"Source Hash"}},"additionalProperties":false,"type":"object","required":["sequence","kind","actor_side","outcome","occurred_at","summary","source_hash"],"title":"DealActivity"},"DealBundle":{"properties":{"deal_name":{"type":"string","maxLength":160,"minLength":2,"title":"Deal Name"},"account_name":{"type":"string","maxLength":120,"minLength":2,"title":"Account Name"},"market":{"type":"string","maxLength":120,"minLength":2,"title":"Market"},"amount":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0,"title":"Amount"},"currency":{"type":"string","enum":["USD","GBP","EUR","AED","PKR"],"title":"Currency","default":"USD"},"stage":{"$ref":"#/components/schemas/DealStage"},"seller_forecast_category":{"$ref":"#/components/schemas/ForecastCategory"},"seller_probability":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Seller Probability"},"target_close_date":{"type":"string","format":"date","title":"Target Close Date"},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"},"days_in_stage":{"type":"integer","maximum":3650.0,"minimum":0.0,"title":"Days In Stage"},"last_buyer_activity_at":{"type":"string","format":"date-time","title":"Last Buyer Activity At"},"next_step":{"type":"string","maxLength":500,"minLength":2,"title":"Next Step"},"next_step_due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Step Due At"},"contact_count":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Contact Count"},"executive_contact_count":{"type":"integer","maximum":30.0,"minimum":0.0,"title":"Executive Contact Count"},"competitors":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Competitors"},"source_systems":{"items":{"type":"string"},"type":"array","maxItems":12,"minItems":2,"title":"Source Systems"},"crm_source_hash":{"type":"string","maxLength":128,"minLength":8,"title":"Crm Source Hash"},"transcript":{"items":{"$ref":"#/components/schemas/TranscriptTurn"},"type":"array","maxItems":300,"minItems":2,"title":"Transcript"},"activities":{"items":{"$ref":"#/components/schemas/DealActivity"},"type":"array","maxItems":200,"minItems":1,"title":"Activities"},"buyer_consent_to_analyze":{"type":"boolean","title":"Buyer Consent To Analyze","default":true},"data_classification":{"type":"string","const":"synthetic","title":"Data Classification","default":"synthetic"}},"additionalProperties":false,"type":"object","required":["deal_name","account_name","market","amount","stage","seller_forecast_category","seller_probability","target_close_date","analysis_date","days_in_stage","last_buyer_activity_at","next_step","contact_count","executive_contact_count","source_systems","crm_source_hash","transcript","activities"],"title":"DealBundle"},"DealOverrides":{"properties":{"amount":{"anyOf":[{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Amount"},"stage":{"anyOf":[{"$ref":"#/components/schemas/DealStage"},{"type":"null"}]},"seller_forecast_category":{"anyOf":[{"$ref":"#/components/schemas/ForecastCategory"},{"type":"null"}]},"seller_probability":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Seller Probability"},"contact_count":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Contact Count"},"executive_contact_count":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":0.0},{"type":"null"}],"title":"Executive Contact Count"},"next_step":{"anyOf":[{"type":"string","maxLength":500,"minLength":2},{"type":"null"}],"title":"Next Step"},"clear_next_step_date":{"type":"boolean","title":"Clear Next Step Date","default":false},"days_since_buyer_activity":{"anyOf":[{"type":"integer","maximum":180.0,"minimum":0.0},{"type":"null"}],"title":"Days Since Buyer Activity"},"buyer_statement":{"anyOf":[{"type":"string","maxLength":1200,"minLength":10},{"type":"null"}],"title":"Buyer Statement"}},"additionalProperties":false,"type":"object","title":"DealOverrides"},"DealRunRequest":{"properties":{"scenario":{"type":"string","maxLength":120,"minLength":2,"title":"Scenario","default":"true_commit"},"mode":{"$ref":"#/components/schemas/RunMode","default":"replay"},"analysis_horizon_days":{"type":"integer","enum":[14,30,60,90],"title":"Analysis Horizon Days","default":30},"requested_action":{"type":"string","enum":["review_only","draft_rescue_plan"],"title":"Requested Action","default":"draft_rescue_plan"},"deal":{"anyOf":[{"$ref":"#/components/schemas/DealBundle"},{"type":"null"}]},"overrides":{"anyOf":[{"$ref":"#/components/schemas/DealOverrides"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"DealRunRequest"},"DealStage":{"type":"string","enum":["discovery","evaluation","solution_fit","proposal","negotiation","legal_security","procurement","closed_won","closed_lost"],"title":"DealStage"},"DecisionRequest":{"properties":{"decision":{"type":"string","enum":["approve","reject"],"title":"Decision"},"reason":{"type":"string","maxLength":1000,"minLength":3,"title":"Reason"},"run_receipt":{"anyOf":[{"type":"string","maxLength":250000},{"type":"null"}],"title":"Run Receipt"}},"additionalProperties":false,"type":"object","required":["decision","reason"],"title":"DecisionRequest"},"DemoSessionRequest":{"properties":{"workspace_name":{"type":"string","maxLength":80,"minLength":2,"title":"Workspace Name","default":"Portfolio visitor"},"persona":{"type":"string","enum":["reviewer","sales_manager","revenue_leader"],"title":"Persona","default":"sales_manager"}},"additionalProperties":false,"type":"object","title":"DemoSessionRequest"},"DemoSessionResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","const":"bearer","title":"Token Type","default":"bearer"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"tenant_id":{"type":"string","format":"uuid","title":"Tenant Id"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"}},"type":"object","required":["access_token","expires_at","tenant_id","limits"],"title":"DemoSessionResponse"},"EvidenceView":{"properties":{"id":{"type":"string","title":"Id"},"source_type":{"type":"string","enum":["crm","transcript","activity"],"title":"Source Type"},"locator":{"type":"string","title":"Locator"},"source_hash":{"type":"string","title":"Source Hash"},"excerpt":{"type":"string","title":"Excerpt"},"speaker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Speaker"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"}},"type":"object","required":["id","source_type","locator","source_hash","excerpt"],"title":"EvidenceView"},"FindingView":{"properties":{"code":{"type":"string","title":"Code"},"category":{"type":"string","title":"Category"},"severity":{"type":"string","enum":["low","medium","high","critical","blocking"],"title":"Severity"},"title":{"type":"string","title":"Title"},"detail":{"type":"string","title":"Detail"},"observed_value":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Observed Value"},"threshold":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Threshold"},"amount_at_risk":{"type":"number","title":"Amount At Risk","default":0},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"owner":{"type":"string","title":"Owner"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"}},"type":"object","required":["code","category","severity","title","detail","confidence","owner"],"title":"FindingView"},"ForecastCategory":{"type":"string","enum":["omitted","pipeline","best_case","commit"],"title":"ForecastCategory"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","enum":["ok","degraded"],"title":"Status"},"service":{"type":"string","title":"Service"},"version":{"type":"string","title":"Version"}},"type":"object","required":["status","service","version"],"title":"HealthResponse"},"ObjectionView":{"properties":{"code":{"type":"string","title":"Code"},"taxonomy":{"type":"string","enum":["budget","authority","security","legal","integration","competition","timing","no_decision","value"],"title":"Taxonomy"},"severity":{"type":"string","enum":["low","medium","high","critical"],"title":"Severity"},"status":{"type":"string","enum":["unresolved","partially_resolved","resolved"],"title":"Status"},"buyer_language":{"type":"string","title":"Buyer Language"},"response_gap":{"type":"string","title":"Response Gap"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"}},"type":"object","required":["code","taxonomy","severity","status","buyer_language","response_gap"],"title":"ObjectionView"},"ProposalView":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id"},"action_type":{"type":"string","title":"Action Type"},"actions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Actions"},"reasoning":{"type":"string","title":"Reasoning"},"confidence":{"type":"number","title":"Confidence"},"required_approver":{"type":"string","title":"Required Approver"},"state":{"type":"string","title":"State"},"external_mutation":{"type":"boolean","const":false,"title":"External Mutation","default":false}},"type":"object","required":["action_type","actions","reasoning","confidence","required_approver","state"],"title":"ProposalView"},"ReadyResponse":{"properties":{"status":{"type":"string","enum":["ready","not_ready"],"title":"Status"},"checks":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Checks"}},"type":"object","required":["status","checks"],"title":"ReadyResponse"},"RunMode":{"type":"string","enum":["replay","live"],"title":"RunMode"},"RunStatus":{"type":"string","enum":["running","data_blocked","awaiting_approval","approved","rejected","completed","failed"],"title":"RunStatus"},"RunView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"status":{"$ref":"#/components/schemas/RunStatus"},"mode":{"$ref":"#/components/schemas/RunMode"},"scenario":{"type":"string","title":"Scenario"},"trace_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trace Id"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"analysis_horizon_days":{"type":"integer","title":"Analysis Horizon Days"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"evidence":{"items":{"$ref":"#/components/schemas/EvidenceView"},"type":"array","title":"Evidence"},"findings":{"items":{"$ref":"#/components/schemas/FindingView"},"type":"array","title":"Findings"},"objections":{"items":{"$ref":"#/components/schemas/ObjectionView"},"type":"array","title":"Objections"},"claims":{"items":{"$ref":"#/components/schemas/ClaimView"},"type":"array","title":"Claims"},"steps":{"items":{"$ref":"#/components/schemas/AgentStepView"},"type":"array","title":"Steps"},"proposal":{"anyOf":[{"$ref":"#/components/schemas/ProposalView"},{"type":"null"}]},"policy_review":{"additionalProperties":true,"type":"object","title":"Policy Review"},"usage":{"additionalProperties":true,"type":"object","title":"Usage"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"run_receipt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Receipt"}},"type":"object","required":["id","status","mode","scenario","trace_id","started_at","completed_at","analysis_horizon_days"],"title":"RunView"},"ScenarioView":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"brief":{"type":"string","title":"Brief"},"expected_top_finding":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Top Finding"},"expected_forecast":{"$ref":"#/components/schemas/ForecastCategory"}},"type":"object","required":["id","label","brief","expected_top_finding","expected_forecast"],"title":"ScenarioView"},"SpeakerRole":{"type":"string","enum":["seller","buyer","executive","procurement","legal_security","unknown"],"title":"SpeakerRole"},"TranscriptTurn":{"properties":{"sequence":{"type":"integer","maximum":300.0,"minimum":1.0,"title":"Sequence"},"speaker":{"type":"string","maxLength":80,"minLength":2,"title":"Speaker"},"role":{"$ref":"#/components/schemas/SpeakerRole"},"started_at_seconds":{"type":"number","maximum":28800.0,"minimum":0.0,"title":"Started At Seconds"},"text":{"type":"string","maxLength":1200,"minLength":2,"title":"Text"},"source_hash":{"type":"string","maxLength":128,"minLength":8,"title":"Source Hash"}},"additionalProperties":false,"type":"object","required":["sequence","speaker","role","started_at_seconds","text","source_hash"],"title":"TranscriptTurn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}