{"openapi":"3.1.0","info":{"title":"Admit Coach Agentic OS","version":"5.3.0-gemini-3.7"},"paths":{"/api/login":{"post":{"summary":"Login","operationId":"login_api_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/register":{"post":{"summary":"Register","operationId":"register_api_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/verify":{"get":{"summary":"Verify Email","operationId":"verify_email_api_auth_verify_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/forgot-password":{"post":{"summary":"Forgot Password","operationId":"forgot_password_api_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/reset-password":{"post":{"summary":"Reset Password","operationId":"reset_password_api_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/providers":{"get":{"summary":"Auth Providers","description":"Return which OAuth providers are configured (for frontend button visibility).","operationId":"auth_providers_api_auth_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/google":{"get":{"summary":"Auth Google","operationId":"auth_google_api_auth_google_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/google/callback":{"get":{"summary":"Auth Google Callback","operationId":"auth_google_callback_api_auth_google_callback_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/microsoft":{"get":{"summary":"Auth Microsoft","operationId":"auth_microsoft_api_auth_microsoft_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/microsoft/callback":{"get":{"summary":"Auth Microsoft Callback","operationId":"auth_microsoft_callback_api_auth_microsoft_callback_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/apple":{"get":{"summary":"Auth Apple","operationId":"auth_apple_api_auth_apple_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/apple/callback":{"post":{"summary":"Auth Apple Callback","description":"Apple sends callback as POST with form_post response mode.","operationId":"auth_apple_callback_api_auth_apple_callback_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connector/chatgpt/create-session":{"post":{"summary":"Chatgpt Create Session","description":"Called by a ChatGPT Custom GPT Action to store a conversation and get a registration link.","operationId":"chatgpt_create_session_api_connector_chatgpt_create_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGPTSessionCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/connector/chatgpt/validate-session":{"get":{"summary":"Chatgpt Validate Session","description":"Validate a ChatGPT session key and return pre-fill data for registration.","operationId":"chatgpt_validate_session_api_connector_chatgpt_validate_session_get","parameters":[{"name":"key","in":"query","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/connector/chatgpt/start-session/{handoff_code}":{"get":{"summary":"Chatgpt Start Session","description":"Set a short-lived HttpOnly ChatGPT handoff cookie, then redirect to the app.","operationId":"chatgpt_start_session_api_connector_chatgpt_start_session__handoff_code__get","parameters":[{"name":"handoff_code","in":"path","required":true,"schema":{"type":"string","title":"Handoff Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/connector/chatgpt/bootstrap-session":{"get":{"summary":"Chatgpt Bootstrap Session","description":"Validate a ChatGPT handoff cookie without exposing the handoff secret to JavaScript.","operationId":"chatgpt_bootstrap_session_api_connector_chatgpt_bootstrap_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/register/chatgpt":{"post":{"summary":"Register Chatgpt","description":"Register a new user via a ChatGPT session key, importing conversation and profile.","operationId":"register_chatgpt_api_register_chatgpt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGPTRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/profile":{"get":{"summary":"Get Profile","operationId":"get_profile_api_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"patch":{"summary":"Update Profile","operationId":"update_profile_api_profile_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/profile/export":{"get":{"summary":"Export Student Data","description":"Export all student data in a single JSON payload (FERPA right of access).","operationId":"export_student_data_api_profile_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/export":{"get":{"summary":"Export Student Data","description":"Export all student data in a single JSON payload (FERPA right of access).","operationId":"export_student_data_api_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/logout":{"post":{"summary":"Logout","description":"Revoke the current JWT token.","operationId":"logout_api_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/audit-log":{"get":{"summary":"Get Audit Log","description":"Return recent audit log entries for the requesting user's actions.","operationId":"get_audit_log_api_audit_log_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/universities":{"get":{"summary":"Search Universities","operationId":"search_universities_api_universities_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","default":"","title":"Search"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"control","in":"query","required":false,"schema":{"type":"string","default":"","title":"Control"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"min_acceptance","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Acceptance"}},{"name":"max_acceptance","in":"query","required":false,"schema":{"type":"number","default":100,"title":"Max Acceptance"}},{"name":"athletic_division","in":"query","required":false,"schema":{"type":"string","default":"","title":"Athletic Division"}},{"name":"sport","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sport"}},{"name":"accreditation","in":"query","required":false,"schema":{"type":"string","default":"","title":"Accreditation"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/universities/by-major":{"get":{"summary":"Search By Major","description":"Search universities that offer a specific major.","operationId":"search_by_major_api_universities_by_major_get","parameters":[{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"control","in":"query","required":false,"schema":{"type":"string","default":"","title":"Control"}},{"name":"min_acceptance","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Acceptance"}},{"name":"max_acceptance","in":"query","required":false,"schema":{"type":"number","default":100,"title":"Max Acceptance"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/universities/{unitid}":{"get":{"summary":"Get University","operationId":"get_university_api_universities__unitid__get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/athletics/search":{"get":{"summary":"Athletics Search","description":"Search schools by athletic division, conference, or sport.\nUses ncaa_sponsored_sports for accurate per-sport filtering with head coaches.","operationId":"athletics_search_api_athletics_search_get","parameters":[{"name":"division","in":"query","required":false,"schema":{"type":"string","default":"","title":"Division"}},{"name":"conference","in":"query","required":false,"schema":{"type":"string","default":"","title":"Conference"}},{"name":"sport","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sport"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/accreditations/search":{"get":{"summary":"Accreditations Search","description":"Search accredited programs (ABET, NASM, AACSB, CCNE, ACEN, NAST, NASD).","operationId":"accreditations_search_api_accreditations_search_get","parameters":[{"name":"accreditation_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Accreditation Type"}},{"name":"program","in":"query","required":false,"schema":{"type":"string","default":"","title":"Program"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/data-sources":{"get":{"summary":"Data Sources","description":"Return metadata about all data sources powering the platform.","operationId":"data_sources_api_data_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/match-score":{"get":{"summary":"Match Score","description":"Compute Reach/Target/Safety tier for a school given the current user's profile.","operationId":"match_score_api_match_score_get","parameters":[{"name":"unitid","in":"query","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/compare":{"get":{"summary":"Compare Universities","operationId":"compare_universities_api_compare_get","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated unitids (2-5)","title":"Ids"},"description":"Comma-separated unitids (2-5)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/dashboard/stats":{"get":{"summary":"Dashboard Stats","operationId":"dashboard_stats_api_dashboard_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/college-list":{"get":{"summary":"Get College List","operationId":"get_college_list_api_college_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Add To College List","operationId":"add_to_college_list_api_college_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeListItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/college-list/{unitid}":{"patch":{"summary":"Update College List Item","operationId":"update_college_list_item_api_college_list__unitid__patch","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeListUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Remove From College List","operationId":"remove_from_college_list_api_college_list__unitid__delete","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chancing/{unitid}":{"get":{"summary":"Chancing","description":"Holistic admission chance estimator.\nFactors: GPA, SAT/ACT, extracurriculars, essays, demographics, school-specific data.\nMore nuanced than simple GPA/SAT comparison.","operationId":"chancing_api_chancing__unitid__get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/universities/{unitid}/similar":{"get":{"summary":"Similar Schools","description":"Find schools similar to the given one based on selectivity, academic focus, size, and cost.\nUses major overlap and Carnegie classification alongside acceptance rate and SAT.","operationId":"similar_schools_api_universities__unitid__similar_get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":6,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/majors/list":{"get":{"summary":"List Popular Majors","description":"Return popular major names for filter dropdown.","operationId":"list_popular_majors_api_majors_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/sports/list":{"get":{"summary":"List Sports","description":"Return NCAA sports with school counts for filter dropdown.","operationId":"list_sports_api_sports_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/simulate-chances":{"get":{"summary":"Chancing Simulate","description":"Simulate admission chances for all list schools with custom GPA/SAT/ACT.\nInspired by Scoir's admission simulator and collegecalculator ML approach.","operationId":"chancing_simulate_api_simulate_chances_get","parameters":[{"name":"gpa","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Gpa"}},{"name":"sat","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Sat"}},{"name":"act","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Act"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/college-list/balance":{"get":{"summary":"College List Balance","description":"Grade the college list on reach/target/safety balance and suggest fixes.\nInspired by Scoir's Balanced List Scores and College Kickstart MixFixer.","operationId":"college_list_balance_api_college_list_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/test-optional/advice":{"get":{"summary":"Test Optional Advice","description":"For each school on user's list, recommend whether to submit test scores.\nCompares student scores against school's 25th/50th/75th percentiles.\nInspired by College Kickstart's test-optional guidance.","operationId":"test_optional_advice_api_test_optional_advice_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/counseling/tracks":{"get":{"summary":"Counseling Tracks","description":"Return counseling tracks with personalized completion status based on user data.","operationId":"counseling_tracks_api_counseling_tracks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/counseling/checklist":{"get":{"summary":"Counseling Checklist","description":"Per-school application checklist with real deadlines, requirements, and completion status.","operationId":"counseling_checklist_api_counseling_checklist_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/counseling/financial-strategy":{"get":{"summary":"Counseling Financial Strategy","description":"Structured financial aid strategy across all schools — need-blind, merit, CSS, net price by income.","operationId":"counseling_financial_strategy_api_counseling_financial_strategy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/counseling/career-roi":{"get":{"summary":"Counseling Career Roi","description":"Career ROI analysis — earnings, debt-to-income, program-level outcomes.","operationId":"counseling_career_roi_api_counseling_career_roi_get","parameters":[{"name":"unitid","in":"query","required":false,"schema":{"type":"string","default":"","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/campus-fit":{"get":{"summary":"Counseling Campus Fit","description":"Campus fit discovery — match student preferences to real school data.","operationId":"counseling_campus_fit_api_counseling_campus_fit_get","parameters":[{"name":"size","in":"query","required":false,"schema":{"type":"string","default":"","title":"Size"}},{"name":"setting","in":"query","required":false,"schema":{"type":"string","default":"","title":"Setting"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"climate","in":"query","required":false,"schema":{"type":"string","default":"","title":"Climate"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"greek_life","in":"query","required":false,"schema":{"type":"string","default":"","title":"Greek Life"}},{"name":"study_abroad","in":"query","required":false,"schema":{"type":"string","default":"","title":"Study Abroad"}},{"name":"research","in":"query","required":false,"schema":{"type":"string","default":"","title":"Research"}},{"name":"coop_internship","in":"query","required":false,"schema":{"type":"string","default":"","title":"Coop Internship"}},{"name":"honors","in":"query","required":false,"schema":{"type":"string","default":"","title":"Honors"}},{"name":"max_acceptance","in":"query","required":false,"schema":{"type":"number","default":100,"title":"Max Acceptance"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","default":15,"title":"Max Results"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/equity-report/{unitid}":{"get":{"summary":"Counseling Equity Report","description":"Equity & outcomes report — graduation rates by race, Pell gap, diversity, income.","operationId":"counseling_equity_report_api_counseling_equity_report__unitid__get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/rec-letter":{"post":{"summary":"Draft Rec Letter","description":"Generate a personalized recommendation letter draft using AI.\nInspired by CollegeVine's AI rec letter assistant and aiforeducation.io templates.","operationId":"draft_rec_letter_api_counseling_rec_letter_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/essay-audit":{"post":{"summary":"Essay Humanizer Audit","description":"Audit an essay draft using the 5-Layer Academic Humanizer protocol.\nScans for AI clichés (delve, tapestry, etc.), formulaic openers, em-dashes,\nand returns a 5-dimension rubric score with line-by-line revision steps.","operationId":"essay_humanizer_audit_api_counseling_essay_audit_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/list-health":{"get":{"summary":"List Health Score","description":"Calculate the 0-100 College List Health Index evaluating portfolio balance\nacross Reach, Target, and Safety schools with risk flags and recommendations.","operationId":"list_health_score_api_counseling_list_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/counseling/reverse-chance":{"get":{"summary":"Reverse Chance Endpoint","description":"Reverse Chance Me simulator that categorizes matching schools into\nReach/Target/Safety and computes 'What-If' stat sensitivity levers.","operationId":"reverse_chance_endpoint_api_counseling_reverse_chance_get","parameters":[{"name":"gpa","in":"query","required":false,"schema":{"type":"number","default":3.7,"title":"Gpa"}},{"name":"sat","in":"query","required":false,"schema":{"type":"integer","default":1350,"title":"Sat"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/action-plan":{"get":{"summary":"Adhd Action Plan Endpoint","description":"Generate an ADHD-optimized, action-first micro-step application roadmap\nwith concrete time estimates and a 2-minute quick win.","operationId":"adhd_action_plan_endpoint_api_counseling_action_plan_get","parameters":[{"name":"grade","in":"query","required":false,"schema":{"type":"string","default":"12th","title":"Grade"}},{"name":"priority","in":"query","required":false,"schema":{"type":"string","default":"college_list","title":"Priority"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/sentence-surgeon":{"post":{"summary":"Sentence Surgeon Endpoint","description":"Analyze an essay sentence flagged for AI clichés or abstract nouns\nand return 3 authentic, humanized rewrite options (Action, Sensory, Scale).","operationId":"sentence_surgeon_endpoint_api_counseling_sentence_surgeon_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/activity-compressor":{"post":{"summary":"Activity Compressor Endpoint","description":"Compress extracurricular notes into high-impact Common App descriptions\nstrictly respecting the 150-character limit with active verbs and metrics.","operationId":"activity_compressor_endpoint_api_counseling_activity_compressor_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/why-us-intel":{"get":{"summary":"Why Us Intel Endpoint","description":"Generate hyper-specific 'Why This College?' intelligence from real IPEDS and Scorecard data\nto help students avoid generic essays.","operationId":"why_us_intel_endpoint_api_counseling_why_us_intel_get","parameters":[{"name":"university","in":"query","required":true,"schema":{"type":"string","title":"University"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/major-chancing":{"get":{"summary":"Major Chancing Endpoint","description":"Calculate major-specific competitiveness multipliers and capped program risk advisories.","operationId":"major_chancing_endpoint_api_counseling_major_chancing_get","parameters":[{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"university","in":"query","required":false,"schema":{"type":"string","default":"","title":"University"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/supplemental-prompts":{"get":{"summary":"Supplemental Prompts Endpoint","description":"Retrieve structured supplemental essay prompts, word count limits, and drafting advice.","operationId":"supplemental_prompts_endpoint_api_counseling_supplemental_prompts_get","parameters":[{"name":"university","in":"query","required":true,"schema":{"type":"string","title":"University"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/ed-boost":{"post":{"summary":"Ed Boost Endpoint","description":"Evaluate Early Decision vs Regular Decision statistical boost and financial risk.","operationId":"ed_boost_endpoint_api_counseling_ed_boost_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/activity-tier-rank":{"post":{"summary":"Activity Tier Rank Endpoint","description":"Audit and tier-rank student extracurricular activities (Tiers 1-4) and sequence for Common App.","operationId":"activity_tier_rank_endpoint_api_counseling_activity_tier_rank_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/counseling/appeal-letter":{"post":{"summary":"Appeal Letter Endpoint","description":"Generate a formal, respectful, data-backed financial aid appeal letter.\nOmitted fields become bracketed placeholders — the letter never invents\nhardship claims or competing offers the family did not report.","operationId":"appeal_letter_endpoint_api_counseling_appeal_letter_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/universities/{unitid}/selectivity-trend":{"get":{"summary":"Selectivity Trend","description":"Return historical acceptance rate trend data for a university.\nUses available data to show year-over-year selectivity changes.","operationId":"selectivity_trend_api_universities__unitid__selectivity_trend_get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/applications/requirements":{"get":{"summary":"Application Requirements","description":"Return per-school requirements for all tracked applications.","operationId":"application_requirements_api_applications_requirements_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/applications/calendar":{"get":{"summary":"Application Calendar","description":"Return all deadlines as calendar events for tracked applications.","operationId":"application_calendar_api_applications_calendar_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/deadline-reminders":{"get":{"summary":"Get Deadline Reminders","description":"Return ALL deadlines (past and future) for schools on the user's college list.","operationId":"get_deadline_reminders_api_deadline_reminders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/deadline-reminders/send-email":{"post":{"summary":"Send Deadline Reminder Email","description":"Send a summary email of upcoming deadlines to the current user.","operationId":"send_deadline_reminder_email_api_deadline_reminders_send_email_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/applications/essay-matrix":{"get":{"summary":"Essay Matrix","description":"Show essay requirements across all tracked schools for recycling opportunities.","operationId":"essay_matrix_api_applications_essay_matrix_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/applications":{"get":{"summary":"List Applications","operationId":"list_applications_api_applications_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Create Application","operationId":"create_application_api_applications_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/applications/{app_id}":{"patch":{"summary":"Update Application","operationId":"update_application_api_applications__app_id__patch","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"integer","title":"App Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Application","operationId":"delete_application_api_applications__app_id__delete","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"integer","title":"App Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/decisions/compare":{"get":{"summary":"Decisions Compare","description":"Return enriched data for all schools where the user has received a decision.","operationId":"decisions_compare_api_decisions_compare_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/timeline":{"get":{"summary":"Get Timeline","description":"Return comprehensive strategic timeline for Fall 2027 application cycle.\nAlways returns system milestones. If authenticated, also includes\nschool-specific deadlines from the user's college list.","operationId":"get_timeline_api_timeline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/scholarships":{"get":{"summary":"Get Scholarships","operationId":"get_scholarships_api_scholarships_get","parameters":[{"name":"income_bracket","in":"query","required":false,"schema":{"type":"string","default":"","title":"Income Bracket"}},{"name":"family_income_bracket","in":"query","required":false,"schema":{"type":"string","default":"","title":"Family Income Bracket"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":15,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/briefing":{"get":{"summary":"Agent Briefing","description":"Generate personalized dashboard insights using the agent.","operationId":"agent_briefing_api_agent_briefing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/essay/generate":{"post":{"summary":"Generate Essay Prompt","description":"Use the agent to generate an essay prompt/outline for a university.","operationId":"generate_essay_prompt_api_essay_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EssayRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/sessions":{"get":{"summary":"List Sessions","description":"List all chat sessions for the current user, most recent first.","operationId":"list_sessions_api_agent_sessions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/sessions/{session_id}":{"get":{"summary":"Get Session Messages","description":"Load full messages for a specific session.","operationId":"get_session_messages_api_agent_sessions__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/chat":{"post":{"summary":"Agent Chat","operationId":"agent_chat_api_agent_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/stream":{"get":{"summary":"Agent Stream","description":"SSE streaming version for real-time agent responses.","operationId":"agent_stream_api_agent_stream_get","parameters":[{"name":"message","in":"query","required":true,"schema":{"type":"string","title":"Message"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/compliance/check":{"get":{"summary":"Compliance Check","description":"Run automated FERPA + SOC2 compliance checks and return a detailed checklist.\nEach item is verified at runtime, not just declared. Requires authentication.","operationId":"compliance_check_api_compliance_check_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/outcomes/report":{"post":{"summary":"Report Outcome","description":"Report an admission outcome for crowdsourced scattergrams.","operationId":"report_outcome_api_outcomes_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportOutcomeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/outcomes/scattergram/{unitid}":{"get":{"summary":"Get Scattergram","description":"Return crowdsourced scattergram data for a university.","operationId":"get_scattergram_api_outcomes_scattergram__unitid__get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/scholarships/search":{"get":{"summary":"Scholarship Search","description":"Search scholarships with auto-matching from user profile.","operationId":"scholarship_search_api_scholarships_search_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"min_gpa","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Gpa"}},{"name":"max_income","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Max Income"}},{"name":"keyword","in":"query","required":false,"schema":{"type":"string","default":"","title":"Keyword"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/scholarships/seed":{"post":{"summary":"Seed Scholarships","description":"Seed the scholarships database with common national scholarships.\nAdmin-only in production; useful for bootstrapping.","operationId":"seed_scholarships_api_scholarships_seed_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/action-center":{"get":{"summary":"Action Center","description":"Returns urgent action items: deadline alerts, missing essays/recs, list warnings.","operationId":"action_center_api_action_center_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/affordability":{"get":{"summary":"Affordability","description":"Return net price estimates for every school on the student's list.","operationId":"affordability_api_affordability_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/onboarding-progress":{"get":{"summary":"Onboarding Progress","description":"Return onboarding completion steps for the current user.","operationId":"onboarding_progress_api_onboarding_progress_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/onboarding/quick-start":{"post":{"summary":"Onboarding Quick Start","description":"Step 1-2 of onboarding: save profile + find initial school matches.\nAccepts: grade, gpa, sat, act, desired_major, state, preferences (size, setting, interests).","operationId":"onboarding_quick_start_api_onboarding_quick_start_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/onboarding/add-suggestions":{"post":{"summary":"Onboarding Add Suggestions","description":"Step 3: Add selected schools from wizard to college list.","operationId":"onboarding_add_suggestions_api_onboarding_add_suggestions_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications":{"get":{"summary":"Smart Notifications","description":"Enhanced notification system: deadlines, essay nudges, test advice, FAFSA reminders.","operationId":"smart_notifications_api_notifications_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/essay-portfolio":{"get":{"summary":"Essay Portfolio","description":"Comprehensive essay portfolio view: prompts per school, drafts, recycling opportunities, word counts.","operationId":"essay_portfolio_api_essay_portfolio_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/universities":{"get":{"summary":"Public Search Universities","description":"Search universities — no authentication required. For AI agents and integrations.","operationId":"public_search_universities_api_public_universities_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}},{"name":"min_acceptance","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Acceptance"}},{"name":"max_acceptance","in":"query","required":false,"schema":{"type":"number","default":100,"title":"Max Acceptance"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/universities/{unitid}":{"get":{"summary":"Public Get University","description":"Get detailed university info — no authentication required.","operationId":"public_get_university_api_public_universities__unitid__get","parameters":[{"name":"unitid","in":"path","required":true,"schema":{"type":"string","title":"Unitid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/chance-demo":{"get":{"summary":"Public Chance Demo Api","description":"No-login reach/target/safety sample list for the public calculator.","operationId":"public_chance_demo_api_api_public_chance_demo_get","parameters":[{"name":"gpa","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Gpa"}},{"name":"sat","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Sat"}},{"name":"act","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Act"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/stats":{"get":{"summary":"Public Stats","description":"Aggregate university statistics — no authentication required.","operationId":"public_stats_api_public_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/docs":{"get":{"summary":"Public Api Docs","description":"Documentation page for the public API.","operationId":"public_api_docs_api_public_docs_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/indexnow.txt":{"get":{"summary":"Indexnow Txt","description":"IndexNow key verification file for Bing and other participating engines.","operationId":"indexnow_txt_indexnow_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/eff3e031ddbae5602dc4dd111bfa00df.txt":{"get":{"summary":"Indexnow Key Txt","description":"IndexNow root key file location.","operationId":"indexnow_key_txt_eff3e031ddbae5602dc4dd111bfa00df_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","description":"LLMs.txt — structured file for AI crawler discovery (llmstxt.org spec).","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"summary":"Llms Full Txt","description":"llms-full.txt — self-contained markdown with all content inlined for AI agents.","operationId":"llms_full_txt_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/mcp-registry-auth":{"get":{"summary":"Mcp Registry Auth","description":"MCP Registry domain verification for publishing to registry.modelcontextprotocol.io.","operationId":"mcp_registry_auth__well_known_mcp_registry_auth_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/security.txt":{"get":{"summary":"Security Txt","description":"Security.txt — trust signal for search engines and security researchers.","operationId":"security_txt__well_known_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap Xml","description":"Sitemap index pointing to sub-sitemaps.","operationId":"sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/feed.xml":{"get":{"summary":"Feed Xml","description":"RSS feed for search engines, Bing/IndexNow-style discovery, and AI/news readers.","operationId":"feed_xml_feed_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap-pages.xml":{"get":{"summary":"Sitemap Pages","operationId":"sitemap_pages_sitemap_pages_xml_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/sitemap-universities.xml":{"get":{"summary":"Sitemap Universities","description":"Sitemap with all 3,500+ university pages.","operationId":"sitemap_universities_sitemap_universities_xml_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/about":{"get":{"summary":"About Page","description":"Public about page — SEO optimized.","operationId":"about_page_about_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/compare":{"get":{"summary":"Compare Page","description":"Comparison page — SEO for 'Admit Coach vs' queries.","operationId":"compare_page_compare_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/mcp-server":{"get":{"summary":"Mcp Server Page","description":"Human landing page for the MCP endpoint. Search engines, AI assistants,\nand MCP directories link straight to /mcp/sse, where a human hits a bare\n401 — this page converts that demonstrated traffic into connections.","operationId":"mcp_server_page_mcp_server_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/faq":{"get":{"summary":"Faq Page","description":"FAQ page — targets AI search engines and long-tail queries.","operationId":"faq_page_faq_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges":{"get":{"summary":"Test Optional Page","operationId":"test_optional_page_test_optional_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-low-gpa":{"get":{"summary":"Low Gpa Page","operationId":"low_gpa_page_colleges_for_low_gpa_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-high-sat":{"get":{"summary":"High Sat Page","operationId":"high_sat_page_colleges_for_high_sat_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-colleges-for-engineering":{"get":{"summary":"Engineering Page","operationId":"engineering_page_best_colleges_for_engineering_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-colleges-for-business":{"get":{"summary":"Business Page","operationId":"business_page_best_colleges_for_business_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-colleges-for-nursing":{"get":{"summary":"Nursing Page","operationId":"nursing_page_best_colleges_for_nursing_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/affordable-colleges":{"get":{"summary":"Affordable Page","operationId":"affordable_page_affordable_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-colleges-for-computer-science":{"get":{"summary":"Computer Science Page","operationId":"computer_science_page_best_colleges_for_computer_science_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-value-colleges":{"get":{"summary":"Best Value Page","operationId":"best_value_page_best_value_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-with-highest-graduation-rates":{"get":{"summary":"High Grad Rate Page","operationId":"high_grad_rate_page_colleges_with_highest_graduation_rates_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/easiest-colleges-to-get-into":{"get":{"summary":"Easy Admission Page","operationId":"easy_admission_page_easiest_colleges_to_get_into_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-with-no-application-fee":{"get":{"summary":"No App Fee Page","operationId":"no_app_fee_page_colleges_with_no_application_fee_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/hbcu-colleges":{"get":{"summary":"Hbcu Page","operationId":"hbcu_page_hbcu_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-colleges-for-psychology":{"get":{"summary":"Psychology Page","operationId":"psychology_page_best_colleges_for_psychology_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/how-admission-chances-work":{"get":{"summary":"How Chances Work Page","description":"Citable methodology page — explains how admission chances are computed.\nA cleaner, sourced, dated target for AI 'chance me' queries than forum UGC.","operationId":"how_chances_work_page_how_admission_chances_work_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-in-{state_slug}":{"get":{"summary":"State Colleges Page","description":"Programmatic 'colleges in {state}' landing page — real lists + facts + FAQ,\nall from IPEDS data already in the DB.","operationId":"state_colleges_page_colleges_in__state_slug__get","parameters":[{"name":"state_slug","in":"path","required":true,"schema":{"type":"string","title":"State Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/glossary/acceptance-rate":{"get":{"summary":"Glossary Acceptance Rate","operationId":"glossary_acceptance_rate_glossary_acceptance_rate_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/glossary/reach-target-safety":{"get":{"summary":"Glossary Reach Target Safety","operationId":"glossary_reach_target_safety_glossary_reach_target_safety_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/glossary/ipeds":{"get":{"summary":"Glossary Ipeds","operationId":"glossary_ipeds_glossary_ipeds_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/glossary/early-decision-vs-early-action":{"get":{"summary":"Glossary Ed Vs Ea","operationId":"glossary_ed_vs_ea_glossary_early_decision_vs_early_action_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/glossary/net-price":{"get":{"summary":"Glossary Net Price","operationId":"glossary_net_price_glossary_net_price_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/guides/college-application-timeline":{"get":{"summary":"Guide Application Timeline","operationId":"guide_application_timeline_guides_college_application_timeline_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/guides/how-to-write-college-essay":{"get":{"summary":"Guide College Essay","operationId":"guide_college_essay_guides_how_to_write_college_essay_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/guides/financial-aid-letter":{"get":{"summary":"Guide Financial Aid Letter","operationId":"guide_financial_aid_letter_guides_financial_aid_letter_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/guides/how-many-colleges-to-apply":{"get":{"summary":"Guide How Many Colleges","operationId":"guide_how_many_colleges_guides_how_many_colleges_to_apply_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/content":{"get":{"summary":"Content Hub","operationId":"content_hub_content_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/admission-chance-calculator":{"get":{"summary":"Admission Chance Calculator Page","operationId":"admission_chance_calculator_page_admission_chance_calculator_get","parameters":[{"name":"gpa","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Gpa"}},{"name":"sat","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Sat"}},{"name":"act","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Act"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"major","in":"query","required":false,"schema":{"type":"string","default":"","title":"Major"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data":{"get":{"summary":"Data Notes Hub","operationId":"data_notes_hub_data_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/data/{note_slug}":{"get":{"summary":"Data Note Page","operationId":"data_note_page_data__note_slug__get","parameters":[{"name":"note_slug","in":"path","required":true,"schema":{"type":"string","title":"Note Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/press":{"get":{"summary":"Press Page","operationId":"press_page_press_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-3-0-gpa":{"get":{"summary":"Seo Constraint Colleges For 3 0 Gpa","operationId":"seo_constraint_colleges_for_3_0_gpa_colleges_for_3_0_gpa_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-3-5-gpa":{"get":{"summary":"Seo Constraint Colleges For 3 5 Gpa","operationId":"seo_constraint_colleges_for_3_5_gpa_colleges_for_3_5_gpa_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-2-8-gpa":{"get":{"summary":"Seo Constraint Colleges For 2 8 Gpa","operationId":"seo_constraint_colleges_for_2_8_gpa_colleges_for_2_8_gpa_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges-in-texas":{"get":{"summary":"Seo Constraint Test Optional Colleges In Texas","operationId":"seo_constraint_test_optional_colleges_in_texas_test_optional_colleges_in_texas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges-in-california":{"get":{"summary":"Seo Constraint Test Optional Colleges In California","operationId":"seo_constraint_test_optional_colleges_in_california_test_optional_colleges_in_california_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges-in-new-york":{"get":{"summary":"Seo Constraint Test Optional Colleges In New York","operationId":"seo_constraint_test_optional_colleges_in_new_york_test_optional_colleges_in_new_york_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges-in-florida":{"get":{"summary":"Seo Constraint Test Optional Colleges In Florida","operationId":"seo_constraint_test_optional_colleges_in_florida_test_optional_colleges_in_florida_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-colleges-for-3-0-gpa":{"get":{"summary":"Seo Constraint Test Optional Colleges For 3 0 Gpa","operationId":"seo_constraint_test_optional_colleges_for_3_0_gpa_test_optional_colleges_for_3_0_gpa_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/affordable-colleges-in-texas":{"get":{"summary":"Seo Constraint Affordable Colleges In Texas","operationId":"seo_constraint_affordable_colleges_in_texas_affordable_colleges_in_texas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/affordable-colleges-in-california":{"get":{"summary":"Seo Constraint Affordable Colleges In California","operationId":"seo_constraint_affordable_colleges_in_california_affordable_colleges_in_california_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/computer-science-colleges-in-texas":{"get":{"summary":"Seo Constraint Computer Science Colleges In Texas","operationId":"seo_constraint_computer_science_colleges_in_texas_computer_science_colleges_in_texas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/computer-science-colleges-in-california":{"get":{"summary":"Seo Constraint Computer Science Colleges In California","operationId":"seo_constraint_computer_science_colleges_in_california_computer_science_colleges_in_california_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/nursing-colleges-in-florida":{"get":{"summary":"Seo Constraint Nursing Colleges In Florida","operationId":"seo_constraint_nursing_colleges_in_florida_nursing_colleges_in_florida_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-3-0-gpa-in-texas":{"get":{"summary":"Seo Constraint Colleges For 3 0 Gpa In Texas","operationId":"seo_constraint_colleges_for_3_0_gpa_in_texas_colleges_for_3_0_gpa_in_texas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-3-0-gpa-in-california":{"get":{"summary":"Seo Constraint Colleges For 3 0 Gpa In California","operationId":"seo_constraint_colleges_for_3_0_gpa_in_california_colleges_for_3_0_gpa_in_california_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-engineering-colleges":{"get":{"summary":"Seo Constraint Test Optional Engineering Colleges","operationId":"seo_constraint_test_optional_engineering_colleges_test_optional_engineering_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/test-optional-computer-science-colleges":{"get":{"summary":"Seo Constraint Test Optional Computer Science Colleges","operationId":"seo_constraint_test_optional_computer_science_colleges_test_optional_computer_science_colleges_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-1200-sat":{"get":{"summary":"Seo Constraint Colleges For 1200 Sat","operationId":"seo_constraint_colleges_for_1200_sat_colleges_for_1200_sat_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/colleges-for-1000-sat":{"get":{"summary":"Seo Constraint Colleges For 1000 Sat","operationId":"seo_constraint_colleges_for_1000_sat_colleges_for_1000_sat_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best-value-colleges-in-texas":{"get":{"summary":"Seo Constraint Best Value Colleges In Texas","operationId":"seo_constraint_best_value_colleges_in_texas_best_value_colleges_in_texas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/admin/indexnow":{"post":{"summary":"Submit Indexnow","description":"Submit all public pages to Bing IndexNow for instant indexing.","operationId":"submit_indexnow_api_admin_indexnow_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/universities/_data/export.json":{"get":{"summary":"Honeypot Trap","description":"Honeypot link — hidden in HTML, only followed by scrapers. Instantly blocks the IP.","operationId":"honeypot_trap_universities__data_export_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/universities/{slug}":{"get":{"summary":"University Page","description":"Dynamic SEO page for each university.","operationId":"university_page_universities__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/universities":{"get":{"summary":"Universities Index","description":"Index page listing all universities for SEO crawling.","operationId":"universities_index_universities_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/admin/stats":{"get":{"summary":"Admin Stats","description":"Admin dashboard stats — user counts, growth, distribution.","operationId":"admin_stats_api_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/users":{"get":{"summary":"Admin Get Users","description":"Paginated user directory with search, filtering, and engagement stats.","operationId":"admin_get_users_api_admin_users_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","default":"","title":"Search"}},{"name":"role","in":"query","required":false,"schema":{"type":"string","default":"","title":"Role"}},{"name":"provider","in":"query","required":false,"schema":{"type":"string","default":"","title":"Provider"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"created_at","title":"Sort By"}},{"name":"sort_dir","in":"query","required":false,"schema":{"type":"string","default":"desc","title":"Sort Dir"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/ai-analysis":{"post":{"summary":"Admin Ai Analysis","description":"Generate executive AI cohort analysis, funnel bottleneck diagnosis,\nand product growth roadmap using Gemini.","operationId":"admin_ai_analysis_api_admin_ai_analysis_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/users/{user_id}/audit":{"get":{"summary":"Admin User Audit","description":"Deep-dive audit of a specific user's application readiness and activity.","operationId":"admin_user_audit_api_admin_users__user_id__audit_get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/export":{"get":{"summary":"Admin Export Users","description":"Export all user profiles as a styled Excel file.","operationId":"admin_export_users_api_admin_users_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/terms":{"get":{"summary":"Get Terms","description":"Return platform terms, disclaimers, and data accuracy notices.","operationId":"get_terms_api_terms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/privacy-policy":{"get":{"summary":"Privacy Policy","description":"CCPA/FERPA-compliant Privacy Policy.","operationId":"privacy_policy_api_privacy_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/tos":{"get":{"summary":"Terms Of Service","description":"Binding Terms of Service.","operationId":"terms_of_service_api_tos_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/privacy":{"get":{"summary":"Privacy Page","description":"Public-facing Privacy Policy page.","operationId":"privacy_page_privacy_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"head":{"summary":"Privacy Page","description":"Public-facing Privacy Policy page.","operationId":"privacy_page_privacy_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/terms":{"get":{"summary":"Terms Page","description":"Public-facing Terms of Service page.","operationId":"terms_page_terms_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"head":{"summary":"Terms Page","description":"Public-facing Terms of Service page.","operationId":"terms_page_terms_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/feedback":{"post":{"summary":"Submit Feedback","description":"Accept user feedback with optional image attachments and email it to support.","operationId":"submit_feedback_api_feedback_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_feedback_api_feedback_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/feedbacks":{"get":{"summary":"Get Admin Feedbacks","description":"Retrieve all submitted user feedback and bug reports.","operationId":"get_admin_feedbacks_api_admin_feedbacks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/feedbacks/{feedback_id}":{"patch":{"summary":"Update Admin Feedback Status","description":"Update feedback review status (e.g. 'read', 'resolved', 'in_progress').","operationId":"update_admin_feedback_status_api_admin_feedbacks__feedback_id__patch","parameters":[{"name":"feedback_id","in":"path","required":true,"schema":{"type":"integer","title":"Feedback Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account":{"delete":{"summary":"Delete Account","description":"Permanently delete user account and all associated data. CCPA/FERPA compliance.","operationId":"delete_account_api_account_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/health":{"get":{"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/readiness":{"get":{"summary":"Readiness","description":"Durability/observability probe: GCS flush freshness + last error. Returns\n503 when a write is pending durably longer than 2× the periodic interval, or\nwhen the last flush errored — so an uptime check can alert on lost-write risk.","operationId":"readiness_api_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/vault":{"get":{"summary":"Vault List","description":"List documents in the vault with pagination.","operationId":"vault_list_api_vault_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":" Vault Upload Impl","description":"Upload a document to the vault with strict validation (SOC2 CC6.6).","operationId":"_vault_upload_impl_api_vault_post","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body__vault_upload_impl_api_vault_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/vault/upload":{"post":{"summary":" Vault Upload Impl","description":"Upload a document to the vault with strict validation (SOC2 CC6.6).","operationId":"_vault_upload_impl_api_vault_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body__vault_upload_impl_api_vault_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/vault/file/{filename}":{"get":{"summary":"Vault Download","description":"Download or view a file from the vault (path-traversal protected).","operationId":"vault_download_api_vault_file__filename__get","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Vault Delete","description":"Delete a file from the vault (path-traversal protected).","operationId":"vault_delete_api_vault_file__filename__delete","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/vault/analyze-essay/{filename}":{"post":{"summary":"Vault Analyze Essay","description":"Return structured JSON annotations for an essay document.","operationId":"vault_analyze_essay_api_vault_analyze_essay__filename__post","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/vault/analyze/{filename}":{"post":{"summary":"Vault Analyze","description":"Extract text from a vault document and run type-specific AI analysis.","operationId":"vault_analyze_api_vault_analyze__filename__post","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay/score-rubric":{"post":{"summary":"Essay Score Rubric","description":"Score an essay on 5 admissions-specific dimensions with detailed feedback.","operationId":"essay_score_rubric_api_essay_score_rubric_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EssayScoreRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay/school-research":{"post":{"summary":"Essay School Research","description":"Generate school-specific research nuggets for Why Us essays.","operationId":"essay_school_research_api_essay_school_research_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolResearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay/recycling-analysis":{"post":{"summary":"Essay Recycling Analysis","description":"Analyze supplement prompts across schools to find recycling opportunities.","operationId":"essay_recycling_analysis_api_essay_recycling_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecyclingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay/compress":{"post":{"summary":"Essay Compress","description":"Intelligently compress an essay to fit word/character limits.","operationId":"essay_compress_api_essay_compress_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay/portfolio-matrix":{"post":{"summary":"Essay Portfolio Matrix","description":"Analyze essay portfolio across all schools for theme coverage and gaps.","operationId":"essay_portfolio_matrix_api_essay_portfolio_matrix_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay-drafts":{"post":{"summary":"Save Essay Draft","description":"Save or update an essay draft on the server (replaces localStorage).","operationId":"save_essay_draft_api_essay_drafts_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EssayDraftSave"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"List Essay Drafts","description":"List all essay drafts for the current user.","operationId":"list_essay_drafts_api_essay_drafts_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/essay-drafts/{draft_key}":{"get":{"summary":"Get Essay Draft","description":"Load a specific essay draft.","operationId":"get_essay_draft_api_essay_drafts__draft_key__get","parameters":[{"name":"draft_key","in":"path","required":true,"schema":{"type":"string","title":"Draft Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/family-share":{"get":{"summary":"List Family Shares","description":"List all share links for this student.","operationId":"list_family_shares_api_family_share_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Create Family Share","description":"Generate a read-only share link for parents/family.","operationId":"create_family_share_api_family_share_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/family-share/{share_id}":{"delete":{"summary":"Revoke Family Share","description":"Revoke (deactivate) a share link.","operationId":"revoke_family_share_api_family_share__share_id__delete","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"integer","title":"Share Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/family-view/{token}":{"get":{"summary":"Family View","description":"Read-only family view — returns dashboard, applications, college list, timeline.\nFERPA: Student-initiated consent via share link creation. No PII (email, financials) exposed.\nData limited to: school names, application statuses, decisions, and timeline milestones.","operationId":"family_view_api_family_view__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{full_path}":{"get":{"summary":"Serve Spa","description":"SPA fallback for production while keeping API misses as JSON 404s.","operationId":"serve_spa__full_path__get","parameters":[{"name":"full_path","in":"path","required":true,"schema":{"type":"string","title":"Full Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"summary":"Serve Spa","description":"SPA fallback for production while keeping API misses as JSON 404s.","operationId":"serve_spa__full_path__get","parameters":[{"name":"full_path","in":"path","required":true,"schema":{"type":"string","title":"Full Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ApplicationCreate":{"properties":{"unitid":{"type":"string","title":"Unitid"},"status":{"type":"string","title":"Status","default":"researching"}},"type":"object","required":["unitid"],"title":"ApplicationCreate"},"ApplicationUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"essay_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Essay Status"},"rec_letters_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rec Letters Status"},"financial_aid_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Aid Status"},"interview_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interview Status"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision"},"decision_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Date"}},"type":"object","title":"ApplicationUpdate"},"Body__vault_upload_impl_api_vault_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"label":{"type":"string","title":"Label"}},"type":"object","required":["file"],"title":"Body__vault_upload_impl_api_vault_post"},"Body__vault_upload_impl_api_vault_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"label":{"type":"string","title":"Label"}},"type":"object","required":["file"],"title":"Body__vault_upload_impl_api_vault_upload_post"},"Body_submit_feedback_api_feedback_post":{"properties":{"category":{"type":"string","title":"Category","default":"suggestion"},"subject":{"type":"string","title":"Subject","default":""},"message":{"type":"string","title":"Message"},"images":{"items":{"type":"string","format":"binary"},"type":"array","title":"Images","default":[]}},"type":"object","required":["message"],"title":"Body_submit_feedback_api_feedback_post"},"ChatGPTRegisterRequest":{"properties":{"session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Key"},"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role","default":"student"}},"type":"object","required":["email","password","name"],"title":"ChatGPTRegisterRequest"},"ChatGPTSessionCreate":{"properties":{"conversation":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conversation"},"profile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Profile"}},"type":"object","required":["conversation"],"title":"ChatGPTSessionCreate"},"ChatRequest":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"student_profile":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Student Profile"}},"type":"object","required":["message"],"title":"ChatRequest"},"CollegeListItem":{"properties":{"unitid":{"type":"string","title":"Unitid"},"tier":{"type":"string","title":"Tier","default":"target"}},"type":"object","required":["unitid"],"title":"CollegeListItem"},"CollegeListUpdate":{"properties":{"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"CollegeListUpdate"},"CompressRequest":{"properties":{"essay_text":{"type":"string","title":"Essay Text"},"target_words":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Words"},"target_chars":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Chars"}},"type":"object","required":["essay_text"],"title":"CompressRequest"},"EssayDraftSave":{"properties":{"draft_key":{"type":"string","title":"Draft Key"},"workspace":{"type":"string","title":"Workspace","default":"personal"},"school":{"type":"string","title":"School","default":""},"text":{"type":"string","title":"Text","default":""},"label":{"type":"string","title":"Label","default":""},"word_count":{"type":"integer","title":"Word Count","default":0},"char_count":{"type":"integer","title":"Char Count","default":0},"history":{"items":{},"type":"array","title":"History","default":[]},"iterations":{"type":"integer","title":"Iterations","default":0}},"type":"object","required":["draft_key"],"title":"EssayDraftSave"},"EssayRequest":{"properties":{"university_name":{"type":"string","title":"University Name"},"prompt_type":{"type":"string","title":"Prompt Type","default":"why_us"}},"type":"object","required":["university_name"],"title":"EssayRequest"},"EssayScoreRequest":{"properties":{"essay_text":{"type":"string","title":"Essay Text"},"essay_type":{"type":"string","title":"Essay Type","default":"personal"},"school":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School"}},"type":"object","required":["essay_text"],"title":"EssayScoreRequest"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"PortfolioRequest":{"properties":{"schools":{"items":{},"type":"array","title":"Schools"},"drafts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Drafts"}},"type":"object","required":["schools"],"title":"PortfolioRequest"},"ProfileUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa"},"sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat"},"act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act"},"desired_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Desired Major"},"class_rank":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Class Rank"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"family_income":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Income"},"extracurriculars":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"}},"type":"object","title":"ProfileUpdateRequest"},"RecyclingRequest":{"properties":{"schools":{"items":{},"type":"array","title":"Schools"}},"type":"object","required":["schools"],"title":"RecyclingRequest"},"RegisterRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role","default":"student"},"terms_accepted":{"type":"boolean","title":"Terms Accepted","default":false},"gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa"},"sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat"},"act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act"},"desired_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Desired Major"},"family_income":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Income"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},"type":"object","required":["email","password","name"],"title":"RegisterRequest"},"ReportOutcomeRequest":{"properties":{"unitid":{"type":"string","title":"Unitid"},"result":{"type":"string","title":"Result"},"round":{"type":"string","title":"Round","default":"regular"},"gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa"},"sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat"},"act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},"type":"object","required":["unitid","result"],"title":"ReportOutcomeRequest"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest"},"SchoolResearchRequest":{"properties":{"school_name":{"type":"string","title":"School Name"},"student_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Student Major"}},"type":"object","required":["school_name"],"title":"SchoolResearchRequest"},"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"}}}}