{"openapi":"3.1.0","info":{"title":"College Search Concierge","description":"AI-powered college matching platform for high school students.\n\n## Authentication\nMost endpoints require a Bearer token via the `Authorization` header. Missing or malformed tokens return **401**.","version":"0.1.0"},"servers":[{"url":"https://scholarsyn.ch","description":"Production"},{"url":"http://localhost:8000","description":"Local development"}],"paths":{"/api/v1/auth/register":{"post":{"tags":["auth"],"summary":"Register","description":"Register a new user account behind the email-verification gate (#364).\n\nNew users start ``email_verified=False`` and get a verification email\nwith a 24h-expiry single-use token. The welcome email + admin\nnotification + tool-leads conversion all fire from\n``consume_verification_token`` when the user clicks the link — so the\nclick-farm wave of fake signups never triggers any of those side\neffects.\n\nAnti-spam (#253, #364): RegisterSpamFilter runs honeypot, submit-time\nfloor, custom + package disposable-domain check, display_name\ngibberish heuristics (#364 addition), and Turnstile siteverify. Spam\nsilently drops with a synthetic ``RegisterResponse`` (no DB write, no\nemails) so bots get no signal to adapt against. The 3/hour per-IP\nrate limit on top stops productive volume even when the filter chain\nmisses. Real users see \"Check your inbox\" regardless — the silent-drop\nresponse is observationally identical.","operationId":"register_api_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/service-token":{"post":{"tags":["auth"],"summary":"Service Token","description":"A short-lived token for the admin panel's proxy, against a shared secret (#977).","operationId":"service_token_api_v1_auth_service_token_post","parameters":[{"name":"x-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Proxy-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceToken"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","description":"Login with email and password. Accepts form data with username (email) and password fields.\n\nRate-limited to 30/min per IP to defang credential stuffing (security audit H-3).","operationId":"login_api_v1_auth_login_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_login_api_v1_auth_login_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Token"},{"$ref":"#/components/schemas/MfaChallengeRequired"}],"title":"Response Login Api V1 Auth Login Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/login-json":{"post":{"tags":["auth"],"summary":"Login Json","description":"Login with email and password using JSON. Accepts JSON body with email and password fields.\n\nRate-limited to 30/min per IP to defang credential stuffing (security audit H-3).","operationId":"login_json_api_v1_auth_login_json_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Token"},{"$ref":"#/components/schemas/MfaChallengeRequired"}],"title":"Response Login Json Api V1 Auth Login Json Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["auth"],"summary":"Get Current User Info","description":"Get current authenticated user's information.","operationId":"get_current_user_info_api_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/sessions/revoke":{"post":{"tags":["auth"],"summary":"Sign Out Other Devices","description":"Sign out of every other device (#987).\n\nEvery session issued so far ends, this one included, and the caller gets a\nnew token so this device stays signed in.","operationId":"sign_out_other_devices_api_v1_auth_sessions_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/me/onboarding":{"post":{"tags":["auth"],"summary":"Claim Onboarding","description":"Claim the anonymous onboarding record after sign-in (#870, epic #867).\n\nFills only fields the account doesn't have yet, so a stale browser record\ncan't overwrite what the user said since. Idempotent; the frontend calls it\nonce after every sign-in path and never waits on it.","operationId":"claim_onboarding_api_v1_auth_me_onboarding_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingClaim"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/me/account-type":{"put":{"tags":["auth"],"summary":"Update Account Type","description":"Set or clear the persona from settings (#870). Routing and copy only.","operationId":"update_account_type_api_v1_auth_me_account_type_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountTypeUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/age-attestation":{"post":{"tags":["auth"],"summary":"Attest Age","description":"Record the user's 13+ attestation (#588).\n\nBackstop for accounts created without the register-form checkbox: OAuth\nsignups (no form in that flow), accounts predating the gate, and signups\nfrom frozen mobile builds whose bundled form doesn't send the field. The\nfrontend's AgeAttestationGate calls this once from a blocking modal.\n\nIdempotent — the first attestation timestamp is the record of the claim,\nso a repeat call returns the existing state unchanged rather than\nrefreshing it.","operationId":"attest_age_api_v1_auth_age_attestation_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/verify-email":{"get":{"tags":["auth"],"summary":"Verify Email","description":"Consume an email-verification token (#364).\n\nOn success: flips ``users.email_verified=True``, marks the token used,\nand fires the post-verification hooks (welcome email, admin\nnotification, tool-leads conversion). Returns 200 with success=True.\n\nOn failure (expired / already-used / unknown / user-deleted): returns\n200 with success=False and a reason-coded message so the frontend\ncan render an inline \"request a new link\" affordance.\n\n#1035: an unverified account that holds a password is not verified here.\nWhoever set that password may not own the mailbox, so the page's\n``POST`` decides who keeps it. Nothing is spent.","operationId":"verify_email_api_v1_auth_verify_email_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Email-verification token from the welcome email.","title":"Token"},"description":"Email-verification token from the welcome email."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["auth"],"summary":"Verify Email And Sign In","description":"Confirm the address and sign the user in (#871, epic #867).\n\nThe operator chose magic-link semantics (\"Always sign in\"): redeeming a\nvalid link signs in on any device, so a new user isn't sent back to the\nsign-in form right after confirming. The bounds (ARCHITECTURE.md\n§\"Persona Pathways\" 3; SECURITY.md):\n\n* it's a POST from the page's \"Continue\" button, so a mail scanner that\n  prefetches the GET link never redeems it;\n* the token stays single-use and expiring, and redeeming it revokes the\n  user's other unused verification tokens;\n* no session for an account that was already verified, or one with a\n  second sign-in step (MFA) — those go through the sign-in form;\n* audited as ``email_verified_session``.\n\nThe GET endpoint stays for links already in inboxes and never signs in.\n\n#1035: an unverified account holding a password confirms as it is only\nwith the ``registrant_proof`` the registering browser was given. Anyone\nelse chooses a password, which replaces the registrant's; until they do,\nnothing is spent.","operationId":"verify_email_and_sign_in_api_v1_auth_verify_email_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailSessionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/resend-verification":{"post":{"tags":["auth"],"summary":"Resend Verification","description":"Resend the verification email (#364).\n\nEnumeration-safe: always returns the same success body whether the\nuser exists, is already verified, or doesn't exist at all. Limited to\n3/hour per IP, and one address is sent at most 3 an hour from anywhere\n(#1019), counted here because slowapi keys before the body is read.","operationId":"resend_verification_api_v1_auth_resend_verification_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/forgot-password":{"post":{"tags":["auth"],"summary":"Forgot Password","description":"Send a password reset email with a single-use link, retiring any earlier link.\n\nThe answer is the same whether the address has an account, has none, or is over\nits cap, so it reveals nothing. Limited to 10/hour per IP (security audit H-3)\nand 3/hour per address from anywhere (#1031).","operationId":"forgot_password_api_v1_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/validate-reset-token":{"get":{"tags":["auth"],"summary":"Validate Reset Token Endpoint","description":"Check whether a password-reset token is still valid (without consuming it).","operationId":"validate_reset_token_endpoint_api_v1_auth_validate_reset_token_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Password-reset token sent to the user's email.","title":"Token"},"description":"Password-reset token sent to the user's email."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/reset-password-with-token":{"post":{"tags":["auth"],"summary":"Reset Password With Token Endpoint","description":"Reset password using a valid token from the forgot password email.\n\nEvery other link the account holds stops working, the owner is emailed, and\neach attempt writes an audit row (#997).","operationId":"reset_password_with_token_endpoint_api_v1_auth_reset_password_with_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordWithTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/account/reauth-code":{"post":{"tags":["auth"],"summary":"Send Account Reauth Code","description":"Email a code that confirms deleting or deactivating an account with no password.","operationId":"send_account_reauth_code_api_v1_auth_account_reauth_code_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/deactivate":{"post":{"tags":["auth"],"summary":"Deactivate Account","description":"Deactivate the current user's account (soft delete).","operationId":"deactivate_account_api_v1_auth_deactivate_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DeleteAccountRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/account":{"delete":{"tags":["auth"],"summary":"Delete Account","description":"Permanently delete the current user's account and all associated data.","operationId":"delete_account_api_v1_auth_account_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/account/delete-request":{"post":{"tags":["auth"],"summary":"Request Account Deletion","description":"Request account deletion with a 7-day grace period. Sends confirmation email.","operationId":"request_account_deletion_api_v1_auth_account_delete_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/account/confirm-delete":{"post":{"tags":["auth"],"summary":"Confirm Account Deletion","description":"Confirm a pending account deletion using the emailed token.","operationId":"confirm_account_deletion_api_v1_auth_account_confirm_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/account/cancel-delete":{"post":{"tags":["auth"],"summary":"Cancel Account Deletion","description":"Cancel a pending account deletion using the emailed token.","operationId":"cancel_account_deletion_api_v1_auth_account_cancel_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/account/cancel-delete-auth":{"post":{"tags":["auth"],"summary":"Cancel Deletion Authenticated","description":"Cancel a pending deletion for the authenticated user (no token needed).","operationId":"cancel_deletion_authenticated_api_v1_auth_account_cancel_delete_auth_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/account/pending-deletion":{"get":{"tags":["auth"],"summary":"Get Pending Deletion","description":"Check if the current user has a pending deletion request.","operationId":"get_pending_deletion_api_v1_auth_account_pending_deletion_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingDeletionResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/native-challenge":{"post":{"tags":["auth"],"summary":"Native Challenge","description":"Hand a Turnstile token solved on /native/verify back to the app (#908).\n\nThe page runs in the app's browser sheet; this answers its form POST with\na redirect to the custom scheme, which iOS and Android hand to the app\n(the transport #591 measured; see ``_oauth_return_url``). Shapes only:\nsiteverify is not called here, because the token is single-use and the\napp's register spends it. A token caught on its way back through the\nscheme is worth one signup attempt for 300 s, and ``state`` ties it to\nthe attempt the app started.","operationId":"native_challenge_api_v1_auth_native_challenge_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_native_challenge_api_v1_auth_native_challenge_post"}}},"required":true},"responses":{"303":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/google/login":{"get":{"tags":["auth"],"summary":"Google Login","description":"Initiate Google OAuth login flow.\nRedirects user to Google's OAuth consent screen.\nUses Redis-based state storage instead of sessions for cross-domain compatibility.\n\n``native`` is persisted in the Redis state rather than round-tripped through\nGoogle, because the callback's query parameters arrive from Google and are\nattacker-influenceable — the state is server-side and already validated\nbefore use (#591).","operationId":"google_login_api_v1_auth_google_login_get","parameters":[{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional email to pre-select the Google account via login_hint.","title":"Email"},"description":"Optional email to pre-select the Google account via login_hint."},{"name":"native","in":"query","required":false,"schema":{"type":"boolean","description":"Set by the Capacitor iOS app. Routes the final redirect back into the app via the custom scheme instead of the website (#591).","default":false,"title":"Native"},"description":"Set by the Capacitor iOS app. Routes the final redirect back into the app via the custom scheme instead of the website (#591)."},{"name":"code_challenge","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"description":"base64url(SHA-256(verifier)) — PKCE-style binding of the exchange code to the client that started the flow (#591). Required on every flow, web and native (#988).","title":"Code Challenge"},"description":"base64url(SHA-256(verifier)) — PKCE-style binding of the exchange code to the client that started the flow (#591). Required on every flow, web and native (#988)."}],"responses":{"307":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/google/callback":{"get":{"tags":["auth"],"summary":"Google Callback","description":"Handle Google OAuth callback.\nExchanges authorization code for user info and creates/updates user.\nUses Redis-based state validation instead of sessions.","operationId":"google_callback_api_v1_auth_google_callback_get","responses":{"307":{"description":"Successful Response"}}}},"/api/v1/auth/oauth-exchange":{"post":{"tags":["auth"],"summary":"Oauth Exchange","description":"Swap a one-time OAuth exchange code for the auth response payload.\n\nThe Google callback handler stores the auth response (access_token,\nuser, new_user flag) in Redis under a 256-bit code with a 60s TTL,\nthen redirects the browser to /auth/callback?code=<code>. The\nfrontend's callback page POSTs that code here and gets back the\npayload it used to read straight from the URL — closing the\nJWT-in-URL leak (security audit H-2).\n\nSingle-use via Redis GETDEL: a code is valid exactly once.\nUnknown / expired / already-redeemed codes return 401, no\ndistinguishing detail (timing-safe by virtue of the Redis miss\nbeing identical for all three cases).","operationId":"oauth_exchange_api_v1_auth_oauth_exchange_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthExchangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/apple":{"post":{"tags":["auth"],"summary":"Apple Login","description":"Sign in with Apple (#574).\n\nThe client (Apple JS SDK popup on web; native Capacitor plugin in B6)\nobtains an identity token client-side and POSTs it here. We verify the\nJWT against Apple's JWKS (RS256, iss/aud/exp enforced — see\napp/services/oauth_apple.py), then link or create the account:\n\n- returning user by ``apple_sub``;\n- existing account with the same **verified** email → link, never\n  duplicate;\n- otherwise a new user via the shared OAuth creation path.\n\n``body.user`` is Apple's first-authorization payload (name; sent exactly\nonce — persisted immediately, there is no second chance). Response shape\nmatches the Google flow's exchange payload: the auth response plus a\n``new_user`` flag.","operationId":"apple_login_api_v1_auth_apple_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppleAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/mfa/status":{"get":{"tags":["auth"],"summary":"Mfa Status","description":"Whether the second step is on, and whether this account can turn it on.","operationId":"mfa_status_api_v1_auth_mfa_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/enroll":{"post":{"tags":["auth"],"summary":"Mfa Enroll","description":"Begin enrollment: mint a secret and return provisioning material.\n\n``mfa_enabled`` stays False — the factor only goes live once a code has\nactually verified (``/confirm``). Never enable on the strength of a secret\nthe user may never have saved.\n\n**Requires the password.** Without it, someone holding a stolen access\ntoken could enroll their own authenticator on the account: that grants them\nnothing (they still lack the password) but it denies the real owner their\naccess, and survives the owner's password reset — leaving both parties\nlocked out until an admin clears the factor. Disable already required the\npassword; the asymmetry was the bug.\n\n``/confirm`` deliberately does NOT re-ask. It can only act on a pending\nsecret, and only this endpoint creates one, so the password has already\nbeen checked for that secret; confirming additionally requires a TOTP code\ngenerated from it. Asking twice in one flow would buy nothing.","operationId":"mfa_enroll_api_v1_auth_mfa_enroll_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEnrollRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEnrollResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/confirm":{"post":{"tags":["auth"],"summary":"Mfa Confirm","description":"Verify the first code, then turn the factor on and issue recovery codes.\n\nThis is the only place ``mfa_enabled`` flips to True, and it is downstream\nof a real verification — that ordering is the acceptance criterion.","operationId":"mfa_confirm_api_v1_auth_mfa_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaRecoveryCodesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/disable":{"post":{"tags":["auth"],"summary":"Mfa Disable","description":"Turn the second step off. Requires the password AND a valid code.\n\nBoth, because a stolen access token alone must not be able to strip the\nfactor — that would make the whole control removable by the attack it\nexists to survive.","operationId":"mfa_disable_api_v1_auth_mfa_disable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaDisableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaDisableResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/recovery-codes":{"post":{"tags":["auth"],"summary":"Mfa Regenerate Recovery Codes","description":"Replace the recovery-code set. Requires a valid TOTP code.\n\nDeliberately TOTP-only, not \"TOTP or a recovery code\": letting a recovery\ncode mint a fresh set would turn one leaked code into permanent access.","operationId":"mfa_regenerate_recovery_codes_api_v1_auth_mfa_recovery_codes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaRecoveryCodesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/auth/mfa/challenge":{"post":{"tags":["auth"],"summary":"Mfa Challenge","description":"Exchange a challenge token + code for the real access token.\n\nUnauthenticated by design — the challenge token *is* the credential, and it\nonly exists because a password check already passed.","operationId":"mfa_challenge_api_v1_auth_mfa_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaChallengeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profile/completeness":{"get":{"tags":["profile"],"summary":"Get Profile Completeness","description":"Get profile completeness metrics.\n\nReturns information about which profile sections are complete and\nwhat fields are still missing for optimal scholarship matching.","operationId":"get_profile_completeness_api_v1_profile_completeness_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCompletenessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles":{"get":{"tags":["profiles"],"summary":"List Profiles","description":"List all profiles accessible by the current account.","operationId":"list_profiles_api_v1_profiles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProfileWithAccess"},"type":"array","title":"Response List Profiles Api V1 Profiles Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["profiles"],"summary":"Create Profile","description":"Create a new profile and link it to the current account.","operationId":"create_profile_api_v1_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/profiles/share/{token}":{"get":{"tags":["profiles"],"summary":"Get Public Share","description":"Public, anonymous-readable redacted profile + match list.\n\nNo auth. Rate-limited via slowapi. Audit-logs ``profile.share_view``\nbest-effort. Returns 404 for missing/disabled tokens.","operationId":"get_public_share_api_v1_profiles_share__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":64,"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfileShareOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/share":{"get":{"tags":["profiles"],"summary":"Get Share State","description":"Owner-only — return the current share-link state for this profile.\n\nReturns ``enabled=False`` with empty token/url if no token has been\nminted yet. Used by the owner-side share modal to render the right CTA.","operationId":"get_share_state_api_v1_profiles__profile_id__share_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["profiles"],"summary":"Enable Share","description":"Owner-only — enable share for this profile, or rotate the token.\n\nFirst-time enable: mints a token. Re-enable after disable: re-uses the\nexisting token. ``{\"rotate\": true}`` always mints a new token, breaking\nany previously-shared URL.","operationId":"enable_share_api_v1_profiles__profile_id__share_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ShareLinkRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["profiles"],"summary":"Disable Share","description":"Owner-only — disable share. Token is preserved; re-enable reuses it.","operationId":"disable_share_api_v1_profiles__profile_id__share_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/access-requests":{"post":{"tags":["profiles"],"summary":"Create Profile Access Request","description":"Ask an assigned student for access to their profile.","operationId":"create_profile_access_request_api_v1_profiles_access_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAccessRequestCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAccessRequestOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/profiles/access-requests/incoming":{"get":{"tags":["profiles"],"summary":"List Incoming Profile Access Requests","description":"Requests awaiting this user's decision.","operationId":"list_incoming_profile_access_requests_api_v1_profiles_access_requests_incoming_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProfileAccessRequestOut"},"type":"array","title":"Response List Incoming Profile Access Requests Api V1 Profiles Access Requests Incoming Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/profiles/access-requests/{request_id}/approve":{"post":{"tags":["profiles"],"summary":"Approve Profile Access Request","description":"Grant the counselor view access. Revocable like any other share.","operationId":"approve_profile_access_request_api_v1_profiles_access_requests__request_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedAccessOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/access-requests/{request_id}/decline":{"post":{"tags":["profiles"],"summary":"Decline Profile Access Request","operationId":"decline_profile_access_request_api_v1_profiles_access_requests__request_id__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAccessRequestOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}":{"get":{"tags":["profiles"],"summary":"Get Profile","description":"Get a specific profile by ID.","operationId":"get_profile_api_v1_profiles__profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileWithPrograms"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["profiles"],"summary":"Update Profile","description":"Update a profile.","operationId":"update_profile_api_v1_profiles__profile_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["profiles"],"summary":"Delete Profile","description":"Delete a profile. Only owners can delete profiles.","operationId":"delete_profile_api_v1_profiles__profile_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/invite":{"post":{"tags":["profiles"],"summary":"Invite To Profile","description":"Send an invitation to share a profile with another user via email.","operationId":"invite_to_profile_api_v1_profiles__profile_id__invite_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileInvitationCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileInvitationOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/invitations/pending":{"get":{"tags":["profiles"],"summary":"List Pending Invitations","description":"List all pending invitations for the current user's email.","operationId":"list_pending_invitations_api_v1_profiles_invitations_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProfileInvitationPending"},"type":"array","title":"Response List Pending Invitations Api V1 Profiles Invitations Pending Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/profiles/invitations/{token}/accept":{"post":{"tags":["profiles"],"summary":"Accept Invitation","description":"Accept a profile invitation.\n\nA ``handover`` invitation (#875) makes the accepting student the owner of a\nprofile their parent started; ``body.parent_access`` is what the parent\nkeeps (``edit`` / ``view`` / ``none``), the student's private choice.","operationId":"accept_invitation_api_v1_profiles_invitations__token__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","description":"Invitation token","title":"Token"},"description":"Invitation token"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvitationAccept"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/handover":{"post":{"tags":["profiles"],"summary":"Hand Over Profile","description":"Send a profile a parent started to their child, to take over (#875).\n\nOnly the parent who runs it (an ``owner`` row with ``managed_by_parent``)\ncan. The child accepts from their own account; they must be 13 or older,\nwhich their account's attestation records. One pending handover at a time.","operationId":"hand_over_profile_api_v1_profiles__profile_id__handover_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileHandoverCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileInvitationOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/shared-access/{account_id}":{"patch":{"tags":["profiles"],"summary":"Update Profile Access","description":"Change another account's access to a profile you own (#875).\n\nThe owner alone decides; the other account isn't notified. An owner row\ncan't be changed here (the handover moves ownership).","operationId":"update_profile_access_api_v1_profiles__profile_id__shared_access__account_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"account_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Account UUID","title":"Account Id"},"description":"Account UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantAccessUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedAccessOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["profiles"],"summary":"Revoke Profile Access","description":"Revoke another user's access to a profile.","operationId":"revoke_profile_access_api_v1_profiles__profile_id__shared_access__account_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"account_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Account UUID","title":"Account Id"},"description":"Account UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/invitations/{token}/decline":{"post":{"tags":["profiles"],"summary":"Decline Invitation","description":"Decline a profile invitation.","operationId":"decline_invitation_api_v1_profiles_invitations__token__decline_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","description":"Invitation token","title":"Token"},"description":"Invitation token"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/shared-with":{"get":{"tags":["profiles"],"summary":"List Shared Access","description":"List all users who have access to this profile.","operationId":"list_shared_access_api_v1_profiles__profile_id__shared_with_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SharedAccessOut"},"title":"Response List Shared Access Api V1 Profiles  Profile Id  Shared With Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/set-primary":{"post":{"tags":["profiles"],"summary":"Set Primary Profile","description":"Set a profile as the primary profile for the current account.","operationId":"set_primary_profile_api_v1_profiles__profile_id__set_primary_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/programs":{"post":{"tags":["profiles"],"summary":"Add Program To Profile","description":"Add a program to a profile.","operationId":"add_program_to_profile_api_v1_profiles__profile_id__programs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileProgramCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileProgramOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["profiles"],"summary":"List Profile Programs","description":"List all programs associated with a profile.","operationId":"list_profile_programs_api_v1_profiles__profile_id__programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfileProgramOut"},"title":"Response List Profile Programs Api V1 Profiles  Profile Id  Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/programs/{program_id}":{"delete":{"tags":["profiles"],"summary":"Remove Program From Profile","description":"Remove a program from a profile.","operationId":"remove_program_from_profile_api_v1_profiles__profile_id__programs__program_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Program UUID","title":"Program Id"},"description":"Program UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/guest-sessions":{"post":{"tags":["chat"],"summary":"Create Chat Guest Session","description":"Mint an anonymous chat guest session (#509).\n\nTurnstile-verified (fail-open on Cloudflare outage, skipped when no\nsecret is configured) and IP-limited to 3 sessions/day — the budget is\nper-session, so the mint cap is what bounds total anonymous spend per IP.","operationId":"create_chat_guest_session_api_v1_chat_guest_sessions_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GuestSessionCreateRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuestSessionCreateResponse"}}}},"503":{"description":"Guest-session store unavailable — retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/guest-sessions/{session_id}/link":{"post":{"tags":["chat"],"summary":"Link Chat Guest Session","description":"Bind a guest chat session (and its conversations) to the caller (#509).\n\nMirrors the tools link semantics: idempotent on the same user, 409 on\nrebind to a different account. Orphan conversations\n(``user_id IS NULL AND guest_session_id = :id``) are reassigned to the\ncaller and adopt the caller's primary profile when one exists, so the\nhistory shows up in the default conversation list.","operationId":"link_chat_guest_session_api_v1_chat_guest_sessions__session_id__link_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuestSessionLinkResponse"}}}},"404":{"description":"Unknown session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Session already linked to another account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Guest-session store unavailable — retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat":{"post":{"tags":["chat"],"summary":"Send Message","description":"Send a message and get a response.\n\nProcesses the user's message through the conversation graph and returns\nthe assistant's reply with any recommended colleges.\n\nAnonymous callers (#509) must present a valid ``X-Guest-Session`` header;\neach anonymous message consumes one credit of the session's free budget\nand over-budget sends return a structured 429 (``budget_exhausted``).","operationId":"send_message_api_v1_chat_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Guest-Session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Guest-Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"503":{"description":"Guest-session store unavailable — retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/stream":{"post":{"tags":["chat"],"summary":"Stream Message","description":"Stream a chat response as newline-delimited JSON (NDJSON).\n\nEach line is a JSON object with a \"type\" field:\n  {\"type\": \"conversation_id\", \"conversation_id\": \"...\"}\n  {\"type\": \"token\", \"content\": \"...\"}\n  {\"type\": \"metadata\", \"conversation_id\": \"...\", \"colleges\": [...]}\n  {\"type\": \"done\"}\n  {\"type\": \"error\", \"message\": \"...\"}\n\nAnonymous callers (#509): same guest-session/budget contract as\n``POST /chat`` — the budget check happens before the stream starts, so\nexhaustion is a plain 429 JSON response, not an in-stream event.","operationId":"stream_message_api_v1_chat_stream_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Guest-Session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Guest-Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Newline-delimited JSON event stream","content":{"application/x-ndjson":{}}},"503":{"description":"Guest-session store unavailable — retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations/{conversation_id}/rerun":{"post":{"tags":["chat"],"summary":"Rerun Last Message","description":"Re-run the last user message in the conversation to get a new response from the LLM.\nThis is useful when the user wants to try again with a different result.","operationId":"rerun_last_message_api_v1_chat_conversations__conversation_id__rerun_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations":{"get":{"tags":["chat"],"summary":"List Conversations","description":"List all conversations for the current user.\n\nOptionally filter by profile ID. Returns conversations with their\nmessages, ordered by most recent first.","operationId":"list_conversations_api_v1_chat_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by profile ID","title":"Profile Id"},"description":"Filter by profile ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConversationOut"},"title":"Response List Conversations Api V1 Chat Conversations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations/{conversation_id}":{"get":{"tags":["chat"],"summary":"Get Conversation","description":"Retrieve a single conversation by ID.\n\nReturns the full conversation including all messages and any associated\ncollege recommendations.\n\nAnonymous callers (#509) present ``X-Guest-Session``; the read is scoped\nto that session's unlinked conversations (the opaque 256-bit session id\nis the capability). Authenticated behavior is unchanged.","operationId":"get_conversation_api_v1_chat_conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"},{"name":"X-Guest-Session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Guest-Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationOut"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["chat"],"summary":"Delete Conversation","description":"Delete a conversation (soft delete).","operationId":"delete_conversation_api_v1_chat_conversations__conversation_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/suggestions":{"get":{"tags":["chat"],"summary":"Get Chat Suggestions","description":"Opening chips for a conversation with no turns yet.\n\nPersonalised from the caller's own profile and saved-college count when\nthere is one; falls back to the generic set otherwise, which is what an\nanonymous caller always gets. Deterministic — no model call, so this is\ncheap enough to fetch on every empty state.","operationId":"get_chat_suggestions_api_v1_chat_suggestions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Profile to personalise the openers for.","title":"Profile Id"},"description":"Profile to personalise the openers for."},{"name":"locale","in":"query","required":false,"schema":{"enum":["en","es"],"type":"string","description":"The page's language: Spanish chips on /es pages (#905).","default":"en","title":"Locale"},"description":"The page's language: Spanish chips on /es pages (#905)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatSuggestionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/messages/{message_id}/helpful":{"post":{"tags":["chat"],"summary":"Mark Chat Message Helpful","description":"Mark an assistant response helpful — the positive counterpart to Report.\n\nDeliberately a **separate endpoint with its own budget**, not another reason\non ``/report``. The two share a table and a handler body but not a rate\nlimit: Report is the App Review reporting affordance and must stay\navailable, and a student tapping Helpful through a long session would\notherwise eat the 10/hour report budget and silently 429 the thing Apple\nrequires to work. This path accepts no free text, which is what the tighter\nreport limit exists to bound.","operationId":"mark_chat_message_helpful_api_v1_chat_messages__message_id__helpful_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Message UUID","title":"Message Id"},"description":"Message UUID"},{"name":"X-Guest-Session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Guest-Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatReportResponse"}}}},"400":{"description":"Not an assistant message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Message not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/messages/{message_id}/report":{"post":{"tags":["chat"],"summary":"Report Chat Message","description":"Report an assistant message for review (#582, App Review prep).\n\nAvailable to authenticated users and guest sessions alike — the reported\nmessage must belong to a conversation the caller owns (guest ownership is\nscoped exactly like ``GET /chat/conversations/{id}``). The message text is\nsnapshotted server-side into ``chat_reports`` so the report stays\nreviewable even after history pruning; submission is idempotent per\nreporter+message. Rate-limited: this endpoint accepts free text.","operationId":"report_chat_message_api_v1_chat_messages__message_id__report_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Message UUID","title":"Message Id"},"description":"Message UUID"},{"name":"X-Guest-Session","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Guest-Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatReportResponse"}}}},"400":{"description":"Not an assistant message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Message not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations/{conversation_id}/mute":{"patch":{"tags":["chat"],"summary":"Toggle Mute Conversation","description":"Toggle the muted state of a conversation.\n\nMuted conversations are excluded from notification triggers.","operationId":"toggle_mute_conversation_api_v1_chat_conversations__conversation_id__mute_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationOut"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations/bulk-delete":{"post":{"tags":["chat"],"summary":"Bulk Delete Conversations","description":"Delete multiple conversations at once (soft delete).\n\nAccepts a JSON body with an 'ids' array of conversation IDs.","operationId":"bulk_delete_conversations_api_v1_chat_conversations_bulk_delete_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/chat/conversations/{conversation_id}/preferences":{"get":{"tags":["chat"],"summary":"Get Conversation Preferences Endpoint","description":"Get all stored preferences for a conversation.\nThese preferences are automatically extracted from user messages.","operationId":"get_conversation_preferences_endpoint_api_v1_chat_conversations__conversation_id__preferences_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConversationPreferenceOut"},"title":"Response Get Conversation Preferences Endpoint Api V1 Chat Conversations  Conversation Id  Preferences Get"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/chat/conversations/{conversation_id}/context":{"get":{"tags":["chat"],"summary":"Get Conversation Context","description":"Get a formatted context summary of all preferences for a conversation.\nThis is used to provide context to the LLM.","operationId":"get_conversation_context_api_v1_chat_conversations__conversation_id__context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Conversation UUID","title":"Conversation Id"},"description":"Conversation UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationContextResponse"}}}},"404":{"description":"Conversation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/colleges":{"get":{"tags":["colleges"],"summary":"Search Colleges","description":"Search colleges with optional filters.\n\nSupports filtering by location, cost, admissions, size, and programs/majors.\nThe 'major' parameter filters colleges that offer specific programs.\nThe 'program_category' parameter filters by CIP 2-digit category.\nSupports pagination via page/page_size or limit/offset.\nReturns list for backwards compatibility with tests.","operationId":"search_colleges_api_v1_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by college name","title":"Query"},"description":"Search by college name"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Two-letter US state code (e.g., 'VA')","title":"State"},"description":"Two-letter US state code (e.g., 'VA')"},{"name":"states","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by multiple states","title":"States"},"description":"Filter by multiple states"},{"name":"regions","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by US regions (Northeast, Southeast, Midwest, Southwest, West)","title":"Regions"},"description":"Filter by US regions (Northeast, Southeast, Midwest, Southwest, West)"},{"name":"min_tuition","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum in-state tuition","title":"Min Tuition"},"description":"Minimum in-state tuition"},{"name":"max_tuition","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum in-state tuition","title":"Max Tuition"},"description":"Maximum in-state tuition"},{"name":"min_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum average SAT score","title":"Min Sat"},"description":"Minimum average SAT score"},{"name":"max_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum average SAT score","title":"Max Sat"},"description":"Maximum average SAT score"},{"name":"min_admission_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum admission rate (0-1 scale)","title":"Min Admission Rate"},"description":"Minimum admission rate (0-1 scale)"},{"name":"max_admission_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum admission rate (0-1 scale)","title":"Max Admission Rate"},"description":"Maximum admission rate (0-1 scale)"},{"name":"major","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by major/program title or CIP code","title":"Major"},"description":"Filter by major/program title or CIP code"},{"name":"program_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by CIP 2-digit program category","title":"Program Category"},"description":"Filter by CIP 2-digit program category"},{"name":"min_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum undergraduate enrollment","title":"Min Size"},"description":"Minimum undergraduate enrollment"},{"name":"max_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum undergraduate enrollment","title":"Max Size"},"description":"Maximum undergraduate enrollment"},{"name":"institution_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by ownership. Accepted values: 'public'; 'private' (private nonprofit colleges only, never for-profit); 'for-profit' (private for-profit colleges); and 'private-nonprofit' (the same as 'private').","title":"Institution Type"},"description":"Filter by ownership. Accepted values: 'public'; 'private' (private nonprofit colleges only, never for-profit); 'for-profit' (private for-profit colleges); and 'private-nonprofit' (the same as 'private')."},{"name":"css_profile","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(requires|does_not_require)$"},{"type":"null"}],"description":"Filter by CSS Profile requirement: 'requires' (college needs the CSS Profile for institutional aid) or 'does_not_require' (does not, or unknown). Omit for any.","title":"Css Profile"},"description":"Filter by CSS Profile requirement: 'requires' (college needs the CSS Profile for institutional aid) or 'does_not_require' (does not, or unknown). Omit for any."},{"name":"max_default_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum 3-year cohort default rate (0-1 scale, e.g. 0.10 = 10%)","title":"Max Default Rate"},"description":"Maximum 3-year cohort default rate (0-1 scale, e.g. 0.10 = 10%)"},{"name":"max_airport_distance","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Max miles to nearest airport","title":"Max Airport Distance"},"description":"Max miles to nearest airport"},{"name":"max_city_distance","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Max miles to nearest major city (100k+ population)","title":"Max City Distance"},"description":"Max miles to nearest major city (100k+ population)"},{"name":"min_quality_score","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"description":"Minimum overall quality score (0-100)","title":"Min Quality Score"},"description":"Minimum overall quality score (0-100)"},{"name":"sort_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sort by: quality_score, outcomes, affordability, academics, safety, diversity, accessibility","title":"Sort By"},"description":"Sort by: quality_score, outcomes, affordability, academics, safety, diversity, accessibility"},{"name":"admission_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(safety|match|reach|far_reach)$"},{"type":"null"}],"description":"Filter by admission tier, computed against the supplied student inputs. Thinner input widens the underlying probability band; it does not change what the tier means.","title":"Admission Tier"},"description":"Filter by admission tier, computed against the supplied student inputs. Thinner input widens the underlying probability band; it does not change what the tier means."},{"name":"student_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1600,"minimum":400},{"type":"null"}],"description":"Student SAT score, used for admission_tier classification","title":"Student Sat"},"description":"Student SAT score, used for admission_tier classification"},{"name":"student_act","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":36,"minimum":1},{"type":"null"}],"description":"Student ACT score, used for admission_tier classification when SAT is absent","title":"Student Act"},"description":"Student ACT score, used for admission_tier classification when SAT is absent"},{"name":"student_gpa","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":4.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"description":"Student unweighted GPA (4.0 scale), used for admission_tier classification","title":"Student Gpa"},"description":"Student unweighted GPA (4.0 scale), used for admission_tier classification"},{"name":"student_state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Student two-letter state of residence. Enables the in-state public-university adjustment; omitted means it never fires.","title":"Student State"},"description":"Student two-letter state of residence. Enables the in-state public-university adjustment; omitted means it never fires."},{"name":"student_first_gen","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Student is first-generation, used for admission_tier classification","title":"Student First Gen"},"description":"Student is first-generation, used for admission_tier classification"},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page number (1-indexed)","title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Results per page","title":"Page Size"},"description":"Results per page"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":5000},{"type":"null"}],"description":"Maximum results to return","title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Number of records to skip","title":"Offset"},"description":"Number of records to skip"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CollegeOut"},"title":"Response Search Colleges Api V1 Colleges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/recommended":{"get":{"tags":["colleges"],"summary":"Get Recommended","description":"Get personalized college recommendations based on the student's profile,\noptionally filtered with the same parameters as /api/colleges and folded\nwith the user's recent saves + views (behavioral signals).","operationId":"get_recommended_api_v1_colleges_recommended_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Specific profile ID (defaults to primary profile)","title":"Profile Id"},"description":"Specific profile ID (defaults to primary profile)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":6,"title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"states","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by states","title":"States"},"description":"Filter by states"},{"name":"regions","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by US regions","title":"Regions"},"description":"Filter by US regions"},{"name":"min_tuition","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Tuition"}},{"name":"max_tuition","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tuition"}},{"name":"min_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat"}},{"name":"max_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Sat"}},{"name":"min_admission_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Admission Rate"}},{"name":"max_admission_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Admission Rate"}},{"name":"major","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Major"}},{"name":"program_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Category"}},{"name":"min_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Size"}},{"name":"max_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Size"}},{"name":"institution_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by ownership. Accepted values: 'public'; 'private' (private nonprofit colleges only, never for-profit); 'for-profit' (private for-profit colleges); and 'private-nonprofit' (the same as 'private').","title":"Institution Type"},"description":"Filter by ownership. Accepted values: 'public'; 'private' (private nonprofit colleges only, never for-profit); 'for-profit' (private for-profit colleges); and 'private-nonprofit' (the same as 'private')."},{"name":"css_profile","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(requires|does_not_require)$"},{"type":"null"}],"description":"Filter by CSS Profile requirement: 'requires' or 'does_not_require' (does not, or unknown). Omit for any.","title":"Css Profile"},"description":"Filter by CSS Profile requirement: 'requires' or 'does_not_require' (does not, or unknown). Omit for any."},{"name":"max_default_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Default Rate"}},{"name":"max_airport_distance","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Airport Distance"}},{"name":"max_city_distance","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max City Distance"}},{"name":"min_quality_score","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Quality Score"}},{"name":"admission_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(safety|match|reach|far_reach)$"},{"type":"null"}],"description":"Filter by admission tier computed against the student's profile","title":"Admission Tier"},"description":"Filter by admission tier computed against the student's profile"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedCollegesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/recommendation-breakdown":{"get":{"tags":["colleges"],"summary":"Get Recommendation Breakdown","description":"Why this college was recommended — the dimensions behind its score.\n\nOn demand rather than on every list row (#679). The recommendations service\ncaches rankings as `(id, score, tier, state)` tuples and hydrates pages\nwithout loading the `Profile`; computing a breakdown inline would add a\nprofile read to the cache-*hit* path, which is the path that service is\nbuilt to keep fast. The breakdown renders on tap, so it is fetched on tap.\n\nA computed fact, not a prediction (ARCHITECTURE.md §\"Inline predictions\"):\narithmetic over the student's stated profile and published college data.","operationId":"get_recommendation_breakdown_api_v1_colleges__college_id__recommendation_breakdown_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}},{"name":"profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Defaults to the primary profile","title":"Profile Id"},"description":"Defaults to the primary profile"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationBreakdown"}}}},"404":{"description":"College or profile not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/tiers":{"post":{"tags":["colleges"],"summary":"Get College Tiers","description":"Reach / match / safety tiers + probability bands for a set of colleges (#546).\n\nThe batch companion to every tier chip in the product. Deliberately a\nseparate authenticated call rather than fields on ``/colleges`` search:\na tier is student-relative, and the search response is public and\nISR-cached — folding a personalized field into it would either split the\ncache per profile or leak one student's tier to the next visitor. Per\nARCHITECTURE.md §\"Inline predictions\", personalized tiers stay client\nislands over anonymous cached pages.\n\nUnknown ids are omitted from ``tiers`` rather than 404-ing the batch: one\nstale id on a grid of twenty shouldn't blank the whole row of chips.","operationId":"get_college_tiers_api_v1_colleges_tiers_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeTiersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeTiersResponse"}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync":{"post":{"tags":["colleges"],"summary":"Trigger Sync","description":"Queue the College Scorecard sync (admins only).\n\nRuns ``sync_colleges_task`` over the whole fleet, the same work as the\nSunday beat run.","operationId":"trigger_sync_api_v1_colleges_sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync-ipeds":{"post":{"tags":["colleges"],"summary":"Trigger Ipeds Sync","description":"Queue the IPEDS latest-value pass (#712, admins only).","operationId":"trigger_ipeds_sync_api_v1_colleges_sync_ipeds_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync-clery":{"post":{"tags":["colleges"],"summary":"Trigger Clery Sync","description":"Queue the Clery Act campus crime statistics sync (admins only).","operationId":"trigger_clery_sync_api_v1_colleges_sync_clery_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync-transportation":{"post":{"tags":["colleges"],"summary":"Trigger Transportation Sync","description":"Queue the transportation and accessibility sync (admins only).","operationId":"trigger_transportation_sync_api_v1_colleges_sync_transportation_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync-place-ids":{"post":{"tags":["colleges"],"summary":"Trigger Place Id Sync","description":"Queue the Google Place ID sync for colleges without one (admins only).","operationId":"trigger_place_id_sync_api_v1_colleges_sync_place_ids_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/sync-colors":{"post":{"tags":["colleges"],"summary":"Trigger Color Sync","description":"Queue the school colors sync from Wikipedia (admins only).","operationId":"trigger_color_sync_api_v1_colleges_sync_colors_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/compute-quality-scores":{"post":{"tags":["colleges"],"summary":"Trigger Quality Scores","description":"Queue the composite quality score computation (admins only).","operationId":"trigger_quality_scores_api_v1_colleges_compute_quality_scores_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/stats/all-states":{"get":{"tags":["colleges"],"summary":"Get All State Statistics","description":"Get lightweight college statistics summaries for all US states.","operationId":"get_all_state_statistics_api_v1_colleges_stats_all_states_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/app__schemas__college_stats__StateSummary"},"title":"Response Get All State Statistics Api V1 Colleges Stats All States Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/stats/by-state/{state_code}":{"get":{"tags":["colleges"],"summary":"Get State Statistics","description":"Get detailed college statistics for a specific US state.","operationId":"get_state_statistics_api_v1_colleges_stats_by_state__state_code__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"state_code","in":"path","required":true,"schema":{"type":"string","description":"Two-letter US state code","title":"State Code"},"description":"Two-letter US state code"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateCollegeStats"}}}},"404":{"description":"Invalid state code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/suggest":{"get":{"tags":["colleges"],"summary":"Suggest Colleges Endpoint","description":"Typeahead suggestions for the colleges page.\n\nReturns a lean list of up to ``limit`` colleges ranked by relevance against ``q``.\nMatches on college name, known aliases (e.g. \"MIT\"), and city name. Unlike\n``GET /api/colleges``, this endpoint does **not** apply the full filter pipeline\nand returns only the fields needed to render a dropdown row.\n\nRoute ordering note: this must be declared **before** ``GET /{college_id}`` so\nFastAPI doesn't try to parse \"suggest\" as a UUID.","operationId":"suggest_colleges_endpoint_api_v1_colleges_suggest_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"description":"Partial college name, alias, or city","title":"Q"},"description":"Partial college name, alias, or city"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Max suggestions to return","default":8,"title":"Limit"},"description":"Max suggestions to return"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CollegeSuggestion"},"title":"Response Suggest Colleges Endpoint Api V1 Colleges Suggest Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/data-years":{"get":{"tags":["colleges"],"summary":"Get Data Years Endpoint","description":"What year each source's figures are from, per ``colleges`` column (#722).\n\nThe Scorecard and IPEDS syncs record these, so the comparison worksheet and\nthe Costs tab can say how recent a figure is without a year typed into copy.\nPublic and not personal, and the years change at most weekly, so browsers\nand the app may cache it for an hour.\n\nRoute ordering note: this must be declared **before** ``GET /{college_id}``,\nwhich would otherwise read \"data-years\" as a slug.","operationId":"get_data_years_endpoint_api_v1_colleges_data_years_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataYearsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}":{"get":{"tags":["colleges"],"summary":"Get College By Id","description":"Get detailed information about a specific college by ID or slug (#246).\n\nReturns college information including location, costs, admission statistics,\nand demographic data. Accepts both UUID and human-readable slug forms.\nAdds the detail-only ``has_trends`` flag (#571) so the frontend can\nsuppress dead-end trends links for zero-history colleges, and\n``published_subroutes`` (#885), the sub-routes the page may link to.","operationId":"get_college_by_id_api_v1_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeDetailOut"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/admissions-events":{"get":{"tags":["colleges"],"summary":"Get College Admissions Events","description":"Upcoming admissions events for a college (#612) — open houses, info\nsessions, tours — parsed from the school's own visit/admissions pages\nand linked back to the school's registration page.\n\nContract (ARCHITECTURE.md §\"Admissions Events → Public surfacing\"):\nupcoming only (``starts_at >= now``), tier-0 license-gated, recurring\nseries rolled up server-side (first future instance + ``instance_count``\n+ ``next_dates``), never inlined into the college detail payload. Empty\n``rows`` (200) when the college exists but nothing is on file — the\ncard falls back to its visit/admissions/apply links. Accepts UUID or slug.","operationId":"get_college_admissions_events_api_v1_colleges__college_id__admissions_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Maximum number of event series to return (upcoming only).","default":5,"title":"Limit"},"description":"Maximum number of event series to return (upcoming only)."},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":120,"minimum":1},{"type":"null"}],"description":"Only events in the next N days, with every date of a repeating event in that window, plus how far the college has posted (#806). Omit for the next events regardless of date.","title":"Days"},"description":"Only events in the next N days, with every date of a repeating event in that window, plus how far the college has posted (#806). Omit for the next events regardless of date."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAdmissionsEventsResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/programs":{"get":{"tags":["colleges"],"summary":"Get College Programs","description":"Get all programs/majors offered at a specific college (by ID or slug, #246).\n\nReturns programs with outcome data like median earnings and number of graduates.","operationId":"get_college_programs_api_v1_colleges__college_id__programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by program category","title":"Category"},"description":"Filter by program category"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CollegeProgramWithProgram"},"title":"Response Get College Programs Api V1 Colleges  College Id  Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/similar":{"get":{"tags":["colleges"],"summary":"Get Similar Colleges","description":"Find colleges similar to the specified college.\n\nSimilarity is calculated based on:\n- Institution size (±30% enrollment)\n- Tuition cost (±20% cost)\n- Location (same state or region)\n- Selectivity (±15% admission rate)\n- Program availability overlap\n\nReturns colleges with similarity scores and reasons.","operationId":"get_similar_colleges_api_v1_colleges__college_id__similar_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"description":"Maximum number of similar colleges to return","default":10,"title":"Limit"},"description":"Maximum number of similar colleges to return"},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","maximum":100,"minimum":0,"description":"Minimum similarity score threshold","default":30.0,"title":"Min Score"},"description":"Minimum similarity score threshold"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarCollegesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/net-price-context":{"get":{"tags":["colleges"],"summary":"Get Net Price Context","description":"Per-bracket net price + 3 peer-school comparison per bracket (#411).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/net-price``.\nSee ARCHITECTURE.md §\"Detail-page SEO sub-routes\" for the rendering\ncontract on the consuming Next.js page.","operationId":"get_net_price_context_api_v1_colleges__college_id__net_price_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetPriceContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/sat-context":{"get":{"tags":["colleges"],"summary":"Get Sat Context","description":"Per-school SAT bands + 3 peer schools (#414).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/sat``.","operationId":"get_sat_context_api_v1_colleges__college_id__sat_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestScoreContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/act-context":{"get":{"tags":["colleges"],"summary":"Get Act Context","description":"Per-school ACT bands + 3 peer schools (#414).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/act``.","operationId":"get_act_context_api_v1_colleges__college_id__act_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestScoreContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/improve-sat-context":{"get":{"tags":["colleges"],"summary":"Get Improve Sat Context","description":"Counter-factual SAT-improvement table (#414).\n\nCalls the #377 admissions-chance ``predict()`` server-side for a\nfixed grid of synthetic SAT profiles per school. Backs the\ndetail-page SEO sub-route at ``/colleges/[id]/improve-sat``.","operationId":"get_improve_sat_context_api_v1_colleges__college_id__improve_sat_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImproveSatContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/career-outcomes-context":{"get":{"tags":["colleges"],"summary":"Get Career Outcomes Context","description":"Per-school career outcomes — top-N majors + peers + projection bands (#416).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/career-outcomes``.\nCalls ``life_path.predict()`` server-side per row with a synthetic\nprofile; methodology page documents the synthetic profile choice.","operationId":"get_career_outcomes_context_api_v1_colleges__college_id__career_outcomes_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerOutcomesContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/trends-context":{"get":{"tags":["colleges"],"summary":"Get Trends Context","description":"Per-school multi-year trend series + 3 peer schools (#566).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/trends``.\nSeries come from ``college_stat_snapshots`` under the no-source-mixing\nrule; era breaks are annotated per ARCHITECTURE.md §\"College Statistics\nHistory (Trends, #566)\".","operationId":"get_trends_context_api_v1_colleges__college_id__trends_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendsContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/athletics-context":{"get":{"tags":["colleges"],"summary":"Get Athletics Context","description":"Per-school athletics aggregate — aid, participation, sports, peers (#268).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/athletics``.\nEADA-spine aggregate enriched by scraped ``athletic_programs``; per-sport\nStage 2.5 (``/colleges/[id]/athletics/[sport]``) is deferred per\nARCHITECTURE.md §\"Sub-route segment discipline\".","operationId":"get_athletics_context_api_v1_colleges__college_id__athletics_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticsContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/campus-life-context":{"get":{"tags":["colleges"],"summary":"Get Campus Life Context","description":"Per-school campus-life — gated synthesis + peers + indexability (#268).\n\nBacks the detail-page SEO sub-route at ``/colleges/[id]/campus-life``.\nSurfaces the #317 synthesized profile via the shared license gate\n(``college_synthesis.build_synthesis_response``); ``indexable`` reflects\nthe anonymous render predicate per ARCHITECTURE.md §\"Synthesized content\non sub-routes\".","operationId":"get_campus_life_context_api_v1_colleges__college_id__campus_life_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampusLifeContextResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/nearby":{"get":{"tags":["colleges"],"summary":"Get Nearby Colleges","description":"Find colleges near the specified college based on geographic distance.\n\nUses the Haversine formula to calculate distances between colleges.\nReturns colleges sorted by distance (closest first) within the specified radius.\nAccepts both UUID and slug forms for the path param (#246).\n\nArgs:\n    college: Resolved College row (via UUID or slug)\n    limit: Maximum number of nearby colleges to return (default: 10, max: 50)\n    radius_miles: Search radius in miles (default: 50, max: 500)\n\nReturns:\n    List of nearby colleges with their distances in miles","operationId":"get_nearby_colleges_api_v1_colleges__college_id__nearby_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"description":"Maximum number of nearby colleges to return","default":10,"title":"Limit"},"description":"Maximum number of nearby colleges to return"},{"name":"radius_miles","in":"query","required":false,"schema":{"type":"number","maximum":500,"minimum":1,"description":"Search radius in miles","default":50.0,"title":"Radius Miles"},"description":"Search radius in miles"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NearbyCollegesResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/suggested-nearby":{"get":{"tags":["colleges"],"summary":"Get Suggested Nearby","description":"Profile-ranked schools similar to and near this college (#503).\n\nThe authed sibling of ``/nearby``: same Haversine radius search, but\nranked by the caller's profile fit (with an anchor-likeness blend) and\nannotated with tier + fit blurb. The public distance-only ``/nearby``\nstays unchanged for anonymous surfaces. Excludes the anchor itself and\ncolleges the student marked not interested.","operationId":"get_suggested_nearby_api_v1_colleges__college_id__suggested_nearby_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"radius_miles","in":"query","required":false,"schema":{"type":"number","maximum":500,"minimum":1,"description":"Search radius in miles","default":50.0,"title":"Radius Miles"},"description":"Search radius in miles"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":12,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NearbySuggestionOut"},"title":"Response Get Suggested Nearby Api V1 Colleges  College Id  Suggested Nearby Get"}}}},"400":{"description":"College has no location data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/synthesis":{"get":{"tags":["colleges","synthesis"],"summary":"Cited synthesis profile for one college","description":"Return the synthesized college profile, gated by license + auth.\n\nCache: 1h, keyed on ``(college_id, auth_state, prompt_version)`` so\nanonymous and authenticated callers never share an entry. Busted at\nsynthesis-write time by ``invalidate_synthesis_cache`` in\n``services/cache.py`` (called from the synthesis task once the\nupserted row is committed). The read + license gate itself lives in\n``services/college_synthesis.build_synthesis_response``.","operationId":"get_college_synthesis_api_v1_colleges__college_id__synthesis_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/colleges/{college_id}/media":{"get":{"tags":["colleges"],"summary":"Get College Media Public","description":"Public read of a college's media library.\n\nFilter contract:\n  - License must be in MEDIA_TIER0_PUBLIC_LICENSES (cc0 / cc_by_4 /\n    wikimedia / official_pr) — fair_use_excerpt and unknown rows\n    are admin-only, never surfaced publicly.\n  - Sorted by ``ordering ASC, created_at ASC`` for deterministic\n    gallery render.\n  - Empty list (200) when the college exists but has no license-\n    clean rows — the frontend renders a \"no media available yet\"\n    state rather than 404'ing the whole page.\n\nReturns 404 only when the college itself doesn't exist.","operationId":"get_college_media_public_api_v1_colleges__college_id__media_get","parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMediaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:colleges"]}},"/api/v1/programs":{"get":{"tags":["programs"],"summary":"List Programs","description":"List all programs with optional filters.\n\nSupports filtering by category and CIP code hierarchy.","operationId":"list_programs_api_v1_programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by category","title":"Category"},"description":"Filter by category"},{"name":"cip_2_digit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by 2-digit CIP code","title":"Cip 2 Digit"},"description":"Filter by 2-digit CIP code"},{"name":"cip_4_digit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by 4-digit CIP code","title":"Cip 4 Digit"},"description":"Filter by 4-digit CIP code"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"description":"Maximum results","default":100,"title":"Limit"},"description":"Maximum results"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Pagination offset","default":0,"title":"Offset"},"description":"Pagination offset"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramOut"},"title":"Response List Programs Api V1 Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/search":{"get":{"tags":["programs"],"summary":"Search Programs","description":"Search programs by title or CIP code (anonymous-readable, #505).\n\nExample: /programs/search?q=engineering","operationId":"search_programs_api_v1_programs_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query (title or CIP code)","title":"Q"},"description":"Search query (title or CIP code)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Maximum results to return","default":20,"title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramOut"},"title":"Response Search Programs Api V1 Programs Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/categories":{"get":{"tags":["programs"],"summary":"List Categories","description":"Get all program categories with program counts (anonymous-readable, #505).\n\nReturns the 2-digit CIP categories (e.g., Engineering, Business).","operationId":"list_categories_api_v1_programs_categories_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramCategoryOut"},"title":"Response List Categories Api V1 Programs Categories Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/popular":{"get":{"tags":["programs"],"summary":"Get Popular Programs","description":"Get most popular programs (offered by most colleges) (anonymous-readable, #505).\n\nReturns programs ranked by number of colleges offering them.","operationId":"get_popular_programs_api_v1_programs_popular_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Maximum results","default":20,"title":"Limit"},"description":"Maximum results"},{"name":"min_colleges","in":"query","required":false,"schema":{"type":"integer","description":"Minimum colleges offering program","default":10,"title":"Min Colleges"},"description":"Minimum colleges offering program"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramWithOutcomes"},"title":"Response Get Popular Programs Api V1 Programs Popular Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/highest-earning":{"get":{"tags":["programs"],"summary":"Get Highest Earning Programs","description":"Get programs with highest median earnings (anonymous-readable, #505).\n\nReturns programs ranked by average median earnings across colleges.","operationId":"get_highest_earning_programs_api_v1_programs_highest_earning_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Maximum results","default":20,"title":"Limit"},"description":"Maximum results"},{"name":"min_colleges","in":"query","required":false,"schema":{"type":"integer","description":"Minimum colleges offering program","default":5,"title":"Min Colleges"},"description":"Minimum colleges offering program"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramWithOutcomes"},"title":"Response Get Highest Earning Programs Api V1 Programs Highest Earning Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/{identifier}":{"get":{"tags":["programs"],"summary":"Get Program","description":"Get a program by UUID or slug with aggregated statistics (anonymous-readable, #418).\n\nReturns program details plus stats like total colleges offering it,\naverage earnings, and total graduates.","operationId":"get_program_api_v1_programs__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","description":"Program UUID or slug","title":"Identifier"},"description":"Program UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramWithOutcomes"}}}},"404":{"description":"Program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/{identifier}/colleges":{"get":{"tags":["programs"],"summary":"Get Colleges Offering Program","description":"Get colleges offering a program (by UUID or slug) with outcome data (anonymous-readable, #418).\n\nReturns a list of colleges with program metrics like graduates and earnings.\nOptionally filter by search query.","operationId":"get_colleges_offering_program_api_v1_programs__identifier__colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","description":"Program UUID or slug","title":"Identifier"},"description":"Program UUID or slug"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"description":"Maximum results to return","default":100,"title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search colleges by name, city, or state","title":"Search"},"description":"Search colleges by name, city, or state"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CollegeWithProgramData"},"title":"Response Get Colleges Offering Program Api V1 Programs  Identifier  Colleges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/cip/{cip_code}":{"get":{"tags":["programs"],"summary":"Get Program By Cip","description":"Get a program by CIP code with statistics.\n\nExample: /programs/cip/14.1001","operationId":"get_program_by_cip_api_v1_programs_cip__cip_code__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cip_code","in":"path","required":true,"schema":{"type":"string","description":"CIP code (e.g., 14.1001)","title":"Cip Code"},"description":"CIP code (e.g., 14.1001)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramWithOutcomes"}}}},"404":{"description":"Program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/cip/{cip_code}/colleges":{"get":{"tags":["programs"],"summary":"Get Colleges By Cip","description":"Get all colleges offering a program by CIP code.\n\nExample: /programs/cip/14.1001/colleges","operationId":"get_colleges_by_cip_api_v1_programs_cip__cip_code__colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cip_code","in":"path","required":true,"schema":{"type":"string","description":"CIP code (e.g., 14.1001)","title":"Cip Code"},"description":"CIP code (e.g., 14.1001)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"description":"Maximum results to return","default":100,"title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CollegeOut"},"title":"Response Get Colleges By Cip Api V1 Programs Cip  Cip Code  Colleges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/category/{cip_2_digit}":{"get":{"tags":["programs"],"summary":"Get Programs By Category","description":"Get all programs in a specific category (by 2-digit CIP code)\n(anonymous-readable, #505).\n\nReturns programs with statistics including college counts and earnings.\nSupports optional search filtering.\n\nExample: /programs/category/14","operationId":"get_programs_by_category_api_v1_programs_category__cip_2_digit__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cip_2_digit","in":"path","required":true,"schema":{"type":"string","description":"2-digit CIP category code","title":"Cip 2 Digit"},"description":"2-digit CIP category code"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"description":"Maximum results","default":100,"title":"Limit"},"description":"Maximum results"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Pagination offset","default":0,"title":"Offset"},"description":"Pagination offset"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search programs by title","title":"Search"},"description":"Search programs by title"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramWithOutcomes"},"title":"Response Get Programs By Category Api V1 Programs Category  Cip 2 Digit  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/programs/{identifier}/occupations":{"get":{"tags":["programs"],"summary":"Get Program Occupations","description":"Get career paths (occupations) for a program (by UUID or slug) (anonymous-readable, #418).\n\nReturns occupations linked to this program via CIP-SOC crosswalk,\nincluding BLS wage data and employment outlook. The crosswalk links 6-digit\nprograms, so a 4-digit program returns its 6-digit children's careers,\neach occupation once (#773).\n\nExample: /programs/<slug>/occupations","operationId":"get_program_occupations_api_v1_programs__identifier__occupations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","description":"Program UUID or slug","title":"Identifier"},"description":"Program UUID or slug"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProgramOccupationOut"},"title":"Response Get Program Occupations Api V1 Programs  Identifier  Occupations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:programs"]}},"/api/v1/saved-colleges/deadlines":{"get":{"tags":["saved-colleges"],"summary":"Get Deadlines Dashboard","description":"Get all saved colleges with deadline information for the dashboard.","operationId":"get_deadlines_dashboard_api_v1_saved_colleges_deadlines_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedCollegeOut"},"title":"Response Get Deadlines Dashboard Api V1 Saved Colleges Deadlines Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-colleges/admissions-events":{"get":{"tags":["saved-colleges"],"summary":"Get Saved Colleges Admissions Events","description":"Upcoming admissions events across the student's saved colleges (#696).\n\nThe open houses, tours and info sessions their own shortlist is running,\nin date order — the cross-school view `/colleges/{id}/admissions-events`\ncannot give, and the reason `/visits` is where it lives.\n\nReads through ``admissions_events.read`` like every other events surface\n(ARCHITECTURE.md §\"Admissions Events\"), so the #615 title gate, the tier-0\nlicense filter and the series rollup are applied once, in one place. The\nfan-out is **batched**: two queries total — saved colleges, then every\ncollege's events at once — not two per saved college.\n\nRead-only, and scoped to the caller's own profile by ``get_current_profile``.","operationId":"get_saved_colleges_admissions_events_api_v1_saved_colleges_admissions_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum number of events to return across all saved colleges.","default":20,"title":"Limit"},"description":"Maximum number of events to return across all saved colleges."},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":120,"minimum":1},{"type":"null"}],"description":"Only events in the next N days (#806): up to 5 event series per college and 150 rows, plus a per-college summary of how far each school has posted.","title":"Days"},"description":"Only events in the next N days (#806): up to 5 event series per college and 150 rows, plus a per-college summary of how far each school has posted."},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedCollegesAdmissionsEventsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-colleges":{"get":{"tags":["saved-colleges"],"summary":"List Saved Colleges","description":"List all saved colleges for the current profile.\n\nReturns colleges ordered by ranking (if set), then by date saved.","operationId":"list_saved_colleges_api_v1_saved_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedCollegeOut"},"title":"Response List Saved Colleges Api V1 Saved Colleges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["saved-colleges"],"summary":"Save College","description":"Save a college to the current profile.\n\n``college_id`` accepts either a UUID or a slug (#246).\nReturns 409 if the college is already saved.","operationId":"save_college_api_v1_saved_colleges_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCollegeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedCollegeOut"}}}},"409":{"description":"College already saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-colleges/{saved_id}":{"patch":{"tags":["saved-colleges"],"summary":"Update Saved College","description":"Update notes, status, or ranking for a saved college.","operationId":"update_saved_college_api_v1_saved_colleges__saved_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"saved_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved college record UUID","title":"Saved Id"},"description":"Saved college record UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSavedCollegeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedCollegeOut"}}}},"404":{"description":"Saved college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["saved-colleges"],"summary":"Remove Saved College","description":"Remove a college from the saved list.","operationId":"remove_saved_college_api_v1_saved_colleges__saved_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"saved_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved college record UUID","title":"Saved Id"},"description":"Saved college record UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Saved college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-colleges/update-rankings":{"post":{"tags":["saved-colleges"],"summary":"Bulk Update Rankings","description":"Update rankings for multiple saved colleges at once.","operationId":"bulk_update_rankings_api_v1_saved_colleges_update_rankings_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateRankingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedCollegeOut"},"title":"Response Bulk Update Rankings Api V1 Saved Colleges Update Rankings Post"}}}},"404":{"description":"One or more colleges not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-colleges/bulk-delete":{"post":{"tags":["saved-colleges"],"summary":"Bulk Delete Saved Colleges","description":"Delete multiple saved colleges at once.","operationId":"bulk_delete_saved_colleges_api_v1_saved_colleges_bulk_delete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-searches":{"get":{"tags":["saved-searches"],"summary":"List Saved Searches","description":"The profile's saved searches for one page, most recently used first.","operationId":"list_saved_searches_api_v1_saved_searches_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"surface","in":"query","required":true,"schema":{"enum":["colleges","scholarships","merit_scholarships","athletics"],"type":"string","description":"The list page the searches belong to","title":"Surface"},"description":"The list page the searches belong to"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedSearchOut"},"title":"Response List Saved Searches Api V1 Saved Searches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["saved-searches"],"summary":"Create Saved Search","description":"Save the page's current filters under a name.\n\nThe query string is rebuilt from the page's allowed filter keys; a save\nleft with no filters (only a sort, or nothing) is refused.","operationId":"create_saved_search_api_v1_saved_searches_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchOut"}}}},"409":{"description":"Name taken, or the surface is full","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"No filters to save","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/saved-searches/{search_id}":{"patch":{"tags":["saved-searches"],"summary":"Rename Saved Search","description":"Rename a saved search.","operationId":"rename_saved_search_api_v1_saved_searches__search_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved search UUID","title":"Search Id"},"description":"Saved search UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchRename"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchOut"}}}},"404":{"description":"Saved search not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Name taken, or the surface is full","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["saved-searches"],"summary":"Delete Saved Search","description":"Delete a saved search.","operationId":"delete_saved_search_api_v1_saved_searches__search_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved search UUID","title":"Search Id"},"description":"Saved search UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Saved search not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/saved-searches/{search_id}/apply":{"post":{"tags":["saved-searches"],"summary":"Apply Saved Search","description":"Mark a saved search as used and return its query string to open.","operationId":"apply_saved_search_api_v1_saved_searches__search_id__apply_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved search UUID","title":"Search Id"},"description":"Saved search UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedSearchOut"}}}},"404":{"description":"Saved search not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments":{"get":{"tags":["event-commitments"],"summary":"List Event Commitments","description":"The student's \"I'm going\" list, soonest first, with what the school's\nlisting currently says about each — and whether this viewer may change it.","operationId":"list_event_commitments_api_v1_event_commitments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCommitmentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["event-commitments"],"summary":"Create Event Commitment","description":"Say \"I'm going\" to one event date. Idempotent: repeating it returns the\nexisting commitment (200) and updates ``intent`` if one is given.","operationId":"create_event_commitment_api_v1_event_commitments_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCommitmentCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCommitmentOut"}}}},"200":{"description":"Already going — the existing commitment"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments/calendar-subscriptions":{"get":{"tags":["event-commitments"],"summary":"List Calendar Subscriptions","description":"The student's calendar links, by prefix. Never the token.","operationId":"list_calendar_subscriptions_api_v1_event_commitments_calendar_subscriptions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CalendarSubscriptionOut"},"title":"Response List Calendar Subscriptions Api V1 Event Commitments Calendar Subscriptions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["event-commitments"],"summary":"Create Calendar Subscription","description":"\"Keep my calendar updated\": a new link a calendar subscribes to. The\ntoken is in the response once and is never stored or shown again.","operationId":"create_calendar_subscription_api_v1_event_commitments_calendar_subscriptions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarSubscriptionCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments/calendar-subscriptions/{subscription_id}":{"delete":{"tags":["event-commitments"],"summary":"Delete Calendar Subscription","description":"Stop updating: the link stops working at once, for every calendar using it.","operationId":"delete_calendar_subscription_api_v1_event_commitments_calendar_subscriptions__subscription_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Subscription Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments/{commitment_id}":{"patch":{"tags":["event-commitments"],"summary":"Update Event Commitment","description":"Change what the student said — interested or registered.","operationId":"update_event_commitment_api_v1_event_commitments__commitment_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Commitment Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCommitmentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCommitmentOut"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["event-commitments"],"summary":"Delete Event Commitment","description":"No longer going.","operationId":"delete_event_commitment_api_v1_event_commitments__commitment_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Commitment Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments/{commitment_id}/calendar-links":{"post":{"tags":["event-commitments"],"summary":"Create Calendar Links","description":"\"Add to my calendar\": a five-minute calendar-file link and a Google\nCalendar link for one commitment.","operationId":"create_calendar_links_api_v1_event_commitments__commitment_id__calendar_links_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Commitment Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarLinksOut"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/event-commitments/{commitment_id}/calendar.ics":{"get":{"tags":["event-commitments"],"summary":"Download Calendar File","description":"The calendar file behind a signed link. No auth header — see the module\ndocstring. Every failure is the same 404 — including a malformed or missing\nparameter, which FastAPI validation would otherwise answer with a 422 — so\nthe route is not an oracle for which commitment ids exist or which links\nhave expired.","operationId":"download_calendar_file_api_v1_event_commitments__commitment_id__calendar_ics_get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","title":"Commitment Id"}},{"name":"exp","in":"query","required":false,"schema":{"type":"string","default":"","title":"Exp"}},{"name":"sig","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sig"}}],"responses":{"200":{"description":"Successful Response"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/itineraries":{"get":{"tags":["itineraries"],"summary":"List Itineraries","description":"List the current profile's itineraries, most recently updated first.","operationId":"list_itineraries_api_v1_itineraries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ItinerarySummaryOut"},"title":"Response List Itineraries Api V1 Itineraries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["itineraries"],"summary":"Create Itinerary","description":"Create an itinerary, optionally seeded with colleges in stop order.\n\n``college_ids`` entries accept UUIDs or slugs (#246 convention).","operationId":"create_itinerary_api_v1_itineraries_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}":{"get":{"tags":["itineraries"],"summary":"Get Itinerary","description":"Fetch one itinerary with hydrated stops, contacts, and fit blurbs.","operationId":"get_itinerary_api_v1_itineraries__itinerary_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["itineraries"],"summary":"Update Itinerary","description":"Update name or trip config. Config changes mark the route stale.","operationId":"update_itinerary_api_v1_itineraries__itinerary_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["itineraries"],"summary":"Delete Itinerary","operationId":"delete_itinerary_api_v1_itineraries__itinerary_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}/suggestions":{"get":{"tags":["itineraries"],"summary":"Get Suggestions","description":"Profile-ranked schools near the trip (#503) — \"Expand this trip\".\n\nUnion of per-stop radius searches, ranked by fit (read-only; adding a\nresult goes through the normal POST /stops gate). Excludes colleges\nalready on the trip and ones the student marked not interested.","operationId":"get_suggestions_api_v1_itineraries__itinerary_id__suggestions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"radius_miles","in":"query","required":false,"schema":{"type":"number","maximum":500,"minimum":1,"default":50.0,"title":"Radius Miles"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":12,"title":"Limit"}},{"name":"anchor_stop_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Narrow the search to one stop's surroundings","title":"Anchor Stop Id"},"description":"Narrow the search to one stop's surroundings"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NearbySuggestionOut"},"title":"Response Get Suggestions Api V1 Itineraries  Itinerary Id  Suggestions Get"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}/stops":{"post":{"tags":["itineraries"],"summary":"Add Stop","description":"Append a college to the itinerary. Marks the route stale.","operationId":"add_stop_api_v1_itineraries__itinerary_id__stops_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}/stops/{stop_id}":{"patch":{"tags":["itineraries"],"summary":"Update Stop","description":"Update a stop's notes (position changes go through /stops/reorder).\n\nAn explicit ``notes: null`` clears the note; omitting it is a no-op.","operationId":"update_stop_api_v1_itineraries__itinerary_id__stops__stop_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"stop_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Stop Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["itineraries"],"summary":"Remove Stop","description":"Remove a stop; remaining stops re-compact. Marks the route stale.","operationId":"remove_stop_api_v1_itineraries__itinerary_id__stops__stop_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"stop_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Stop Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}/stops/reorder":{"post":{"tags":["itineraries"],"summary":"Reorder Stops","description":"Bulk-set stop positions (a dense 0..N-1 permutation of every stop).","operationId":"reorder_stops_api_v1_itineraries__itinerary_id__stops_reorder_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopsReorderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/itineraries/{itinerary_id}/route":{"put":{"tags":["itineraries"],"summary":"Set Route","description":"Persist the client-computed route cache and clear ``route_stale``.\n\nLegs must cover every stop exactly once (422 otherwise).","operationId":"set_route_api_v1_itineraries__itinerary_id__route_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"itinerary_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Itinerary Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItineraryOut"}}}},"404":{"description":"Itinerary, stop, or college not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"College already on the itinerary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/scholarships":{"get":{"tags":["scholarships"],"summary":"List Scholarships","description":"List scholarships with optional search and filtering.\n\n``search`` is a case-insensitive substring match across name / provider /\ndescription (the admin curation surface relies on substring, not full-text;\nranked full-text search lives on the dedicated ``GET /search`` endpoint).\nResults are ordered by most-recently-updated.","operationId":"list_scholarships_api_v1_scholarships_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":50,"title":"Limit"},"description":"Maximum results to return"},{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Is Active"},"description":"Filter by active status"},{"name":"verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by verified status","title":"Verified"},"description":"Filter by verified status"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring search across name, provider, and description","title":"Search"},"description":"Substring search across name, provider, and description"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ScholarshipOut"},"title":"Response List Scholarships Api V1 Scholarships Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"post":{"tags":["scholarships"],"summary":"Create Scholarship","description":"Create a new scholarship (admin-only, JWT).\n\nReturns 409 when a scholarship with the same normalized ``name|provider``\nalready exists (enforced by the ``dedup_key`` unique index).","operationId":"create_scholarship_api_v1_scholarships_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipOut"}}}},"409":{"description":"Duplicate name + provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/search":{"get":{"tags":["scholarships"],"summary":"Search Scholarships","description":"Advanced scholarship search with multiple filters.\nReturns scholarships with total count for pagination.","operationId":"search_scholarships_api_v1_scholarships_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query for name, provider, or description","title":"Q"},"description":"Search query for name, provider, or description"},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page number (1-indexed)","title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Results per page","title":"Page Size"},"description":"Results per page"},{"name":"skip","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Number of records to skip","title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum results to return","title":"Limit"},"description":"Maximum results to return"},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum award amount","title":"Min Amount"},"description":"Minimum award amount"},{"name":"max_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum award amount","title":"Max Amount"},"description":"Maximum award amount"},{"name":"min_gpa","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Student's GPA - filters scholarships they qualify for","title":"Min Gpa"},"description":"Student's GPA - filters scholarships they qualify for"},{"name":"provider_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider type (federal, state, private, etc.)","title":"Provider Type"},"description":"Provider type (federal, state, private, etc.)"},{"name":"merit_based","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by merit-based","title":"Merit Based"},"description":"Filter by merit-based"},{"name":"need_based","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by need-based","title":"Need Based"},"description":"Filter by need-based"},{"name":"renewable","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by renewable scholarships","title":"Renewable"},"description":"Filter by renewable scholarships"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by state (e.g., 'CA', 'TX')","title":"State"},"description":"Filter by state (e.g., 'CA', 'TX')"},{"name":"major","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by major/field of study (deprecated - use majors)","title":"Major"},"description":"Filter by major/field of study (deprecated - use majors)"},{"name":"majors","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Filter by majors/fields of study (can specify multiple)","title":"Majors"},"description":"Filter by majors/fields of study (can specify multiple)"},{"name":"grade_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by education level (9, 10, 11, 12, undergraduate, graduate)","title":"Grade Level"},"description":"Filter by education level (9, 10, 11, 12, undergraduate, graduate)"},{"name":"extracurricular","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by extracurricular activity","title":"Extracurricular"},"description":"Filter by extracurricular activity"},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","description":"Sort by: relevance, amount, deadline, name","default":"relevance","title":"Sort By"},"description":"Sort by: relevance, amount, deadline, name"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/count":{"get":{"tags":["scholarships"],"summary":"Get Scholarship Count","description":"Get total count of scholarships.","operationId":"get_scholarship_count_api_v1_scholarships_count_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by active status","title":"Is Active"},"description":"Filter by active status"},{"name":"verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by verified status","title":"Verified"},"description":"Filter by verified status"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/browse":{"get":{"tags":["scholarships"],"summary":"Browse Scholarships","description":"One page of the A–Z scholarship index (#885), 200 per page.\n\nActive scholarships ordered by name. Public: it's the crawl path to every\nscholarship page (ARCHITECTURE.md §\"Crawl paths\"). Out-of-range → 404.","operationId":"browse_scholarships_api_v1_scholarships_browse_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page of the A–Z index","default":1,"title":"Page"},"description":"1-based page of the A–Z index"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipBrowsePage"}}}},"404":{"description":"Page out of range","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/saved":{"post":{"tags":["scholarships"],"summary":"Save Scholarship","description":"Save a scholarship: create the student's tracked row for it (#768).\n\nOne row per scholarship, status `saved`, in the table My Applications, the\ndashboard widgets and Scholarship Scout read. Saving twice returns the row\nthat already exists rather than failing: two taps of the heart, or a save\nafter Mission Control saved the same scholarship, is not an error to show\na student. Two saves racing into the unique index are decided by it, and\nthe loser answers with the winner's row (``scholarship_list.save_scholarship``).","operationId":"save_scholarship_api_v1_scholarships_saved_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipOut"}}}},"404":{"description":"Scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"get":{"tags":["scholarships"],"summary":"List Saved Scholarships","description":"The student's tracked scholarships — what the Saved page lists (#768).\n\nEvery status, including `not_interested`: a scholarship the student\ndismissed stays on their own list and only drops out of suggestions, the\nsame rule colleges follow (#770).","operationId":"list_saved_scholarships_api_v1_scholarships_saved_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status Filter"},"description":"Filter by status"},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","description":"Sort by: created_at, ranking, deadline","default":"created_at","title":"Sort By"},"description":"Sort by: created_at, ranking, deadline"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedScholarshipWithDetails"},"title":"Response List Saved Scholarships Api V1 Scholarships Saved Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/saved/{saved_id}":{"get":{"tags":["scholarships"],"summary":"Get Saved Scholarship","description":"Get a specific saved scholarship.","operationId":"get_saved_scholarship_api_v1_scholarships_saved__saved_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"saved_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved scholarship UUID","title":"Saved Id"},"description":"Saved scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipWithDetails"}}}},"404":{"description":"Saved scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"patch":{"tags":["scholarships"],"summary":"Update Saved Scholarship","description":"Update a saved scholarship (ranking, notes, status).","operationId":"update_saved_scholarship_api_v1_scholarships_saved__saved_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"saved_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved scholarship UUID","title":"Saved Id"},"description":"Saved scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipOut"}}}},"404":{"description":"Saved scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"delete":{"tags":["scholarships"],"summary":"Delete Saved Scholarship","description":"Remove a scholarship from the student's list.\n\n**A row the student has done work on is kept, not deleted** (#768). Since a\nsave and an application are one row, deleting would cascade away the\nCo-pilot checklist they've been ticking off — an amount of work one tap\nshouldn't be able to destroy. Such a row is marked `not_interested`\ninstead: off the suggestions and out of the deadline cards, with the\nchecklist intact if they change their mind. The response says which\nhappened — 204 when the row was removed, 200 with the row when it was kept.","operationId":"delete_saved_scholarship_api_v1_scholarships_saved__saved_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"saved_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Saved scholarship UUID","title":"Saved Id"},"description":"Saved scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"200":{"description":"Kept as not interested: the row had work on it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedScholarshipOut"}}}},"204":{"description":"Removed"},"404":{"description":"Saved scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/{scholarship_id}/is-saved":{"get":{"tags":["scholarships"],"summary":"Check If Saved","description":"Check if a scholarship is saved by the current user.","operationId":"check_if_saved_api_v1_scholarships__scholarship_id__is_saved_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipSavedStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/applications":{"get":{"tags":["scholarships"],"summary":"List User Applications","description":"Get all scholarship applications for the current user.","operationId":"list_user_applications_api_v1_scholarships_applications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status Filter"},"description":"Filter by status"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ScholarshipApplicationWithDetails"},"title":"Response List User Applications Api V1 Scholarships Applications Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"post":{"tags":["scholarships"],"summary":"Create Application","description":"Save/track a scholarship application.","operationId":"create_application_api_v1_scholarships_applications_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipApplicationCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipApplicationOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/{scholarship_id}":{"get":{"tags":["scholarships"],"summary":"Get Scholarship","description":"Get a specific scholarship by ID.","operationId":"get_scholarship_api_v1_scholarships__scholarship_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipOut"}}}},"404":{"description":"Scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"patch":{"tags":["scholarships"],"summary":"Update Scholarship","description":"Update a scholarship (admin-only, JWT).","operationId":"update_scholarship_api_v1_scholarships__scholarship_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipOut"}}}},"404":{"description":"Scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"delete":{"tags":["scholarships"],"summary":"Delete Scholarship","description":"Delete a scholarship (admin-only, JWT).","operationId":"delete_scholarship_api_v1_scholarships__scholarship_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/{scholarship_id}/apply-redirect":{"get":{"tags":["scholarships"],"summary":"Apply Redirect","description":"Redirect (302) to a scholarship's provider URL, recording a server-side click.\n\nThe destination is **DB-sourced**: ``target`` only selects between the two\nstored ``Scholarship`` fields (validated against a literal set) — it never\ncarries a URL, so there is no user-controlled-URL open-redirect vector. The\nresolved URL still passes a scheme + public-host check (``is_safe_external_url``)\nas defense-in-depth against stale/poisoned scraped data. Attribution is written\nfail-open before the redirect. No affiliate rewrite (reserved hook, not built).","operationId":"apply_redirect_api_v1_scholarships__scholarship_id__apply_redirect_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"target","in":"query","required":false,"schema":{"enum":["application_url","information_url"],"type":"string","description":"Which stored provider URL to open; falls back to the other if empty/invalid.","default":"application_url","title":"Target"},"description":"Which stored provider URL to open; falls back to the other if empty/invalid."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"302":{"description":"Redirect to the provider's application/info page"},"404":{"description":"Scholarship or a valid target URL not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/bulk-delete":{"post":{"tags":["scholarships"],"summary":"Bulk Delete Scholarships","description":"Delete multiple scholarships (admin-only, JWT).","operationId":"bulk_delete_scholarships_api_v1_scholarships_bulk_delete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"title":"Scholarship Ids"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/match":{"post":{"tags":["scholarships"],"summary":"Match Scholarships","description":"Find scholarships matching a student's profile.\nReturns scholarships with match scores and reasons.\nSupports pagination via limit and offset parameters.","operationId":"match_scholarships_api_v1_scholarships_match_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum matches to return","default":50,"title":"Limit"},"description":"Maximum matches to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ScholarshipMatch"},"title":"Response Match Scholarships Api V1 Scholarships Match Post"}}}},"404":{"description":"Scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/applications/{application_id}":{"get":{"tags":["scholarships"],"summary":"Get Application","description":"Get a specific scholarship application.","operationId":"get_application_api_v1_scholarships_applications__application_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Application UUID","title":"Application Id"},"description":"Application UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipApplicationWithDetails"}}}},"404":{"description":"Application not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"patch":{"tags":["scholarships"],"summary":"Update Application","description":"Update a scholarship application.","operationId":"update_application_api_v1_scholarships_applications__application_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Application UUID","title":"Application Id"},"description":"Application UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipApplicationUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipApplicationOut"}}}},"404":{"description":"Application not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"delete":{"tags":["scholarships"],"summary":"Delete Application","description":"Delete a scholarship application.\n\nTakes the scholarship off the student's list, so its deadline card goes\nthe same session (#703's rule, missing on this path until #863) and the\nremoval is audited.","operationId":"delete_application_api_v1_scholarships_applications__application_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Application UUID","title":"Application Id"},"description":"Application UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Application not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/applications/{application_id}/requirements":{"post":{"tags":["scholarships"],"summary":"Create Requirement","description":"Add a requirement to a scholarship application.","operationId":"create_requirement_api_v1_scholarships_applications__application_id__requirements_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Application UUID","title":"Application Id"},"description":"Application UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationRequirementCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationRequirementOut"}}}},"404":{"description":"Application not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]},"get":{"tags":["scholarships"],"summary":"List Requirements","description":"Get all requirements for a scholarship application.","operationId":"list_requirements_api_v1_scholarships_applications__application_id__requirements_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Application UUID","title":"Application Id"},"description":"Application UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationRequirementOut"},"title":"Response List Requirements Api V1 Scholarships Applications  Application Id  Requirements Get"}}}},"404":{"description":"Application not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/scholarships/requirements/{requirement_id}":{"patch":{"tags":["scholarships"],"summary":"Update Requirement","description":"Update an application requirement.","operationId":"update_requirement_api_v1_scholarships_requirements__requirement_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"requirement_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Requirement UUID","title":"Requirement Id"},"description":"Requirement UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationRequirementUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationRequirementOut"}}}},"404":{"description":"Requirement not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/colleges/{college_id}/merit-scholarships":{"get":{"tags":["merit-scholarships"],"summary":"Get College Merit Scholarships","description":"Get all merit scholarships for a specific college.\n\nAccepts either a UUID or a slug for ``college_id`` (#246). Used by\nthe frontend to display scholarships on college detail pages.","operationId":"get_college_merit_scholarships_api_v1_colleges__college_id__merit_scholarships_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"is_active","in":"query","required":false,"schema":{"type":"boolean","description":"Filter by active status","default":true,"title":"Is Active"},"description":"Filter by active status"},{"name":"verified_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only return verified scholarships","default":false,"title":"Verified Only"},"description":"Only return verified scholarships"},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum scholarship amount","title":"Min Amount"},"description":"Minimum scholarship amount"},{"name":"max_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum scholarship amount","title":"Max Amount"},"description":"Maximum scholarship amount"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeritScholarshipResponse"},"title":"Response Get College Merit Scholarships Api V1 Colleges  College Id  Merit Scholarships Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/colleges/{college_id}/merit-scholarships/{scholarship_id}":{"get":{"tags":["merit-scholarships"],"summary":"Get Merit Scholarship","description":"Get a single merit scholarship by ID.","operationId":"get_merit_scholarship_api_v1_colleges__college_id__merit_scholarships__scholarship_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"College UUID","title":"College Id"},"description":"College UUID"},{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Scholarship UUID","title":"Scholarship Id"},"description":"Scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeritScholarshipResponse"}}}},"404":{"description":"Merit scholarship not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/merit-scholarships":{"get":{"tags":["merit-scholarships"],"summary":"Search All Merit Scholarships","description":"Search all merit scholarships across all colleges.\n\nSupports filtering by name, college state, award amount, eligibility criteria, and more.\nReturns paginated results with college information included.","operationId":"search_all_merit_scholarships_api_v1_merit_scholarships_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by scholarship or college name","title":"Query"},"description":"Search by scholarship or college name"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by college state","title":"State"},"description":"Filter by college state"},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum award amount","title":"Min Amount"},"description":"Minimum award amount"},{"name":"max_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum award amount","title":"Max Amount"},"description":"Maximum award amount"},{"name":"min_gpa","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Show scholarships achievable with this GPA","title":"Min Gpa"},"description":"Show scholarships achievable with this GPA"},{"name":"min_sat","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Show scholarships achievable with this SAT score","title":"Min Sat"},"description":"Show scholarships achievable with this SAT score"},{"name":"automatic_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only show auto-consideration scholarships","default":false,"title":"Automatic Only"},"description":"Only show auto-consideration scholarships"},{"name":"verified_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only show verified scholarships","default":false,"title":"Verified Only"},"description":"Only show verified scholarships"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Items per page","default":20,"title":"Page Size"},"description":"Items per page"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeritScholarshipListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/merit-scholarships/college/{college_id}":{"get":{"tags":["merit-scholarships"],"summary":"Get College Merit Scholarships Alias","description":"Alias endpoint for backwards compatibility with frontend.\nAccepts UUID or slug for ``college_id`` (#246).","operationId":"get_college_merit_scholarships_alias_api_v1_merit_scholarships_college__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"is_active","in":"query","required":false,"schema":{"type":"boolean","description":"Filter by active status","default":true,"title":"Is Active"},"description":"Filter by active status"},{"name":"verified_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only return verified scholarships","default":false,"title":"Verified Only"},"description":"Only return verified scholarships"},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum scholarship amount","title":"Min Amount"},"description":"Minimum scholarship amount"},{"name":"max_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum scholarship amount","title":"Max Amount"},"description":"Maximum scholarship amount"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeritScholarshipResponse"},"title":"Response Get College Merit Scholarships Alias Api V1 Merit Scholarships College  College Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/merit-scholarships/{scholarship_id}/redirect":{"get":{"tags":["merit-scholarships"],"summary":"Merit Scholarship Redirect","description":"Redirect (302) to the card's link, recording a server-side click (#823).\n\nThe destination is the link the card offers, chosen by\n``merit_links.pick_link`` from stored columns only; the request carries an\nid, never a URL. ``pick_link`` applies the same public-host check as the\nnational ``apply-redirect``, so a card never shows a link this refuses.\nThe click is written fail-open, as ``target = merit_<link kind>``.","operationId":"merit_scholarship_redirect_api_v1_merit_scholarships__scholarship_id__redirect_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scholarship_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Merit scholarship UUID","title":"Scholarship Id"},"description":"Merit scholarship UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"302":{"description":"Redirect to the page the merit scholarship card links to"},"404":{"description":"Merit scholarship or a usable link not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:scholarships"]}},"/api/v1/financial-aid/calculate-sai":{"post":{"tags":["financial-aid"],"summary":"Calculate Sai","description":"Calculate Student Aid Index (SAI) - simplified estimator.\n\nThis is a simplified estimate based on the 2025-26 FAFSA formula.\nStudents should use the official Federal Student Aid Estimator at\nstudentaid.gov for accurate calculations.\n\nAnonymous-capable: pure compute over the request body, no DB reads or\nwrites — backs the public /financial-aid/aid-calculator page. Anon\ntraffic is IP-limited via slowapi.","operationId":"calculate_sai_api_v1_financial_aid_calculate_sai_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SAICalculationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SAICalculationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/financial-aid/estimate-aid-package":{"post":{"tags":["financial-aid"],"summary":"Estimate Aid Package","description":"Estimate financial aid package for a specific college.\n\nProvides a rough estimate of grants, work-study, loans, and out-of-pocket cost.\nUse each college's Net Price Calculator for accurate estimates.","operationId":"estimate_aid_package_api_v1_financial_aid_estimate_aid_package_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AidPackageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AidPackageResponse"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/financial-aid/compare-aid-packages":{"post":{"tags":["financial-aid"],"summary":"Compare Aid Packages","description":"Compare estimated aid packages across multiple saved colleges.\n\nCalculates SAI once, then estimates aid packages for each college.\nResults are sorted by lowest estimated out-of-pocket cost.","operationId":"compare_aid_packages_api_v1_financial_aid_compare_aid_packages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AidPackageComparisonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AidPackageComparisonResponse"}}}},"404":{"description":"No colleges found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/financial-aid/saved-colleges-comparison":{"get":{"tags":["financial-aid"],"summary":"Compare Saved Colleges Aid","description":"Compare aid packages for all saved colleges.\n\nConvenience endpoint that gets all saved colleges and compares aid.","operationId":"compare_saved_colleges_aid_api_v1_financial_aid_saved_colleges_comparison_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"parent_income","in":"query","required":true,"schema":{"type":"number","description":"Parent annual taxable income in USD.","title":"Parent Income"},"description":"Parent annual taxable income in USD."},{"name":"parent_assets","in":"query","required":false,"schema":{"type":"number","description":"Parent reportable assets in USD (excluding primary residence and retirement accounts).","default":0,"title":"Parent Assets"},"description":"Parent reportable assets in USD (excluding primary residence and retirement accounts)."},{"name":"student_income","in":"query","required":false,"schema":{"type":"number","description":"Student annual taxable income in USD.","default":0,"title":"Student Income"},"description":"Student annual taxable income in USD."},{"name":"student_assets","in":"query","required":false,"schema":{"type":"number","description":"Student reportable assets in USD.","default":0,"title":"Student Assets"},"description":"Student reportable assets in USD."},{"name":"family_size","in":"query","required":false,"schema":{"type":"integer","description":"Number of people in the household, including the student.","default":4,"title":"Family Size"},"description":"Number of people in the household, including the student."},{"name":"num_in_college","in":"query","required":false,"schema":{"type":"integer","description":"Number of household members enrolled in college, including the student.","default":1,"title":"Num In College"},"description":"Number of household members enrolled in college, including the student."},{"name":"state_tax_rate","in":"query","required":false,"schema":{"type":"number","description":"State income tax rate as a decimal (e.g., 0.05 = 5%).","default":0.05,"title":"State Tax Rate"},"description":"State income tax rate as a decimal (e.g., 0.05 = 5%)."},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AidPackageComparisonResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/schools/search":{"get":{"tags":["schools"],"summary":"Search Schools","description":"Search for schools by name or district name.\n\nSupports:\n- Partial name matching (case-insensitive)\n- State filtering\n- School level filtering\n- High school focus (returns high schools first)\n\nReturns schools ordered by relevance and name.","operationId":"search_schools_api_v1_schools_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query (school name or district name)","title":"Q"},"description":"Search query (school name or district name)"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by state (2-letter code)","title":"State"},"description":"Filter by state (2-letter code)"},{"name":"school_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by school level (Elementary, Middle, High)","title":"School Level"},"description":"Filter by school level (Elementary, Middle, High)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":20,"title":"Limit"},"description":"Maximum results to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SchoolOut"},"title":"Response Search Schools Api V1 Schools Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/schools/districts":{"get":{"tags":["schools"],"summary":"Search Districts","description":"Search for school districts by name.\n\nReturns unique districts with their location info.\nUseful for district-based scholarship filtering.","operationId":"search_districts_api_v1_schools_districts_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query (district name)","title":"Q"},"description":"Search query (district name)"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by state (2-letter code)","title":"State"},"description":"Filter by state (2-letter code)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":20,"title":"Limit"},"description":"Maximum results to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DistrictSummary"},"title":"Response Search Districts Api V1 Schools Districts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/schools/states":{"get":{"tags":["schools"],"summary":"Get States","description":"Get list of all states with school counts.\n\nUseful for state dropdown/filter in UI.","operationId":"get_states_api_v1_schools_states_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/app__schemas__school__StateSummary"},"type":"array","title":"Response Get States Api V1 Schools States Get"}}}}}}},"/api/v1/schools/{ncessch}":{"get":{"tags":["schools"],"summary":"Get School By Id","description":"Get a specific school by NCES school ID.\n\nArgs:\n    ncessch: NCES school identifier (12-digit)","operationId":"get_school_by_id_api_v1_schools__ncessch__get","parameters":[{"name":"ncessch","in":"path","required":true,"schema":{"type":"string","description":"NCES school identifier (12-digit)","title":"Ncessch"},"description":"NCES school identifier (12-digit)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/leads":{"post":{"tags":["leads"],"summary":"Submit Lead","description":"Store a contact-form lead, then notify the sales inbox in the background.\n\nRuns the LeadSpamFilter chain (#213). Both verdicts are stored; only a real\nlead is emailed. A storage failure is the one 500: nothing was kept.","operationId":"submit_lead_api_v1_leads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feedback":{"post":{"tags":["feedback"],"summary":"Submit Feedback","description":"Accept a feedback submission from anywhere in the app.\n\nWorks authenticated and anonymous. Authenticated callers have their\n``user_id`` and ``email`` taken from the JWT — the payload cannot attribute\nfeedback to another account.","operationId":"submit_feedback_api_v1_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs":{"get":{"tags":["audit-logs"],"summary":"Get Audit Logs","description":"Get audit logs with filtering and pagination.\n\n**Admin only** - Requires admin role.\n\nReturns paginated audit log entries with total count.","operationId":"get_audit_logs_api_v1_audit_logs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by user ID","title":"User Id"},"description":"Filter by user ID"},{"name":"user_email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by user email (partial match)","title":"User Email"},"description":"Filter by user email (partial match)"},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action type","title":"Action Type"},"description":"Filter by action type"},{"name":"action_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action category","title":"Action Category"},"description":"Filter by action category"},{"name":"actor_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by actor type","title":"Actor Type"},"description":"Filter by actor type"},{"name":"resource_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by resource type","title":"Resource Type"},"description":"Filter by resource type"},{"name":"resource_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by resource ID","title":"Resource Id"},"description":"Filter by resource ID"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by IP address","title":"Ip Address"},"description":"Filter by IP address"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter by start date/time","title":"Start Date"},"description":"Filter by start date/time"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter by end date/time","title":"End Date"},"description":"Filter by end date/time"},{"name":"marked_for_export","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by export flag","title":"Marked For Export"},"description":"Filter by export flag"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Number of results per page","default":50,"title":"Page Size"},"description":"Number of results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/audit-logs/stats":{"get":{"tags":["audit-logs"],"summary":"Get Audit Log Stats","description":"Get audit log statistics.\n\n**Admin only** - Requires admin role.\n\nReturns summary statistics about audit logs.","operationId":"get_audit_log_stats_api_v1_audit_logs_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogStatsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs/action-types":{"get":{"tags":["audit-logs"],"summary":"Get Action Types","description":"Get list of distinct action types.\n\n**Admin only** - Requires admin role.","operationId":"get_action_types_api_v1_audit_logs_action_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Action Types Api V1 Audit Logs Action Types Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs/action-categories":{"get":{"tags":["audit-logs"],"summary":"Get Action Categories","description":"Get list of distinct action categories.\n\n**Admin only** - Requires admin role.","operationId":"get_action_categories_api_v1_audit_logs_action_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Action Categories Api V1 Audit Logs Action Categories Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs/{log_id}":{"get":{"tags":["audit-logs"],"summary":"Get Audit Log","description":"Get a specific audit log entry.\n\n**Admin only** - Requires admin role.","operationId":"get_audit_log_api_v1_audit_logs__log_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"log_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Audit log entry UUID","title":"Log Id"},"description":"Audit log entry UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogOut"}}}},"404":{"description":"Audit log not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/audit-logs/mark-for-export":{"post":{"tags":["audit-logs"],"summary":"Mark Logs For Export","description":"Mark audit logs for export.\n\n**Admin only** - Requires admin role.\n\nSets the `marked_for_export` flag to True for the specified log IDs.","operationId":"mark_logs_for_export_api_v1_audit_logs_mark_for_export_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogMarkExportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogMarkExportResponse"}}}},"404":{"description":"No audit logs found with provided IDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs/unmark-for-export":{"post":{"tags":["audit-logs"],"summary":"Unmark Logs For Export","description":"Unmark audit logs for export.\n\n**Admin only** - Requires admin role.\n\nSets the `marked_for_export` flag to False for the specified log IDs.","operationId":"unmark_logs_for_export_api_v1_audit_logs_unmark_for_export_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogMarkExportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditLogUnmarkExportResponse"}}}},"404":{"description":"No audit logs found with provided IDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/audit-logs/export/csv":{"get":{"tags":["audit-logs"],"summary":"Export Audit Logs Csv","description":"Export audit logs to CSV.\n\n**Admin only** - Requires admin role.\n\nReturns a CSV file with audit log data. Can export all logs or only those marked for export.\nTakes the same filters as the list (#1051), so a filtered export holds\nthe rows the Audit Logs page showed, on every page.\n\nWrites its audit row first (#993): a bulk read of the log is recorded even\nif it dies midway, and nothing is served if the row can't be written. The\nrow is left out of the file so an empty result is still a 404.","operationId":"export_audit_logs_csv_api_v1_audit_logs_export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"marked_only","in":"query","required":false,"schema":{"type":"boolean","description":"Export only logs marked for export","default":false,"title":"Marked Only"},"description":"Export only logs marked for export"},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by user ID","title":"User Id"},"description":"Filter by user ID"},{"name":"user_email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by user email (partial match)","title":"User Email"},"description":"Filter by user email (partial match)"},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action type","title":"Action Type"},"description":"Filter by action type"},{"name":"action_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action category","title":"Action Category"},"description":"Filter by action category"},{"name":"actor_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by actor type","title":"Actor Type"},"description":"Filter by actor type"},{"name":"resource_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by resource type","title":"Resource Type"},"description":"Filter by resource type"},{"name":"resource_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by resource ID","title":"Resource Id"},"description":"Filter by resource ID"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by IP address","title":"Ip Address"},"description":"Filter by IP address"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter by start date/time","title":"Start Date"},"description":"Filter by start date/time"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter by end date/time","title":"End Date"},"description":"Filter by end date/time"}],"responses":{"200":{"description":"CSV file download","content":{"text/csv":{}}},"404":{"description":"No audit logs found matching criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users":{"get":{"tags":["admin"],"summary":"List All Users","description":"List all users with their roles.\n\n**Admin only** - Requires admin role.\n\nOptional `q` parameter performs a case-insensitive substring match\nagainst both `email` and `display_name`. Used by the admin panel\norganization modals to search for users by email/name.","operationId":"list_all_users_api_v1_admin_users_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum results to return","default":100,"title":"Limit"},"description":"Maximum results to return"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"description":"Case-insensitive search across email and display_name","title":"Q"},"description":"Case-insensitive search across email and display_name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserRoleResponse"},"title":"Response List All Users Api V1 Admin Users Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/signup-regions":{"get":{"tags":["admin"],"summary":"Signup Regions","description":"Accounts created in the window, counted by signup country and state (#907).\n\n**Admin only.** Aggregate counts, no per-user rows.","operationId":"signup_regions_api_v1_admin_users_signup_regions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":3650,"minimum":1,"description":"Look back this many days","default":90,"title":"Days"},"description":"Look back this many days"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRegionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/sessions":{"get":{"tags":["admin"],"summary":"List User Sessions","description":"One user's browsing sessions, newest first (#855).\n\n**Admin only.** Reads ``user_sessions`` in the metrics DB, which keeps\n``retention_days`` of history. Session rows include page paths of an\noften-minor user, so every read is audit-logged.","operationId":"list_user_sessions_api_v1_admin_users__user_id__sessions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of sessions to skip","default":0,"title":"Skip"},"description":"Number of sessions to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum sessions to return","default":25,"title":"Limit"},"description":"Maximum sessions to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUserSessionsResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/update-role":{"post":{"tags":["admin"],"summary":"Update User Role","description":"Update a user's role.\n\n**Admin only** - Requires admin role.\n\nAllowed roles: student, admin, parent","operationId":"update_user_role_api_v1_admin_users_update_role_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRoleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRoleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/users/{user_id}/deactivate":{"post":{"tags":["admin"],"summary":"Admin Deactivate User","description":"Deactivate a user account (soft delete). Admin only.","operationId":"admin_deactivate_user_api_v1_admin_users__user_id__deactivate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMessageResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/reactivate":{"post":{"tags":["admin"],"summary":"Admin Reactivate User","description":"Reactivate a deactivated user account. Admin only.","operationId":"admin_reactivate_user_api_v1_admin_users__user_id__reactivate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMessageResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}":{"delete":{"tags":["admin"],"summary":"Admin Delete User","description":"Permanently delete a user account and all associated data. Admin only.","operationId":"admin_delete_user_api_v1_admin_users__user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMessageResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/force-password-reset":{"post":{"tags":["admin"],"summary":"Admin Force Password Reset","description":"Force a user to reset their password before they can log in again. Admin only.","operationId":"admin_force_password_reset_api_v1_admin_users__user_id__force_password_reset_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMessageResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users/{user_id}/disable-mfa":{"post":{"tags":["admin"],"summary":"Admin Disable Mfa","description":"Clear a user's second sign-in step. Admin only (#627).\n\nThe account-recovery path for a user who has lost both their authenticator\nand their recovery codes. Without it the only remedy is hand-written SQL\nagainst production, which is worse in every way — unaudited, unreviewable,\nand available to exactly one person.\n\nDeliberately does NOT return or reset anything else: it removes the factor\nand nothing more, so the user still needs their password to sign in.","operationId":"admin_disable_mfa_api_v1_admin_users__user_id__disable_mfa_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the target user account.","title":"User Id"},"description":"UUID of the target user account."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMessageResponse"}}}},"404":{"description":"User not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/users-bulk-delete":{"post":{"tags":["admin"],"summary":"Admin Bulk Delete Users","description":"Permanently delete multiple users. Admin only.\n\nSkips self, missing users, and the last active admin. Continues on\nindividual failures and reports per-user status.","operationId":"admin_bulk_delete_users_api_v1_admin_users_bulk_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserIdsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/users-bulk-update-role":{"post":{"tags":["admin"],"summary":"Admin Bulk Update Role","description":"Update the role of multiple users. Admin only.","operationId":"admin_bulk_update_role_api_v1_admin_users_bulk_update_role_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateRoleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUserOperationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/batch-email/preview":{"post":{"tags":["admin"],"summary":"Preview Batch Email","description":"Preview batch email recipients: returns count and a sample of matching users.\n\n**Admin only** - Requires admin role.","operationId":"preview_batch_email_api_v1_admin_batch_email_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/batch-email/send":{"post":{"tags":["admin"],"summary":"Send Batch Email","description":"Create a batch email job and dispatch it to Celery.\n\n**Admin only** - Requires admin role.\nReturns the job ID and recipient count.","operationId":"send_batch_email_api_v1_admin_batch_email_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailSendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/batch-email/jobs":{"get":{"tags":["admin"],"summary":"List Batch Email Jobs","description":"List past batch email jobs, newest first.\n\n**Admin only** - Requires admin role.","operationId":"list_batch_email_jobs_api_v1_admin_batch_email_jobs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of jobs to skip for pagination.","default":0,"title":"Skip"},"description":"Number of jobs to skip for pagination."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of jobs to return.","default":20,"title":"Limit"},"description":"Maximum number of jobs to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailJobList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/batch-email/jobs/{job_id}":{"get":{"tags":["admin"],"summary":"Get Batch Email Job","description":"Get a single batch email job by ID.\n\n**Admin only** - Requires admin role.","operationId":"get_batch_email_job_api_v1_admin_batch_email_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the batch email job.","title":"Job Id"},"description":"UUID of the batch email job."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchEmailJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/list":{"get":{"tags":["admin"],"summary":"List Available Tasks","description":"List all available Celery tasks.\n\n**Admin only** - Requires admin role.","operationId":"list_available_tasks_api_v1_admin_tasks_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CeleryTaskDefinition"},"type":"array","title":"Response List Available Tasks Api V1 Admin Tasks List Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/trigger":{"post":{"tags":["admin"],"summary":"Trigger Task","description":"Trigger a Celery task manually.\n\n**Admin only** - Requires admin role.\n\nReturns the task ID for status tracking.\n\n**Duplicate suppression (#542).** Publishes go through the singleton guard:\nif an identical unit of work (same task + same parameters) is already\nqueued and hasn't started, this trigger is suppressed. The returned\n``task_id`` is then the **already-queued run's real id**, not a sentinel —\nso a caller persisting it records something that actually resolves. The\nsuppression is logged and audit-rowed, so it is visible rather than silent.\n\nTo force a genuine second run anyway, pass ``\"force_publish\": true`` in\n``parameters``. It is lifted out of the parameters and sent as a Celery\n*option*, so it never reaches the task signature and is never persisted as\na task argument. Reach for it when you deliberately want a\nconcurrent/duplicate run — the guard exists to stop accidents (redelivery\nstorms, double-clicks, sweep floods), not to overrule intent.\n\n(The legacy ``\"__force_publish\"`` spelling is still accepted. As a *kwarg*\nit never worked from this endpoint — Celery validates kwargs against the\ntask signature before the guard can strip it — which is #550.)","operationId":"trigger_task_api_v1_admin_tasks_trigger_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/config":{"get":{"tags":["admin"],"summary":"Get Tasks Config","description":"Per-task time-limit config for every registered task. **Admin only.**\n\nFor each task: the coded decorator default, the admin override (if any), and\nthe effective value that actually applies. Backs the inline limit editor on\neach task card in the admin Tasks page.","operationId":"get_tasks_config_api_v1_admin_tasks_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskLimitsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/config/{task_name}":{"put":{"tags":["admin"],"summary":"Update Task Config","description":"Set or clear one task's time-limit override. **Admin only.**\n\nSend both ``soft_time_limit`` and ``hard_time_limit`` to override (validated\n``60 <= soft < hard <= 604800``), or both ``null`` to clear the override and\nrevert to the coded default. Takes effect on the next publish of that task —\nscheduled, resume, or manual — via ``_apply_task_time_limit_overrides``\n(subject to its ~30s per-process cache). Audit-logged.","operationId":"update_task_config_api_v1_admin_tasks_config__task_name__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_name","in":"path","required":true,"schema":{"type":"string","description":"Registry (short) task name.","title":"Task Name"},"description":"Registry (short) task name."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskLimitUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskLimitConfig"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/status/{task_id}":{"get":{"tags":["admin"],"summary":"Get Task Status","description":"Get the status of a Celery task.\n\n**Admin only** - Requires admin role.","operationId":"get_task_status_api_v1_admin_tasks_status__task_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"Celery task ID returned when the task was enqueued.","title":"Task Id"},"description":"Celery task ID returned when the task was enqueued."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/recent":{"get":{"tags":["admin"],"summary":"Get Recent Task Executions","description":"Get recent Celery task executions from audit logs.\n\n**Admin only** - Requires admin role.\n\nArgs:\n    limit: Maximum number of executions to return (default: 50)\n    task_name: Filter by specific task name (optional)","operationId":"get_recent_task_executions_api_v1_admin_tasks_recent_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum number of task executions to return.","default":50,"title":"Limit"},"description":"Maximum number of task executions to return."},{"name":"task_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter results to executions of a specific Celery task name.","title":"Task Name"},"description":"Filter results to executions of a specific Celery task name."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecentTaskExecution"},"title":"Response Get Recent Task Executions Api V1 Admin Tasks Recent Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/{task_name}/last-run-start":{"get":{"tags":["admin"],"summary":"Get Task Last Run Start","description":"Return the started row best suited to power the \"Resume last failed run\"\nbutton — the OLDEST chain-orphan if one exists, otherwise the most\nrecent started row.\n\n**Admin only.** Frontend prefills resume kwargs (e.g.\n``skip_if_scraped_after``) from ``started_at``.\n\nPreference order (#240, refined for synthetic-terminal awareness):\n\n1. **Oldest chain orphan** — the earliest ``in_progress`` row that\n   belongs to the current failure chain: no real (non-synthetic)\n   terminal pair, and at-or-after the most recent fresh-start anchor\n   (a started row whose ``skip_if_scraped_after`` is None — typically\n   the weekly Sunday scheduled fire). Shares the\n   :func:`celery_worker._filter_chain_orphans` filter with the\n   auto-resume path so the button surfaces the same cutoff the beat\n   would pick. Using the oldest preserves the maximum amount of work\n   across the chain.\n\n   Earlier behavior treated synthetic auto-recovery rows as real\n   terminals, so the chain start became invisible after one\n   auto-recovery cycle and the cutoff drifted forward by hours per\n   crash (production: ~70h drift in 6 cascading recoveries before\n   the fix; see audit_logs 2026-05-03..2026-05-06).\n2. **Most recent in_progress** (with its terminal pair, if any) — used\n   when no chain orphans exist (last run completed cleanly, or there's\n   a healthy run in flight). Preserves the \"what was the last run?\"\n   use case for the admin UI.\n\nReturns 404 when the task name is unknown or no started rows exist yet\n(task has never been run under the lifecycle pattern).\n\nSee ARCHITECTURE.md §\"Celery Task Lifecycle & Resume\".","operationId":"get_task_last_run_start_api_v1_admin_tasks__task_name__last_run_start_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_name","in":"path","required":true,"schema":{"type":"string","description":"Name of the Celery task (must be in AVAILABLE_TASKS).","title":"Task Name"},"description":"Name of the Celery task (must be in AVAILABLE_TASKS)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LastRunStartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/workers":{"get":{"tags":["admin"],"summary":"Get Worker State","description":"Live worker inspection: prefetch/concurrency plus **reserved** messages.\n\nAnswers the question no other endpoint can: *what would a restart strand\nright now?* ``/tasks/pending`` reads the broker (queued) and\n``/tasks/active`` projects audit rows (executing); a reserved message is in\nneither — it has left the queue and written no audit row. #629 is what that\nblind spot costs: three heavy-worker restarts stranded daily syncs for 60h\neach and nothing showed it.\n\nAlso the only way to confirm a deployed ``worker_prefetch_multiplier``\n(#629 shipped 1). Flower answers this too, but only through an SSH tunnel\n(#1016), so this route is the one the admin panel can call.\n\n**Read ``reachable`` before anything else.** ``False`` means we could not\nask, and ``workers`` is meaningless — not that nothing is reserved.\n\nDeliberately takes no ``db`` dependency: this route touches no database, and\nholding a pooled connection across a multi-second broker wait is precisely\nthe #560 mechanism.","operationId":"get_worker_state_api_v1_admin_tasks_workers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkerStateResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/consumption":{"get":{"tags":["admin"],"summary":"Get Consumption","description":"Is anything draining the queues? (#568)\n\nThe same verdict the ``consumption-watch`` cron alerts on, computed now.\nRead ``state`` per queue: ``stalled`` is the 08-02 shape (work queued, no\nworker-written audit row in 30 min / nothing running on the heavy worker\nfor two ticks); ``unknown`` means a read was blind and says nothing either\nway. Takes no ``db`` dependency — the snapshot opens its own short-lived\nsession off-loop.","operationId":"get_consumption_api_v1_admin_tasks_consumption_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsumptionResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/active":{"get":{"tags":["admin"],"summary":"Get Active Tasks","description":"Currently-running celery tasks: audit rows with ``status='in_progress'``\nthat lack a later terminal row for the same ``resource_id``.\n\nBounded to the last 24h via the ``(status, timestamp)`` composite index\n``idx_audit_status_timestamp`` — longer-running tasks documented in the\nrepo cap at 12h, leaving 2× headroom. The UI sorts client-side.\n\n``is_stuck`` is set only when the row's age exceeds the orphan threshold\n*and* the task_id is not present in any worker's active list (#395). When\nthe broker is unreachable or no workers reply, the endpoint falls back to\nage-only detection to preserve pre-#395 behavior.","operationId":"get_active_tasks_api_v1_admin_tasks_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveTasksResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/pending":{"get":{"tags":["admin"],"summary":"Get Pending Tasks","description":"Tasks sitting in a broker queue that no worker has received yet (#540).\n\nThe gap this fills: `/tasks/active` and `inspect()` both miss messages\nstill in the broker, which is precisely what accumulates behind a long\ntask on the single-slot `heavy` queue.\n\nAlways HTTP 200. ``meta.broker_ok`` is the signal for \"the queue depth is\nunknown\" — a consumer must not render that as \"nothing queued\".","operationId":"get_pending_tasks_api_v1_admin_tasks_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingTasksResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/tasks/{task_id}/revoke":{"post":{"tags":["admin"],"summary":"Revoke Task","description":"Ask the workers to discard a queued task (#540).\n\n**Advisory, and the response says so.** ``control.revoke`` broadcasts the id\nto every worker, which holds it in an in-memory set; the message stays in\nthe broker until a worker pops it, and only then is it discarded. The\nrevoked set does not survive a worker restart (no ``--statedb`` in\nrender.yaml), so a deploy makes the task run normally.\n\nThis endpoint declares **no request body**, so ``terminate=True`` is\nunreachable by construction — not filtered out, simply not in the\nsignature. Killing a running task is a separate concern with a separate\nblast radius.","operationId":"revoke_task_api_v1_admin_tasks__task_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:@-]{1,255}$","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tasks/schedule":{"get":{"tags":["admin"],"summary":"Get Beat Schedule","description":"Read-only view of ``celery_app.conf.beat_schedule`` joined with audit-log\nlast-run metadata. See issue #273.\n\nThe beat schedule dict (defined in ``backend/celery_worker.py``) is the\nauthoritative source for what's scheduled; the ``audit_logs`` table is the\nauthoritative source for last-run / run-count (see ARCHITECTURE.md\n§\"Celery Task Lifecycle & Resume\"). The on-disk shelve file is never read.","operationId":"get_beat_schedule_api_v1_admin_tasks_schedule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BeatScheduleResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/agents/turns/recent":{"get":{"tags":["admin"],"summary":"List Recent Turns","description":"Paginated list of recent chat-turn telemetry rows, newest first.\n\nPagination is keyset on ``started_at`` (descending) — pass the response's\n``next_cursor`` back as ``?cursor=<iso>`` to fetch the next page. No\noffset-based paging because the table grows fast and offset gets\nexpensive past a few hundred rows.","operationId":"list_recent_turns_api_v1_admin_agents_turns_recent_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"intent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by intent (`explore`, `search`, `compare`).","title":"Intent"},"description":"Filter by intent (`explore`, `search`, `compare`)."},{"name":"code_path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by code_path (`langgraph`, `legacy`).","title":"Code Path"},"description":"Filter by code_path (`langgraph`, `legacy`)."},{"name":"error_only","in":"query","required":false,"schema":{"type":"boolean","description":"Return only turns where a node raised or fallback fired.","default":false,"title":"Error Only"},"description":"Return only turns where a node raised or fallback fired."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Page size (max 200).","default":50,"title":"Limit"},"description":"Page size (max 200)."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Pagination cursor: pass `next_cursor` from the previous page.","title":"Cursor"},"description":"Pagination cursor: pass `next_cursor` from the previous page."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:agents"]}},"/api/v1/admin/agents/turns/{turn_id}":{"get":{"tags":["admin"],"summary":"Get Turn","description":"Single-turn drill-down — includes spans + tool_calls + extra_data.","operationId":"get_turn_api_v1_admin_agents_turns__turn_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"turn_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Turn Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:agents"]}},"/api/v1/admin/agents/conversations/{conversation_id}":{"get":{"tags":["admin"],"summary":"Get Conversation Session","description":"One conversation's captured turns, oldest first, with its transcript redacted (#709).\n\nAdmin login only (an API key with ``read:agents`` is refused here), and\nevery read writes an ``audit_logs`` row. Message text goes through\n``redact_for_telemetry`` with the conversation's own profile and user, so\nthe student's name and email are replaced as literals and phones, birth\ndates and test scores by pattern. Other people's names are not caught;\nSECURITY.md records that limit.","operationId":"get_conversation_session_api_v1_admin_agents_conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:agents"]}},"/api/v1/admin/agents/runs/daily":{"get":{"tags":["admin"],"summary":"Get Agent Runs Daily","description":"Daily agent-runs rollup (#258, Phase 2).\n\nRows ordered by ``metric_date ASC, code_path ASC``. The aggregate\n``code_path='all'`` row is included by default; filter with\n``?code_path=langgraph`` to drill into a single bucket.","operationId":"get_agent_runs_daily_api_v1_admin_agents_runs_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 90 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 90 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."},{"name":"code_path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single code_path (`langgraph`, `legacy`, `all`).","title":"Code Path"},"description":"Filter to a single code_path (`langgraph`, `legacy`, `all`)."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRunsDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:agents"]}},"/api/v1/admin/evals/runs":{"get":{"tags":["admin"],"summary":"List Eval Runs","description":"Eval runs, newest first. Keyset pagination on ``started_at`` (desc).","operationId":"list_eval_runs_api_v1_admin_evals_runs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Page size (max 200).","default":50,"title":"Limit"},"description":"Page size (max 200)."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Pagination cursor: pass `next_cursor` from the previous page.","title":"Cursor"},"description":"Pagination cursor: pass `next_cursor` from the previous page."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalRunListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Trigger Eval Run","description":"Dispatch a manual eval run. 409 if one is already in flight.\n\nThe Celery task's Redis lock is the authoritative single-flight guard; this\npre-check is a friendly fast-fail so the operator gets a clear 409 instead\nof a silently-skipped ``skipped_lock_held`` task.\n\nBecause it is only a fast-fail, it is **age-bounded** (#620). A run row is\nflipped to ``running`` by the task and back only by that same process, so a\nworker killed mid-run (deploy, OOM) leaves the row ``running`` forever — and\nan unbounded pre-check then 409s this endpoint permanently. Staging sat that\nway for six weeks. Rows older than the task's hard time limit plus a grace\nwindow cannot be a live run, so they are repaired here and the dispatch\nproceeds.","operationId":"trigger_eval_run_api_v1_admin_evals_runs_post","security":[{"HTTPBearer":[]}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerRunResponse"}}}}}}},"/api/v1/admin/evals/runs/{run_id}":{"get":{"tags":["admin"],"summary":"Get Eval Run","description":"One run + its per-case results (drill-down).","operationId":"get_eval_run_api_v1_admin_evals_runs__run_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalRunDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/evals/cases":{"get":{"tags":["admin"],"summary":"List Eval Cases","description":"All eval cases, by slug. The observable corpus.","operationId":"list_eval_cases_api_v1_admin_evals_cases_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"enabled_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only enabled cases.","default":false,"title":"Enabled Only"},"description":"Only enabled cases."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ChatEvalCaseRow"},"title":"Response List Eval Cases Api V1 Admin Evals Cases Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create Eval Case","operationId":"create_eval_case_api_v1_admin_evals_cases_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalCaseCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalCaseRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/evals/cases/{case_id}":{"get":{"tags":["admin"],"summary":"Get Eval Case","operationId":"get_eval_case_api_v1_admin_evals_cases__case_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Case Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalCaseRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Eval Case","operationId":"update_eval_case_api_v1_admin_evals_cases__case_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Case Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalCaseUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatEvalCaseRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Eval Case","operationId":"delete_eval_case_api_v1_admin_evals_cases__case_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Case Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users/stats":{"get":{"tags":["admin"],"summary":"Aggregate developer API stats","description":"Developer counts, active key count, tier distribution, today's request\ncount, and top consumers.","operationId":"get_stats_api_v1_admin_api_users_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminStatsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/api-users/usage/top":{"get":{"tags":["admin"],"summary":"Top API consumers","description":"Top API key consumers by total request count over the last 30 days.","operationId":"get_top_consumers_api_v1_admin_api_users_usage_top_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminTopConsumersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users/audit-log":{"get":{"tags":["admin"],"summary":"Admin audit log for API user / key actions","description":"Paginated audit log of API user / key administrative actions.\n\nFilterable by ``target_user_id``, ``target_key_id``, or ``action_type``\nso the admin UI can drill down to a single developer or a single key's\nhistory without scanning the full table.","operationId":"get_audit_log_api_v1_admin_api_users_audit_log_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"target_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target User Id"}},{"name":"target_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Key Id"}},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminAuditLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users":{"get":{"tags":["admin"],"summary":"List developer API users","description":"List developer API users with optional filtering by status, tier, or\nfree-text query against email / app name. Pagination via ``skip``/``limit``.","operationId":"list_api_users_api_v1_admin_api_users_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"active | suspended","title":"Status"},"description":"active | suspended"},{"name":"tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Email or app_name substring","title":"Q"},"description":"Email or app_name substring"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminApiUserListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users/{user_id}":{"get":{"tags":["admin"],"summary":"Get developer detail + all keys","operationId":"get_api_user_detail_api_v1_admin_api_users__user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminApiUserDetailResponse"}}}},"404":{"description":"Developer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update developer status / attach admin notes","description":"Update developer status (suspend/reactivate) and/or attach admin notes.\n\nSuspension flips ``users.is_active`` via the existing ``deactivate_user`` /\n``reactivate_user`` services — there is no parallel status column. Notes\nare persisted on the audit log row, not the developer profile. Returns\n422 if the request body has neither field.","operationId":"update_api_user_api_v1_admin_api_users__user_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminApiUserUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminApiUserDetailResponse"}}}},"404":{"description":"Developer not found"},"422":{"description":"No fields supplied"}}}},"/api/v1/admin/api-users/{user_id}/usage":{"get":{"tags":["admin"],"summary":"Per-user usage time series","operationId":"get_api_user_usage_api_v1_admin_api_users__user_id__usage_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUsageTimeSeriesResponse"}}}},"404":{"description":"Developer not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users/{user_id}/keys/{key_id}":{"delete":{"tags":["admin"],"summary":"Admin-revoke an API key","description":"Admin-revoke an API key on behalf of a developer.\n\nIdempotent: re-revoking an already-revoked key returns 204 with no\nduplicate audit row or notification email. Pre-checks that the key\nactually belongs to ``user_id`` so a wrong-URL request can never\nsilently revoke an unrelated key.","operationId":"admin_revoke_key_endpoint_api_v1_admin_api_users__user_id__keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}},{"name":"reason","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Key not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/api-users/{user_id}/keys/{key_id}/tier":{"patch":{"tags":["admin"],"summary":"Override an API key's rate-limit tier","description":"Override the rate-limit tier on a single API key.\n\nThe service layer is responsible for the three-step invariant: update\n``api_keys.rate_limit_tier``, invalidate the tier cache via\n``app.services.api_key.invalidate_rate_limit_cache`` (which delegates to\nthe middleware's ``invalidate_key_meta_cache``) so the change is visible\nwithin seconds, and write an audit log row with\n``action_type=\"api_key.tier_override\"``.","operationId":"override_key_tier_api_v1_admin_api_users__user_id__keys__key_id__tier_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TierOverrideRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminApiKeySummary"}}}},"404":{"description":"Key not found"},"422":{"description":"Invalid tier"}}}},"/api/v1/admin/athletics":{"get":{"tags":["admin"],"summary":"List colleges with athletics URL info","operationId":"list_colleges_api_v1_admin_athletics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"has_url","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Url"}},{"name":"has_programs","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Programs"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeAthleticsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/bulk-update":{"post":{"tags":["admin"],"summary":"Bulk update athletics URLs","operationId":"bulk_update_api_v1_admin_athletics_bulk_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAthleticsUrlUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAthleticsUrlResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/athletics/{college_id}":{"get":{"tags":["admin"],"summary":"Get college athletics detail","operationId":"get_college_api_v1_admin_athletics__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeAthleticsItem"}}}},"404":{"description":"College not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update a college's athletics URL","operationId":"update_college_url_api_v1_admin_athletics__college_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticsUrlUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeAthleticsItem"}}}},"404":{"description":"College not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/programs/{program_id}/curate":{"get":{"tags":["admin"],"summary":"Admin curation panel for an athletic program","operationId":"get_program_curate_panel_api_v1_admin_athletics_programs__program_id__curate_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Program Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CuratePanelResponse"}}}},"404":{"description":"Athletic program not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/programs/{program_id}/overrides":{"post":{"tags":["admin"],"summary":"Create an admin override on an athletic program field","operationId":"create_program_override_api_v1_admin_athletics_programs__program_id__overrides_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Program Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideOut"}}}},"404":{"description":"Athletic program not found"},"422":{"description":"Field not in the overridable allowlist"}}}},"/api/v1/admin/athletics/programs/{program_id}/coaches":{"post":{"tags":["admin"],"summary":"Add a coach to an athletic program","operationId":"create_program_coach_api_v1_admin_athletics_programs__program_id__coaches_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Program Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCreateBody"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCurateItem"}}}},"404":{"description":"Athletic program not found"},"422":{"description":"Invalid coach body (e.g. blank name)"}}}},"/api/v1/admin/athletics/programs/{program_id}":{"delete":{"tags":["admin"],"summary":"Hard-delete an athletic program and everything attached to it","operationId":"delete_program_api_v1_admin_athletics_programs__program_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Program Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Athletic program not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/programs/{program_id}/overrides/{override_id}":{"delete":{"tags":["admin"],"summary":"Revoke (soft-delete) a program field override","operationId":"revoke_program_override_api_v1_admin_athletics_programs__program_id__overrides__override_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Program Id"}},{"name":"override_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Override Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Override not found for this program"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/coaches/{coach_id}/curate":{"get":{"tags":["admin"],"summary":"Admin curation panel for a single coach","operationId":"get_coach_curate_panel_api_v1_admin_athletics_coaches__coach_id__curate_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"coach_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Coach Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCuratePanelResponse"}}}},"404":{"description":"Coach not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/athletics/coaches/{coach_id}/overrides":{"post":{"tags":["admin"],"summary":"Create an admin override on a coach field","operationId":"create_coach_override_api_v1_admin_athletics_coaches__coach_id__overrides_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"coach_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Coach Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideOut"}}}},"404":{"description":"Coach not found"},"422":{"description":"Field not in the overridable allowlist"}}}},"/api/v1/admin/athletics/coaches/{coach_id}/overrides/{override_id}":{"delete":{"tags":["admin"],"summary":"Revoke (soft-delete) a coach field override","operationId":"revoke_coach_override_api_v1_admin_athletics_coaches__coach_id__overrides__override_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"coach_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Coach Id"}},{"name":"override_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Override Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Override not found for this coach"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/changelog":{"get":{"tags":["admin"],"summary":"List all changelog entries (admin)","description":"List changelog entries with admin visibility (includes drafts/unpublished\nif those exist). Filterable by ``version`` and ``breaking``.","operationId":"admin_list_changelog_api_v1_admin_changelog_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"}},{"name":"breaking","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Breaking"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create a changelog entry (admin)","description":"Create a new changelog entry. The entry becomes immediately visible on\nthe public ``/api/developer/changelog`` feed and RSS endpoint.","operationId":"admin_create_changelog_api_v1_admin_changelog_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/changelog/{entry_id}":{"patch":{"tags":["admin"],"summary":"Update a changelog entry (admin)","description":"Update an existing changelog entry. The audit log records only the\nfields the admin actually supplied, which makes it easy to trace who\nflipped ``breaking=true`` after the fact.","operationId":"admin_update_changelog_api_v1_admin_changelog__entry_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"integer","title":"Entry Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogResponse"}}}},"404":{"description":"Changelog entry not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete a changelog entry (admin)","description":"Delete a changelog entry. Hard delete — the entry vanishes from the\npublic feed immediately. Use with care; prefer marking entries as\nsuperseded via an update where possible.","operationId":"admin_delete_changelog_api_v1_admin_changelog__entry_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"integer","title":"Entry Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Changelog entry not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/feature-flags":{"get":{"tags":["admin"],"summary":"List feature flags","operationId":"list_feature_flags_api_v1_admin_feature_flags_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminFeatureFlagsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create a feature flag","operationId":"create_feature_flag_api_v1_admin_feature_flags_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminFeatureFlagCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminFeatureFlagResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/feature-flags/{flag_id}":{"patch":{"tags":["admin"],"summary":"Update a feature flag","operationId":"update_feature_flag_api_v1_admin_feature_flags__flag_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"flag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Flag Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminFeatureFlagUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminFeatureFlagResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete a feature flag","operationId":"delete_feature_flag_api_v1_admin_feature_flags__flag_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"flag_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Flag Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations":{"get":{"tags":["admin"],"summary":"List Organizations","operationId":"list_organizations_api_v1_admin_organizations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search name, domain, or owner email","title":"Q"},"description":"Search name, domain, or owner email"},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"enum":["school","district","counseling_practice"],"type":"string"},{"type":"null"}],"description":"Filter by organization type","title":"Type"},"description":"Filter by organization type"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["active","suspended","pending"],"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"parent_org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Restrict results to children of this district","title":"Parent Org Id"},"description":"Restrict results to children of this district"},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["name","created_at","member_count","student_count"],"type":"string","description":"Sort field","default":"created_at","title":"Sort By"},"description":"Sort field"},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort direction","default":"desc","title":"Sort Order"},"description":"Sort direction"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create Organization","operationId":"create_organization_api_v1_admin_organizations_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/stats":{"get":{"tags":["admin"],"summary":"Get Platform Stats","description":"Platform-wide organization counts, totals, and month-over-month growth.\n\nCached for 5 minutes.","operationId":"get_platform_stats_api_v1_admin_organizations_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgPlatformStats"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/organizations/stats/growth":{"get":{"tags":["admin"],"summary":"Get Growth Series","description":"New-organizations time series within the requested window.\n\nDefaults to the last 30 days. Maximum range: 365 days. Cached for 5 minutes\nper (granularity, start, end, type) tuple.","operationId":"get_growth_series_api_v1_admin_organizations_stats_growth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Window start (default: end - 30 days)","title":"Start"},"description":"Window start (default: end - 30 days)"},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Window end (default: today)","title":"End"},"description":"Window end (default: today)"},{"name":"granularity","in":"query","required":false,"schema":{"enum":["day","week","month"],"type":"string","description":"Bucket granularity","default":"day","title":"Granularity"},"description":"Bucket granularity"},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"enum":["school","district","counseling_practice"],"type":"string"},{"type":"null"}],"description":"Restrict to one organization type","title":"Type"},"description":"Restrict to one organization type"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgGrowthSeries"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/stats/top":{"get":{"tags":["admin"],"summary":"Get Top Organizations","description":"Top N organizations ranked by the chosen metric.\n\nEach item carries every metric (student_count, member_count,\nactive_students_30d, last_activity_at), so the frontend can render\nsecondary stats without a second request. Cached for 5 minutes.","operationId":"get_top_organizations_api_v1_admin_organizations_stats_top_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"metric","in":"query","required":false,"schema":{"enum":["students","members","engagement","last_active"],"type":"string","description":"Ranking metric","default":"students","title":"Metric"},"description":"Ranking metric"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgTopList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/stats/types":{"get":{"tags":["admin"],"summary":"Get Type Distribution","description":"Organization count by type. Always emits all three types, even with 0.\n\nCached for 5 minutes.","operationId":"get_type_distribution_api_v1_admin_organizations_stats_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgTypeDistribution"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/organizations/audit-log":{"get":{"tags":["admin"],"summary":"Get Audit Log","description":"Filtered + paginated org-management audit log.\n\nThe ``organization_id`` filter returns only org-resource rows\n(``resource_type='organization'``); member-event rows for that org are not\nsurfaced (v1 limitation — see the issue #127 plan §D4). The unfiltered log\nstill shows all member events.","operationId":"get_audit_log_api_v1_admin_organizations_audit_log_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},{"name":"admin_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Admin User Id"}},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgAuditLogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/audit-log/export.csv":{"get":{"tags":["admin"],"summary":"Export Audit Log Csv","description":"CSV export of the org-management audit log.\n\nSame filters as ``GET /audit-log`` but unpaginated. Streams rows one at a\ntime so the worker memory is bounded regardless of result-set size.\nReturns a CSV with a header row even when there are no matching rows.\n\nFree-text cells are sanitized against CSV formula injection (CWE-1236).","operationId":"export_audit_log_csv_api_v1_admin_organizations_audit_log_export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},{"name":"admin_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Admin User Id"}},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/members":{"get":{"tags":["admin"],"summary":"List All Members","description":"Cross-organization member listing for the admin panel.\n\nReturns one row per (user, org) membership; a user with N memberships\nappears N times. Sorted by ``joined_at DESC``. Hard ``limit`` ceiling 500\nmatches the other admin list endpoints.","operationId":"list_all_members_api_v1_admin_organizations_members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search user email/name or org name","title":"Q"},"description":"Search user email/name or org name"},{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Restrict to one organization","title":"Organization Id"},"description":"Restrict to one organization"},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"enum":["owner","admin","counselor"],"type":"string"},{"type":"null"}],"description":"Filter by role","title":"Role"},"description":"Filter by role"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminCrossOrgMemberListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/members/export.csv":{"get":{"tags":["admin"],"summary":"Export All Members Csv","description":"CSV export of the cross-organization member list.\n\nSame filters as ``GET /members`` but unpaginated. Streams rows so worker\nmemory is bounded regardless of result-set size. Free-text cells are\nsanitized against CSV formula injection (CWE-1236) via ``_csv_safe()``.","operationId":"export_all_members_csv_api_v1_admin_organizations_members_export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"enum":["owner","admin","counselor"],"type":"string"},{"type":"null"}],"title":"Role"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}":{"get":{"tags":["admin"],"summary":"Get Organization","operationId":"get_organization_api_v1_admin_organizations__org_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Organization","operationId":"update_organization_api_v1_admin_organizations__org_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Organization","operationId":"delete_organization_api_v1_admin_organizations__org_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"hard","in":"query","required":false,"schema":{"type":"boolean","description":"If true, permanently DELETE the row (cascades to members, invitations, students). If false (default), soft-delete by setting status='suspended'.","default":false,"title":"Hard"},"description":"If true, permanently DELETE the row (cascades to members, invitations, students). If false (default), soft-delete by setting status='suspended'."}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/stats":{"get":{"tags":["admin"],"summary":"Get Organization Stats","description":"Per-org analytics overview for the admin panel.\n\nThin wrapper around the per-org service used by the user-facing org\ndashboard (#120). Reuses the existing ``org:{id}:analytics:overview``\nRedis cache, so calling this endpoint and the user-facing one for the\nsame org both warm and consume the same key.","operationId":"get_organization_stats_api_v1_admin_organizations__org_id__stats_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgAnalyticsOverview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/tree":{"get":{"tags":["admin"],"summary":"Get Organization Tree","description":"The org's shape for the admin panel (#1069): the same service and\nschema as the members' ``GET /organizations/{id}/tree``. Read-only and,\nlike the roster read (#656), not audited.","operationId":"get_organization_tree_api_v1_admin_organizations__org_id__tree_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationTreeRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/status":{"patch":{"tags":["admin"],"summary":"Change Status","operationId":"change_status_api_v1_admin_organizations__org_id__status_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/dpa":{"patch":{"tags":["admin"],"summary":"Set Dpa","description":"Record or clear the signed data-privacy agreement (#898). Until it's\nrecorded, a school or district can't add students who haven't joined.","operationId":"set_dpa_api_v1_admin_organizations__org_id__dpa_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDpaRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/transfer":{"post":{"tags":["admin"],"summary":"Transfer Ownership","operationId":"transfer_ownership_api_v1_admin_organizations__org_id__transfer_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgTransferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members":{"get":{"tags":["admin"],"summary":"List Members","operationId":"list_members_api_v1_admin_organizations__org_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgMemberListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Add Member","operationId":"add_member_api_v1_admin_organizations__org_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgAddMemberRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgMemberSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/students":{"get":{"tags":["admin"],"summary":"List Students","description":"List an organization's student roster.\n\nNo audit row: this matches ``list_members`` and every other admin read in\nthis router, where only mutations are audited.","operationId":"list_students_api_v1_admin_organizations__org_id__students_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"description":"Search email or name","title":"Q"},"description":"Search email or name"},{"name":"assigned_counselor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Counselor UUID, or the literal 'unassigned' for students whose counselor was removed (assigned_counselor_id is ON DELETE SET NULL).","title":"Assigned Counselor Id"},"description":"Counselor UUID, or the literal 'unassigned' for students whose counselor was removed (assigned_counselor_id is ON DELETE SET NULL)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgStudentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members/export.csv":{"get":{"tags":["admin"],"summary":"Export Org Members Csv","description":"CSV export of one organization's member list.\n\nSame column shape as the cross-org export so spreadsheets/scripts can\nconsume both with one parser. Streams rows; ``_csv_safe()`` sanitizes\nfree-text columns against formula injection (CWE-1236).","operationId":"export_org_members_csv_api_v1_admin_organizations__org_id__members_export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members/bulk-remove":{"post":{"tags":["admin"],"summary":"Bulk Remove Members","description":"Remove multiple members from an organization in a single transaction.\n\nThe service writes one ``audit_logs`` row per succeeded user_id INSIDE\nthe same outer transaction as the member deletes, so the per-user audit\ntrail is atomic with the per-user member change (architecture rule:\nbulk operations must preserve per-user provenance — no synthetic\n``bulk_*`` action_type, and no commit gap that could leak audit rows\non a crash mid-operation).","operationId":"bulk_remove_members_api_v1_admin_organizations__org_id__members_bulk_remove_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgBulkRemoveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgBulkOpResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members/bulk-role-change":{"post":{"tags":["admin"],"summary":"Bulk Change Member Role","description":"Change the role of multiple members in a single transaction.\n\nSame in-transaction audit-row pattern as ``bulk_remove_members``: the\nservice writes per-user audit rows alongside the role change so a\ncrash mid-operation cannot leave the audit log out of sync with the\nmember state.","operationId":"bulk_change_member_role_api_v1_admin_organizations__org_id__members_bulk_role_change_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgBulkRoleChangeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgBulkOpResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members/{user_id}":{"delete":{"tags":["admin"],"summary":"Remove Member","operationId":"remove_member_api_v1_admin_organizations__org_id__members__user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"reassign_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Member who inherits the removed member's assigned students. Required (409 otherwise) when the member has any (#662).","title":"Reassign To"},"description":"Member who inherits the removed member's assigned students. Required (409 otherwise) when the member has any (#662)."}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/organizations/{org_id}/members/{user_id}/role":{"patch":{"tags":["admin"],"summary":"Change Member Role","operationId":"change_member_role_api_v1_admin_organizations__org_id__members__user_id__role_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgMemberRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOrgMemberSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/seo/indexation/trends":{"get":{"tags":["admin"],"summary":"Get Indexation Trends","description":"Return per-day indexation metrics for the admin /admin/seo dashboard.\n\nRows are ordered by ``metric_date ASC, page_type ASC``. Aggregate rows\n(``page_type='all'``) are included by default; filter with\n``?page_type=best_colleges`` to drill into a single bucket.","operationId":"get_indexation_trends_api_v1_admin_seo_indexation_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 90 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 90 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."},{"name":"page_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional page_type filter (e.g. 'best_colleges', 'all').","title":"Page Type"},"description":"Optional page_type filter (e.g. 'best_colleges', 'all')."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexationTrendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/seo/indexation/import":{"post":{"tags":["admin"],"summary":"Import Indexation Csv","description":"Manual GSC CSV upload — the MVP data-ingest path (#203).\n\nParses the GSC export, groups rows by programmatic page_type bucket, and\nupserts into ``metrics_seo_indexation``. The per-type rows drive the\ndashboard; an aggregate ``page_type='all'`` row is recomputed per date\ntouched and is what the #57 alert engine evaluates.","operationId":"import_indexation_csv_api_v1_admin_seo_indexation_import_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_indexation_csv_api_v1_admin_seo_indexation_import_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexationImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/seo/indexation/poll":{"post":{"tags":["admin"],"summary":"Trigger Indexation Poll","description":"Manually trigger a GSC poll — a single day, or a date-range backfill.\n\nSingle-day (default): polls ``target_date`` (or 3 days ago). Range mode\n(``since`` set): backfills every finalized day in ``[since, until]``, run\noff the event loop. Returns 503 when GSC credentials are not configured.","operationId":"trigger_indexation_poll_api_v1_admin_seo_indexation_poll_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"target_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Single-day poll target. Defaults to 3 days ago (UTC) to align with GSC's dataState='final' finalization window. Ignored when `since` is provided.","title":"Target Date"},"description":"Single-day poll target. Defaults to 3 days ago (UTC) to align with GSC's dataState='final' finalization window. Ignored when `since` is provided."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Range-backfill start (inclusive). When set, polls every day from `since` through `until`. Max 180 days.","title":"Since"},"description":"Range-backfill start (inclusive). When set, polls every day from `since` through `until`. Max 180 days."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Range-backfill end (inclusive). Defaults to 3 days ago (UTC). Only used with `since`.","title":"Until"},"description":"Range-backfill end (inclusive). Defaults to 3 days ago (UTC). Only used with `since`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexationPollResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/seo/programmatic-funnel/trends":{"get":{"tags":["admin"],"summary":"Get Programmatic Funnel Trends","description":"Return per-day programmatic-LP funnel metrics (#204).\n\nRows ordered by ``metric_date ASC, page_type ASC``. The aggregate\n``page_type='all'`` row is included by default; filter with\n``?page_type=best_colleges`` to drill into a bucket.","operationId":"get_programmatic_funnel_trends_api_v1_admin_seo_programmatic_funnel_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 90 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 90 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."},{"name":"page_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional page_type filter (e.g. 'best_colleges', 'all').","title":"Page Type"},"description":"Optional page_type filter (e.g. 'best_colleges', 'all')."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticFunnelTrendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/synthesis/colleges":{"get":{"tags":["admin"],"summary":"List Synthesized Profiles","description":"Paginated list of colleges with synthesis activity.\n\nAlways joins to ``College`` for the name + denormalized status —\neven when no profile exists yet. Ordered by ``synthesized_at DESC``,\nNULLs (never-synthesized) last so freshly-synthesized work surfaces\nfirst.","operationId":"list_synthesized_profiles_api_v1_admin_synthesis_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"synthesis_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by synthesis_status (fresh/stale/missing/blocked).","title":"Synthesis Status"},"description":"Filter by synthesis_status (fresh/stale/missing/blocked)."},{"name":"college_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Partial-match search on college name (case-insensitive).","title":"College Name"},"description":"Partial-match search on college name (case-insensitive)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisProfileListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/synthesis/colleges/{college_id}":{"get":{"tags":["admin"],"summary":"Get Synthesized Profile Detail","description":"Single college's synthesis detail.\n\nReturns 200 even when no synthesized profile exists — a missing-profile\ncollege is exactly the one an operator wants to inspect (to see WHY\nsynthesis hasn't happened), so we surface an ingestion-diagnostics block\ninstead of a dead 404. Only a genuinely nonexistent ``college_id`` 404s.\n\nWhen a profile exists, citations are resolved against source docs and the\nsame diagnostics block rides along as useful context.","operationId":"get_synthesized_profile_detail_api_v1_admin_synthesis_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisProfileDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/synthesis/daily":{"get":{"tags":["admin"],"summary":"List Daily Metrics","description":"Last N days of synthesis-daily rollup rows, newest first.\n\nDefault 30 days; max 365. Used by the admin panel's cost trend chart\n+ summary cards.","operationId":"list_daily_metrics_api_v1_admin_synthesis_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/synthesis/colleges/{college_id}/regenerate":{"post":{"tags":["admin"],"summary":"Force Regenerate Profile","description":"Force re-synthesis of one college's profile.\n\nSynchronous (calls Claude directly, blocks on the response). Bypasses\nthe input_hash short-circuit via ``force=True``. Audit-logged with\nactor = the admin who triggered it.\n\nCost: typically ~$0.003 per call at Haiku rates. The admin UI surfaces\na confirmation modal before firing this.","operationId":"force_regenerate_profile_api_v1_admin_synthesis_colleges__college_id__regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__admin_synthesis__RegenerateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/llm-usage/daily":{"get":{"tags":["admin"],"summary":"Get Llm Usage Daily","description":"Daily LLM token + cost rollup for the offline pipelines.\n\nRows are ordered newest date first, then by descending cost within a date,\nso the most expensive thing in the window is the first row a reader sees.","operationId":"get_llm_usage_daily_api_v1_admin_llm_usage_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 30 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 30 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."},{"name":"workload","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to one Celery task name, e.g. `celery_worker.sync_cds_data_task`.","title":"Workload"},"description":"Filter to one Celery task name, e.g. `celery_worker.sync_cds_data_task`."},{"name":"provider","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to `openai` or `anthropic`.","title":"Provider"},"description":"Filter to `openai` or `anthropic`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LlmUsageDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/outcomes/colleges":{"get":{"tags":["admin"],"summary":"List Outcomes Profiles","description":"Paginated list of colleges with outcomes activity.\n\nJoins to College for name + denormalized status — even when no\noutcomes row exists yet. Ordered by derived_at DESC, NULLs last.","operationId":"list_outcomes_profiles_api_v1_admin_outcomes_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"outcomes_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by outcomes_status (fresh/stale/missing/blocked).","title":"Outcomes Status"},"description":"Filter by outcomes_status (fresh/stale/missing/blocked)."},{"name":"college_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Partial-match search on college name (case-insensitive).","title":"College Name"},"description":"Partial-match search on college name (case-insensitive)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomesProfileListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/outcomes/colleges/{college_id}":{"get":{"tags":["admin"],"summary":"Get Outcomes Profile Detail","description":"Single college's outcomes detail, with per-category source-doc\nmetadata resolved. 404 if no row exists for the college.","operationId":"get_outcomes_profile_detail_api_v1_admin_outcomes_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomesProfileDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/outcomes/daily":{"get":{"tags":["admin"],"summary":"List Daily Metrics","description":"Last N days of outcomes-daily rollup rows, newest first.\n\nDefault 30 days; max 365. Used by the admin panel's summary cards\n+ per-source counter trend.","operationId":"list_daily_metrics_api_v1_admin_outcomes_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomesDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/outcomes/colleges/{college_id}/regenerate":{"post":{"tags":["admin"],"summary":"Force Regenerate Outcomes","description":"Force re-derivation of one college's outcomes row.\n\nSynchronous — runs derive_for_college with force=True (bypasses the\ninput_hash short-circuit). Does NOT re-fetch upstream sources; use\nthe source-ingestion admin tools for that. Audit-logged with actor\n= the admin who triggered it.","operationId":"force_regenerate_outcomes_api_v1_admin_outcomes_colleges__college_id__regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__admin_outcomes__RegenerateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/media/colleges":{"get":{"tags":["admin"],"summary":"List Media Colleges","description":"Per-college aggregate list. Joins to ``college_media`` and\naggregates photo + virtual_tour counts + distinct licenses.","operationId":"list_media_colleges_api_v1_admin_media_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Partial-match search on college name.","title":"College Name"},"description":"Partial-match search on college name."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaCollegeListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/media/colleges/{college_id}":{"get":{"tags":["admin"],"summary":"Get Media College Detail","description":"Full media row list for a college, sorted by ordering ASC.","operationId":"get_media_college_detail_api_v1_admin_media_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaCollegeDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/media/daily":{"get":{"tags":["admin"],"summary":"List Daily Metrics","description":"Last N days of media-daily rollup rows, newest first.","operationId":"list_daily_metrics_api_v1_admin_media_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/media/colleges/{college_id}/regenerate":{"post":{"tags":["admin"],"summary":"Force Regenerate Media","description":"Force re-projection of one college's media rows. Bypasses idempotency\nvia ``force=True`` — updates existing rows (caption / credit / license\nrefresh from current source-doc state). Audit-logged.","operationId":"force_regenerate_media_api_v1_admin_media_colleges__college_id__regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__admin_media__RegenerateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/media/virtual-tours":{"post":{"tags":["admin"],"summary":"Create Virtual Tour","description":"Create an admin-curated virtual-tour row. ``source_document_id``\nis NULL by design — operator-pasted URL has no fetched provenance.","operationId":"create_virtual_tour_api_v1_admin_media_virtual_tours_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VirtualTourCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/media/virtual-tours/{media_id}":{"patch":{"tags":["admin"],"summary":"Update Virtual Tour","description":"Partial update of an admin-curated virtual-tour row.","operationId":"update_virtual_tour_api_v1_admin_media_virtual_tours__media_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VirtualTourUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Virtual Tour","description":"Hard-delete an admin-curated virtual-tour row.","operationId":"delete_virtual_tour_api_v1_admin_media_virtual_tours__media_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tools/funnel/trends":{"get":{"tags":["admin"],"summary":"Get Tool Funnel Trends","description":"Return per-day tool-funnel metrics (#209).\n\nRows ordered by ``metric_date ASC, tool_id ASC``. The aggregate\n``tool_id='all'`` row is included by default; filter with\n``?tool_id=net-price`` to drill into a single bucket.","operationId":"get_tool_funnel_trends_api_v1_admin_tools_funnel_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 90 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 90 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."},{"name":"tool_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional tool_id filter (e.g. 'net-price', 'all').","title":"Tool Id"},"description":"Optional tool_id filter (e.g. 'net-price', 'all')."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolFunnelTrendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/tools/utm-attribution":{"get":{"tags":["admin"],"summary":"Get Tool Utm Attribution","description":"Return signups grouped by UTM (source, medium, campaign) for #196 Scope B.\n\nReads `user_events.properties` JSON at admin-request time — no rollup\ntable touched. Filters to ``event_name='signup_completed'`` rows with a\nnon-null ``utm_source`` so untagged organic signups are excluded from\nthe breakdown (totals reflect community-attributed traffic only).\n\nWindow default 30d, max 180d, mirroring the funnel-trends endpoint cap.","operationId":"get_tool_utm_attribution_api_v1_admin_tools_utm_attribution_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date. Defaults to 30 days before `until`.","title":"Since"},"description":"Inclusive start date. Defaults to 30 days before `until`."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date. Defaults to today (UTC).","title":"Until"},"description":"Inclusive end date. Defaults to today (UTC)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtmAttributionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/agent-metrics/funnel":{"get":{"tags":["admin"],"summary":"Agent Funnel","description":"Per-(agent, kind) decision-funnel rows over a date range, newest first.\n\nIncludes the ``agent_name='all'`` aggregate rows. Each row carries a\n``low_sample`` flag (surfaced_decisions < ``MIN_SAMPLE``) so the admin view\ncan distinguish signal from noise.","operationId":"agent_funnel_api_v1_admin_agent_metrics_funnel_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date (UTC). Defaults to 30 days ago.","title":"Start"},"description":"Inclusive start date (UTC). Defaults to 30 days ago."},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date (UTC). Defaults to today.","title":"End"},"description":"Inclusive end date (UTC). Defaults to today."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentFunnelResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cds/summary":{"get":{"tags":["admin"],"summary":"Get Cds Summary","description":"Summary statistics of CDS data coverage.","operationId":"get_cds_summary_api_v1_admin_cds_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CDSSummary"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/cds/colleges":{"get":{"tags":["admin"],"summary":"List Colleges Cds","description":"List colleges with CDS status information.","operationId":"list_colleges_cds_api_v1_admin_cds_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: 'success', 'has_data', 'has_url', 'no_url', 'no_url_found', 'not_a_pdf', 'not_cds_document', 'extraction_failed', 'too_few_fields', 'failed', 'pending'","title":"Status"},"description":"Filter: 'success', 'has_data', 'has_url', 'no_url', 'no_url_found', 'not_a_pdf', 'not_cds_document', 'extraction_failed', 'too_few_fields', 'failed', 'pending'"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"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/v1/admin/cds/colleges/{college_id}":{"get":{"tags":["admin"],"summary":"Get College Cds Detail","description":"Full CDS data for a specific college.","operationId":"get_college_cds_detail_api_v1_admin_cds_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cds/colleges/{college_id}/url":{"put":{"tags":["admin"],"summary":"Update Cds Url","description":"Manually set or override a college's CDS URL.","operationId":"update_cds_url_api_v1_admin_cds_colleges__college_id__url_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CDSURLUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cds/colleges/{college_id}/discover":{"post":{"tags":["admin"],"summary":"Discover Cds Url","description":"Discover the CDS PDF URL for a single college via web search.","operationId":"discover_cds_url_api_v1_admin_cds_colleges__college_id__discover_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cds/colleges/{college_id}/scrape":{"post":{"tags":["admin"],"summary":"Scrape College Cds","description":"Scrape and extract CDS data for a single college.","operationId":"scrape_college_cds_api_v1_admin_cds_colleges__college_id__scrape_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cds/scrape-batch":{"post":{"tags":["admin"],"summary":"Scrape Batch Cds","description":"Trigger a batch CDS scrape via the Celery worker.\n\n``force_refresh=true`` re-extracts every college, bypassing the\nonce-per-academic-year skip-recent guard — used to backfill the fleet after\nan extraction-quality improvement. Omitted/false runs the normal cadence\n(skips colleges already synced this academic year).","operationId":"scrape_batch_cds_api_v1_admin_cds_scrape_batch_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/reviews/flagged":{"get":{"tags":["admin"],"summary":"List Flagged Reviews","description":"List reviews waiting for a person: new or edited words, and flags.","operationId":"list_flagged_reviews_api_v1_admin_reviews_flagged_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"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/v1/admin/reviews/{review_id}/moderate":{"put":{"tags":["admin"],"summary":"Moderate Review","description":"Approve or remove a review in the queue.","operationId":"moderate_review_api_v1_admin_reviews__review_id__moderate_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/feedback":{"get":{"tags":["admin"],"summary":"List Feedback","description":"Paged triage queue, newest first, with type/status/date/text filters.\n\n``status_counts`` is returned alongside so the UI can render the queue\nbreakdown without a second round trip.","operationId":"list_feedback_api_v1_admin_feedback_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"feedback_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Type"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring match on message or email","title":"Q"},"description":"Substring match on message or email"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"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/v1/admin/feedback/{feedback_id}":{"get":{"tags":["admin"],"summary":"Get Feedback","description":"Full detail for one submission.","operationId":"get_feedback_api_v1_admin_feedback__feedback_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"feedback_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Feedback Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Feedback","description":"Change status and/or internal notes. Both may move in one call.","operationId":"update_feedback_api_v1_admin_feedback__feedback_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"feedback_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Feedback Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/chat-reports":{"get":{"tags":["admin"],"summary":"List Chat Reports","description":"Paged moderation queue, newest first, with status/reason filters.\n\n``status_counts`` is returned alongside so the UI can render the queue\nbreakdown without a second round trip.","operationId":"list_chat_reports_api_v1_admin_chat_reports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"reason","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"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/v1/admin/chat-reports/{report_id}":{"get":{"tags":["admin"],"summary":"Get Chat Report","description":"Full detail for one report, including the message snapshot.","operationId":"get_chat_report_api_v1_admin_chat_reports__report_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Chat Report","description":"Change status and/or internal notes. Both may move in one call.","operationId":"update_chat_report_api_v1_admin_chat_reports__report_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatReportUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/colleges":{"get":{"tags":["admin"],"summary":"Search Colleges","description":"Search/list colleges for autocomplete and bulk enumeration.\n\n``has_url=true`` filters to colleges that have a website URL — backs the\nadmin-panel's scrape-URL generation / discovery utilities, which page\nthrough this endpoint instead of scanning the ``colleges`` table directly.","operationId":"search_colleges_api_v1_admin_colleges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"has_url","in":"query","required":false,"schema":{"type":"boolean","description":"Only colleges with a website URL set","default":false,"title":"Has Url"},"description":"Only colleges with a website URL set"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"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/v1/admin/colleges/by-ids":{"get":{"tags":["admin"],"summary":"Get Colleges By Ids","description":"Batch-resolve colleges by id.\n\nBacks the admin-panel list endpoints' denormalized ``college_name`` /\n``college_state`` hydration and bulk existence checks — one call per page\ninstead of a per-row query. Missing ids are simply absent from the result.","operationId":"get_colleges_by_ids_api_v1_admin_colleges_by_ids_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ids","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"title":"Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/colleges/{college_id}":{"get":{"tags":["admin"],"summary":"Get College","description":"Get a college by ID.","operationId":"get_college_api_v1_admin_colleges__college_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/merit-scrape/urls/{scrape_url_id}/scrape":{"post":{"tags":["admin"],"summary":"Scrape Url","description":"Scrape one stored scrape URL now.","operationId":"scrape_url_api_v1_admin_merit_scrape_urls__scrape_url_id__scrape_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"scrape_url_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scrape Url Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Scrape Url Api V1 Admin Merit Scrape Urls  Scrape Url Id  Scrape Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/merit-scrape/colleges/{college_id}/search-and-scrape":{"post":{"tags":["admin"],"summary":"Search And Scrape College","description":"Search for a college's scholarship pages and scrape the top results now.","operationId":"search_and_scrape_college_api_v1_admin_merit_scrape_colleges__college_id__search_and_scrape_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"College Id"}},{"name":"max_urls","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Maximum URLs to scrape from search results","default":3,"title":"Max Urls"},"description":"Maximum URLs to scrape from search results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search And Scrape College Api V1 Admin Merit Scrape Colleges  College Id  Search And Scrape Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/merit-scrape/patterns/{pattern_id}/test":{"post":{"tags":["admin"],"summary":"Test Pattern","description":"Run a stored pattern against sample HTML. Writes nothing.","operationId":"test_pattern_api_v1_admin_merit_scrape_patterns__pattern_id__test_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"pattern_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Pattern Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatternTestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatternTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/cache/recommendations/flush":{"post":{"tags":["admin"],"summary":"Flush Recommendation Cache","description":"Flush recommendation rankings, forcing a recompute on next request.\n\nGlobal by default (``rec:colleges:*``); pass ``profile_id`` to scope to a\nsingle profile. Always writes an invalidation tombstone so an in-flight\nrecompute doesn't persist a stale ranking (#500). Audited.","operationId":"flush_recommendation_cache_api_v1_admin_cache_recommendations_flush_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlushRecommendationCacheRequest","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/cache/revalidate-frontend":{"post":{"tags":["admin"],"summary":"Revalidate Frontend Cache","description":"Manually bust the frontend's Next.js data cache (on-demand ISR refresh).\n\nBroad by default (``colleges`` tag → all college pages re-fetch on next\nview); pass ``college_id`` to scope to one college. Per-college fires BOTH\nthe uuid tag and the college's ``slug`` tag, because public pages are served\nat ``/colleges/{slug}`` and tag their fetch by slug (the uuid tag alone\nmisses them). Complements the automatic revalidation on every data change\nvia ``invalidate_college_cache``. Best-effort (fail-open) + audited.","operationId":"revalidate_frontend_cache_api_v1_admin_cache_revalidate_frontend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevalidateFrontendRequest","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/occupations/wages/status":{"get":{"tags":["admin-occupations"],"summary":"Wage Status","description":"Current wage vintage vs the calendar-expected latest, plus coverage.","operationId":"wage_status_api_v1_admin_occupations_wages_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WageStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/occupations/wages/import":{"post":{"tags":["admin-occupations"],"summary":"Import Wages","description":"Upload an OEWS national ``.xlsx`` and upsert wages onto ``occupations``.\n\nValidation-first (extension, MIME, size cap, zip magic bytes), then the shared\n``oews_ingest`` parser (openpyxl read-only + row-cap bomb guard). The uploaded\nfile is parsed and discarded — the data persists in ``occupations``.","operationId":"import_wages_api_v1_admin_occupations_wages_import_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_import_wages_api_v1_admin_occupations_wages_import_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WageImportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/athletics/schools":{"get":{"tags":["athletics"],"summary":"List Athletics Schools","description":"Browse schools with athletic programs.\n\nReturns one card per school with aggregated program summaries.\nFilters narrow which schools appear based on whether they have matching programs.","operationId":"list_athletics_schools_api_v1_athletics_schools_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport name","title":"Sport"},"description":"Filter by sport name"},{"name":"division","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by division level","title":"Division"},"description":"Filter by division level"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by gender (men, women, coed)","title":"Gender"},"description":"Filter by gender (men, women, coed)"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by college state","title":"State"},"description":"Filter by college state"},{"name":"scholarships_available","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by scholarship availability","title":"Scholarships Available"},"description":"Filter by scholarship availability"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Schools per page","default":20,"title":"Page Size"},"description":"Schools per page"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollegeAthleticsPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/colleges/{college_id}/programs":{"get":{"tags":["athletics"],"summary":"Get College Athletic Programs","description":"Get all athletic programs for a specific college.\n\n``college_id`` accepts a UUID or a slug (#246). Returns programs with\nbasic information. Use /athletics/programs/{id} for detailed info.","operationId":"get_college_athletic_programs_api_v1_athletics_colleges__college_id__programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","description":"College UUID or slug","title":"College Id"},"description":"College UUID or slug"},{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport name","title":"Sport"},"description":"Filter by sport name"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by gender (men, women, coed)","title":"Gender"},"description":"Filter by gender (men, women, coed)"},{"name":"include_confidence","in":"query","required":false,"schema":{"type":"boolean","description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small.","default":false,"title":"Include Confidence"},"description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/AthleticProgramOutWithConfidence"},{"$ref":"#/components/schemas/AthleticProgramOut"}]},"title":"Response Get College Athletic Programs Api V1 Athletics Colleges  College Id  Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/programs":{"get":{"tags":["athletics"],"summary":"Search Athletic Programs","description":"Search for athletic programs with filters.\n\nReturns programs matching the specified criteria with pagination support.","operationId":"search_athletic_programs_api_v1_athletics_programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport name","title":"Sport"},"description":"Filter by sport name"},{"name":"division","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by division level (NCAA D1, D2, D3, NAIA, etc.)","title":"Division"},"description":"Filter by division level (NCAA D1, D2, D3, NAIA, etc.)"},{"name":"conference","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by conference name","title":"Conference"},"description":"Filter by conference name"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by gender (men, women, coed)","title":"Gender"},"description":"Filter by gender (men, women, coed)"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by college state","title":"State"},"description":"Filter by college state"},{"name":"scholarships_available","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by scholarship availability","title":"Scholarships Available"},"description":"Filter by scholarship availability"},{"name":"min_scholarship_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum average scholarship amount","title":"Min Scholarship Amount"},"description":"Minimum average scholarship amount"},{"name":"has_coaches","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Only show programs with coach information","title":"Has Coaches"},"description":"Only show programs with coach information"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"include_confidence","in":"query","required":false,"schema":{"type":"boolean","description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small.","default":false,"title":"Include Confidence"},"description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small."},{"name":"min_confidence","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"description":"Filter out programs whose average confidence across scored fields is below this threshold (0.0–1.0). Programs with no confidence data are treated as 0.0 and excluded when this is set. Applied after pagination, so a page may return fewer than page_size results.","title":"Min Confidence"},"description":"Filter out programs whose average confidence across scored fields is below this threshold (0.0–1.0). Programs with no confidence data are treated as 0.0 and excluded when this is set. Applied after pagination, so a page may return fewer than page_size results."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/AthleticProgramOutWithConfidence"},{"$ref":"#/components/schemas/AthleticProgramOut"}]},"title":"Response Search Athletic Programs Api V1 Athletics Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]},"post":{"tags":["athletics"],"summary":"Create Athletic Program","description":"Create a new athletic program (admin-only, JWT).","operationId":"create_athletic_program_api_v1_athletics_programs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticProgramCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticProgramOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/programs/count":{"get":{"tags":["athletics"],"summary":"Get Programs Count","description":"Get total count of athletic programs.","operationId":"get_programs_count_api_v1_athletics_programs_count_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport name","title":"Sport"},"description":"Filter by sport name"},{"name":"division","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by division level","title":"Division"},"description":"Filter by division level"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/programs/{program_id}":{"get":{"tags":["athletics"],"summary":"Get Athletic Program","description":"Get detailed information about a specific athletic program.\n\nIncludes coaches, opponents, and full program details.","operationId":"get_athletic_program_api_v1_athletics_programs__program_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"include_confidence","in":"query","required":false,"schema":{"type":"boolean","description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small.","default":false,"title":"Include Confidence"},"description":"Include per-field confidence scores, last_scraped_at, and data_sources in the response. Default False keeps payloads small."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AthleticProgramWithDetailsWithConfidence"},{"$ref":"#/components/schemas/AthleticProgramWithDetails"}],"title":"Response Get Athletic Program Api V1 Athletics Programs  Program Id  Get"}}}},"404":{"description":"Athletic program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]},"patch":{"tags":["athletics"],"summary":"Update Athletic Program","description":"Update an athletic program (admin-only, JWT).","operationId":"update_athletic_program_api_v1_athletics_programs__program_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticProgramUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticProgramOut"}}}},"404":{"description":"Athletic program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]},"delete":{"tags":["athletics"],"summary":"Delete Athletic Program","description":"Delete an athletic program (admin-only, JWT).","operationId":"delete_athletic_program_api_v1_athletics_programs__program_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Athletic program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/programs/{program_id}/coaches":{"get":{"tags":["athletics"],"summary":"Get Program Coaches","description":"Get all coaches for a specific athletic program.","operationId":"get_program_coaches_api_v1_athletics_programs__program_id__coaches_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleticCoachOut"},"title":"Response Get Program Coaches Api V1 Athletics Programs  Program Id  Coaches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/coaches":{"post":{"tags":["athletics"],"summary":"Create Coach","description":"Create a new coach (admin-only, JWT).","operationId":"create_coach_api_v1_athletics_coaches_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticCoachCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticCoachOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/coaches/{coach_id}":{"patch":{"tags":["athletics"],"summary":"Update Coach","description":"Update a coach (admin-only, JWT).","operationId":"update_coach_api_v1_athletics_coaches__coach_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"coach_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Coach UUID","title":"Coach Id"},"description":"Coach UUID"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticCoachUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticCoachOut"}}}},"404":{"description":"Coach not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/programs/{program_id}/opponents":{"get":{"tags":["athletics"],"summary":"Get Program Opponents","description":"Get opponents/competition schedule for a specific athletic program.","operationId":"get_program_opponents_api_v1_athletics_programs__program_id__opponents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"conference_only","in":"query","required":false,"schema":{"type":"boolean","description":"Show only conference opponents","default":false,"title":"Conference Only"},"description":"Show only conference opponents"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleticOpponentOut"},"title":"Response Get Program Opponents Api V1 Athletics Programs  Program Id  Opponents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/opponents":{"post":{"tags":["athletics"],"summary":"Create Opponent","description":"Create a new opponent record (admin-only, JWT).","operationId":"create_opponent_api_v1_athletics_opponents_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticOpponentCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticOpponentOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/profile":{"get":{"tags":["athletics"],"summary":"Get Athlete Profile","description":"Get the current user's athlete profile.","operationId":"get_athlete_profile_api_v1_athletics_profile_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAthleticsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]},"post":{"tags":["athletics"],"summary":"Create Athlete Profile","description":"Create an athlete profile for the current user.","operationId":"create_athlete_profile_api_v1_athletics_profile_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAthleticsCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAthleticsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]},"patch":{"tags":["athletics"],"summary":"Update Athlete Profile","description":"Update the current user's athlete profile.","operationId":"update_athlete_profile_api_v1_athletics_profile_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAthleticsUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileAthleticsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/match":{"post":{"tags":["athletics"],"summary":"Match Programs","description":"Find athletic programs matching the current user's athlete profile.\n\nReturns programs with match scores and reasons, sorted by best match.","operationId":"match_programs_api_v1_athletics_match_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":50,"title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleticProgramMatch"},"title":"Response Match Programs Api V1 Athletics Match Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/sports":{"get":{"tags":["athletics"],"summary":"List Available Sports","description":"Get list of all available sports.","operationId":"list_available_sports_api_v1_athletics_sports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response List Available Sports Api V1 Athletics Sports Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/divisions":{"get":{"tags":["athletics"],"summary":"List Available Divisions","description":"Get list of all available division levels.","operationId":"list_available_divisions_api_v1_athletics_divisions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response List Available Divisions Api V1 Athletics Divisions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/conferences":{"get":{"tags":["athletics"],"summary":"List Available Conferences","description":"Get list of all available conferences.","operationId":"list_available_conferences_api_v1_athletics_conferences_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response List Available Conferences Api V1 Athletics Conferences Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/data-quality":{"get":{"tags":["athletics"],"summary":"Get Data Quality","description":"Athletics data quality report (admin only). Returns all colleges and flagged records.","operationId":"get_data_quality_api_v1_athletics_data_quality_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticsDataQualityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:athletics"]}},"/api/v1/athletics/communications":{"get":{"tags":["athletics-recruitment"],"summary":"List Communications","description":"List the current user's coach communications.","operationId":"list_communications_api_v1_athletics_communications_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by athletic program","title":"Program Id"},"description":"Filter by athletic program"},{"name":"communication_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by type","title":"Communication Type"},"description":"Filter by type"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CoachCommunicationOut"},"title":"Response List Communications Api V1 Athletics Communications Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["athletics-recruitment"],"summary":"Create Communication","description":"Log a new coach communication.","operationId":"create_communication_api_v1_athletics_communications_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCommunicationCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCommunicationOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/communications/timeline/{program_id}":{"get":{"tags":["athletics-recruitment"],"summary":"Get Program Communication Timeline","description":"Get communication timeline for a specific program.","operationId":"get_program_communication_timeline_api_v1_athletics_communications_timeline__program_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CoachCommunicationOut"},"title":"Response Get Program Communication Timeline Api V1 Athletics Communications Timeline  Program Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/communications/{communication_id}":{"patch":{"tags":["athletics-recruitment"],"summary":"Update Communication","description":"Update a coach communication.","operationId":"update_communication_api_v1_athletics_communications__communication_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"communication_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Communication UUID","title":"Communication Id"},"description":"Communication UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCommunicationUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachCommunicationOut"}}}},"404":{"description":"Communication not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["athletics-recruitment"],"summary":"Delete Communication","description":"Delete a coach communication.","operationId":"delete_communication_api_v1_athletics_communications__communication_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"communication_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Communication UUID","title":"Communication Id"},"description":"Communication UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Communication not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/events":{"get":{"tags":["athletics-recruitment"],"summary":"List Events","description":"List the current user's recruiting events.","operationId":"list_events_api_v1_athletics_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event type","title":"Event Type"},"description":"Filter by event type"},{"name":"upcoming_only","in":"query","required":false,"schema":{"type":"boolean","description":"Show only future events","default":false,"title":"Upcoming Only"},"description":"Show only future events"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecruitingEventOut"},"title":"Response List Events Api V1 Athletics Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["athletics-recruitment"],"summary":"Create Event","description":"Create a recruiting event.","operationId":"create_event_api_v1_athletics_events_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecruitingEventCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecruitingEventOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/events/{event_id}":{"patch":{"tags":["athletics-recruitment"],"summary":"Update Event","description":"Update a recruiting event.","operationId":"update_event_api_v1_athletics_events__event_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Event UUID","title":"Event Id"},"description":"Event UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecruitingEventUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecruitingEventOut"}}}},"404":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["athletics-recruitment"],"summary":"Delete Event","description":"Delete a recruiting event.","operationId":"delete_event_api_v1_athletics_events__event_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Event UUID","title":"Event Id"},"description":"Event UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/videos":{"get":{"tags":["athletics-recruitment"],"summary":"List Videos","description":"List the current user's videos.","operationId":"list_videos_api_v1_athletics_videos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleteVideoOut"},"title":"Response List Videos Api V1 Athletics Videos Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["athletics-recruitment"],"summary":"Create Video","description":"Add a highlight video link.","operationId":"create_video_api_v1_athletics_videos_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleteVideoCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleteVideoOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/videos/{video_id}":{"patch":{"tags":["athletics-recruitment"],"summary":"Update Video","description":"Update a video's details.","operationId":"update_video_api_v1_athletics_videos__video_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"video_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Video UUID","title":"Video Id"},"description":"Video UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleteVideoUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleteVideoOut"}}}},"404":{"description":"Video not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["athletics-recruitment"],"summary":"Delete Video","description":"Remove a video.","operationId":"delete_video_api_v1_athletics_videos__video_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"video_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Video UUID","title":"Video Id"},"description":"Video UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Video not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/videos/{video_id}/primary":{"patch":{"tags":["athletics-recruitment"],"summary":"Set Primary Video","description":"Set a video as the primary highlight reel.","operationId":"set_primary_video_api_v1_athletics_videos__video_id__primary_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"video_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Video UUID","title":"Video Id"},"description":"Video UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleteVideoOut"}}}},"404":{"description":"Video not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/saved-programs":{"get":{"tags":["athletics-recruitment"],"summary":"List Saved Programs","description":"List the current user's saved athletic programs, with their names (#763).","operationId":"list_saved_programs_api_v1_athletics_saved_programs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SavedAthleticProgramOut"},"title":"Response List Saved Programs Api V1 Athletics Saved Programs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["athletics-recruitment"],"summary":"Save Program","description":"Save an athletic program.","operationId":"save_program_api_v1_athletics_saved_programs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAthleticProgramCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAthleticProgramOut"}}}},"400":{"description":"Program already saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Athletic program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/saved-programs/{program_id}":{"delete":{"tags":["athletics-recruitment"],"summary":"Unsave Program","description":"Unsave an athletic program.","operationId":"unsave_program_api_v1_athletics_saved_programs__program_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Athletic program UUID","title":"Program Id"},"description":"Athletic program UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Saved program not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/compare":{"get":{"tags":["athletics-recruitment"],"summary":"Compare Programs","description":"Compare 2-4 athletic programs side-by-side.","operationId":"compare_programs_api_v1_athletics_compare_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"program_ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated program IDs (2-4)","title":"Program Ids"},"description":"Comma-separated program IDs (2-4)"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramComparisonResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/performance":{"get":{"tags":["athletics-recruitment"],"summary":"List Performance Entries","description":"List the current user's performance entries.","operationId":"list_performance_entries_api_v1_athletics_performance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport","title":"Sport"},"description":"Filter by sport"},{"name":"stat_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by stat name","title":"Stat Name"},"description":"Filter by stat name"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleticPerformanceEntryOut"},"title":"Response List Performance Entries Api V1 Athletics Performance Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["athletics-recruitment"],"summary":"Create Performance Entry","description":"Log a performance entry.","operationId":"create_performance_entry_api_v1_athletics_performance_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticPerformanceEntryCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticPerformanceEntryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/performance/{entry_id}":{"patch":{"tags":["athletics-recruitment"],"summary":"Update Performance Entry","description":"Update a performance entry.","operationId":"update_performance_entry_api_v1_athletics_performance__entry_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Performance entry UUID","title":"Entry Id"},"description":"Performance entry UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticPerformanceEntryUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthleticPerformanceEntryOut"}}}},"404":{"description":"Performance entry not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["athletics-recruitment"],"summary":"Delete Performance Entry","description":"Delete a performance entry.","operationId":"delete_performance_entry_api_v1_athletics_performance__entry_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Performance entry UUID","title":"Entry Id"},"description":"Performance entry UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller needs an edit grant on it; a view-only parent/counselor/shared grant is not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Performance entry not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/performance/trends":{"get":{"tags":["athletics-recruitment"],"summary":"Get Trends","description":"Get performance trends with optional benchmark comparison.","operationId":"get_trends_api_v1_athletics_performance_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport","title":"Sport"},"description":"Filter by sport"},{"name":"stat_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by stat name","title":"Stat Name"},"description":"Filter by stat name"},{"name":"division_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Division to compare benchmarks against","title":"Division Level"},"description":"Division to compare benchmarks against"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gender for benchmark lookup","title":"Gender"},"description":"Gender for benchmark lookup"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PerformanceTrend"},"title":"Response Get Trends Api V1 Athletics Performance Trends Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/athletics/benchmarks":{"get":{"tags":["athletics-recruitment"],"summary":"List Benchmarks","description":"Get athletic benchmarks. No authentication required.","operationId":"list_benchmarks_api_v1_athletics_benchmarks_get","parameters":[{"name":"sport","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sport","title":"Sport"},"description":"Filter by sport"},{"name":"division_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by division level","title":"Division Level"},"description":"Filter by division level"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by gender","title":"Gender"},"description":"Filter by gender"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page","default":100,"title":"Page Size"},"description":"Results per page"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AthleticBenchmarkOut"},"title":"Response List Benchmarks Api V1 Athletics Benchmarks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/colleges/{college_id}/reviews":{"get":{"tags":["reviews"],"summary":"Get College Reviews","description":"List published reviews for a college (public).","operationId":"get_college_reviews_api_v1_colleges__college_id__reviews_get","parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"College UUID","title":"College Id"},"description":"College UUID"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results to return","default":20,"title":"Limit"},"description":"Maximum results to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicReviewOut"},"title":"Response Get College Reviews Api V1 Colleges  College Id  Reviews Get"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["reviews"],"summary":"Submit Review","description":"Submit or replace a review for a college. One review per profile per college.","operationId":"submit_review_api_v1_colleges__college_id__reviews_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"College UUID","title":"College Id"},"description":"College UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewOut"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Review was removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/colleges/{college_id}/reviews/summary":{"get":{"tags":["reviews"],"summary":"Get College Review Summary","description":"Get aggregated rating and recent reviews for a college (public).","operationId":"get_college_review_summary_api_v1_colleges__college_id__reviews_summary_get","parameters":[{"name":"college_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"College UUID","title":"College Id"},"description":"College UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewSummaryOut"}}}},"404":{"description":"College not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/reviews/{review_id}":{"put":{"tags":["reviews"],"summary":"Edit Review","description":"Edit own review.","operationId":"edit_review_api_v1_reviews__review_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Review UUID","title":"Review Id"},"description":"Review UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewOut"}}}},"404":{"description":"Review not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Review was removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["reviews"],"summary":"Delete Review","description":"Delete own review.","operationId":"delete_review_api_v1_reviews__review_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Review UUID","title":"Review Id"},"description":"Review UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Review not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/reviews/{review_id}/flag":{"post":{"tags":["reviews"],"summary":"Flag Review","description":"Flag a review for moderation.","operationId":"flag_review_api_v1_reviews__review_id__flag_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Review UUID","title":"Review Id"},"description":"Review UUID"},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient.","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. The caller must be the profile's owner; invited parent/counselor/shared grants are not sufficient."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewFlagRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewFlagResponse"}}}},"404":{"description":"Review not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/my-reviews":{"get":{"tags":["reviews"],"summary":"Get My Reviews","description":"List all reviews by the current profile.","operationId":"get_my_reviews_api_v1_my_reviews_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Required only when an account has multiple profiles (e.g., a counselor managing several students)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ReviewOut"},"title":"Response Get My Reviews Api V1 My Reviews Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/documents":{"post":{"tags":["documents"],"summary":"Upload Document","description":"Upload a new document for the profile.","operationId":"upload_document_api_v1_profiles__profile_id__documents_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_document_api_v1_profiles__profile_id__documents_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["documents"],"summary":"List Documents","description":"List documents for a profile with filtering and pagination.","operationId":"list_documents_api_v1_profiles__profile_id__documents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"description":"Filter by document type","title":"Document Type"},"description":"Filter by document type"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}],"description":"Filter by document category","title":"Category"},"description":"Filter by document category"},{"name":"is_active","in":"query","required":false,"schema":{"type":"boolean","description":"Filter by active status","default":true,"title":"Is Active"},"description":"Filter by active status"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by document title","title":"Search"},"description":"Search by document title"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/documents/text":{"post":{"tags":["documents"],"summary":"Create Text Document","description":"Write a document in the app (#769): an essay or résumé, stored as text.","operationId":"create_text_document_api_v1_profiles__profile_id__documents_text_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileTextDocumentCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/documents/statistics":{"get":{"tags":["documents"],"summary":"Get Document Statistics","description":"Get statistics about documents for a profile.\n\nDeclared before ``/{document_id}``, which would otherwise match\n``statistics`` as a document id (#856).","operationId":"get_document_statistics_api_v1_profiles__profile_id__documents_statistics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentStatistics"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/documents/{document_id}":{"get":{"tags":["documents"],"summary":"Get Document","description":"Get a specific document by ID.","operationId":"get_document_api_v1_profiles__profile_id__documents__document_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Document UUID","title":"Document Id"},"description":"Document UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["documents"],"summary":"Update Document","description":"Update document metadata.","operationId":"update_document_api_v1_profiles__profile_id__documents__document_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Document UUID","title":"Document Id"},"description":"Document UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileDocumentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["documents"],"summary":"Delete Document","description":"Delete a document (soft delete by default).","operationId":"delete_document_api_v1_profiles__profile_id__documents__document_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Document UUID","title":"Document Id"},"description":"Document UUID"},{"name":"hard_delete","in":"query","required":false,"schema":{"type":"boolean","description":"Permanently delete file","default":false,"title":"Hard Delete"},"description":"Permanently delete file"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/documents/{document_id}/download":{"get":{"tags":["documents"],"summary":"Download Document","description":"Download a document file.","operationId":"download_document_api_v1_profiles__profile_id__documents__document_id__download_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Document UUID","title":"Document Id"},"description":"Document UUID"}],"responses":{"200":{"description":"File download","content":{"application/octet-stream":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/templates":{"post":{"tags":["email-templates"],"summary":"Create Template","description":"Create a new email template for the profile.","operationId":"create_template_api_v1_profiles__profile_id__templates_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["email-templates"],"summary":"List Templates","description":"List email templates (user + optionally system templates).","operationId":"list_templates_api_v1_profiles__profile_id__templates_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"recipient_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OutreachRecipientType"},{"type":"null"}],"description":"Filter by recipient type","title":"Recipient Type"},"description":"Filter by recipient type"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}],"description":"Filter by template category","title":"Category"},"description":"Filter by template category"},{"name":"include_system","in":"query","required":false,"schema":{"type":"boolean","description":"Include system templates","default":true,"title":"Include System"},"description":"Include system templates"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by template name or subject","title":"Search"},"description":"Search by template name or subject"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/templates/system":{"get":{"tags":["email-templates"],"summary":"List System Templates","description":"List system email templates (no profile required).","operationId":"list_system_templates_api_v1_templates_system_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"recipient_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OutreachRecipientType"},{"type":"null"}],"description":"Filter by recipient type","title":"Recipient Type"},"description":"Filter by recipient type"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EmailTemplateResponse"},"title":"Response List System Templates Api V1 Templates System Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/templates/{template_id}":{"get":{"tags":["email-templates"],"summary":"Get Template","description":"Get a specific template by ID.","operationId":"get_template_api_v1_profiles__profile_id__templates__template_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Template UUID","title":"Template Id"},"description":"Template UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["email-templates"],"summary":"Update Template","description":"Update an email template (only user's own templates, not system templates).","operationId":"update_template_api_v1_profiles__profile_id__templates__template_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Template UUID","title":"Template Id"},"description":"Template UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["email-templates"],"summary":"Delete Template","description":"Delete a template (soft delete, only user's own templates).","operationId":"delete_template_api_v1_profiles__profile_id__templates__template_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Template UUID","title":"Template Id"},"description":"Template UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/templates/render":{"post":{"tags":["email-templates"],"summary":"Render Template Endpoint","description":"Render a template with placeholder values.","operationId":"render_template_endpoint_api_v1_profiles__profile_id__templates_render_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateRenderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateRenderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/recipients":{"post":{"tags":["outreach-recipients"],"summary":"Create Recipient","description":"Create a new outreach recipient (contact) for the profile.","operationId":"create_recipient_api_v1_profiles__profile_id__outreach_recipients_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["outreach-recipients"],"summary":"List Recipients","description":"List outreach recipients for a profile.","operationId":"list_recipients_api_v1_profiles__profile_id__outreach_recipients_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"recipient_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OutreachRecipientType"},{"type":"null"}],"description":"Filter by recipient type","title":"Recipient Type"},"description":"Filter by recipient type"},{"name":"organization","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by organization name","title":"Organization"},"description":"Filter by organization name"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by name or email","title":"Search"},"description":"Search by name or email"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/recipients/{recipient_id}":{"get":{"tags":["outreach-recipients"],"summary":"Get Recipient","description":"Get a specific outreach recipient.","operationId":"get_recipient_api_v1_profiles__profile_id__outreach_recipients__recipient_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"recipient_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Recipient UUID","title":"Recipient Id"},"description":"Recipient UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["outreach-recipients"],"summary":"Update Recipient","description":"Update an outreach recipient.","operationId":"update_recipient_api_v1_profiles__profile_id__outreach_recipients__recipient_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"recipient_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Recipient UUID","title":"Recipient Id"},"description":"Recipient UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachRecipientResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["outreach-recipients"],"summary":"Delete Recipient","description":"Soft-delete an outreach recipient.","operationId":"delete_recipient_api_v1_profiles__profile_id__outreach_recipients__recipient_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"recipient_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Recipient UUID","title":"Recipient Id"},"description":"Recipient UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/activities":{"post":{"tags":["outreach-activities"],"summary":"Create Activity","description":"Create a new outreach activity (draft email).","operationId":"create_activity_api_v1_profiles__profile_id__outreach_activities_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["outreach-activities"],"summary":"List Activities","description":"List outreach activities for a profile.","operationId":"list_activities_api_v1_profiles__profile_id__outreach_activities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Page Size"},"description":"Results per page"},{"name":"recipient_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by recipient ID","title":"Recipient Id"},"description":"Filter by recipient ID"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OutreachStatus"},{"type":"null"}],"description":"Filter by outreach status","title":"Status"},"description":"Filter by outreach status"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/activities/{activity_id}":{"get":{"tags":["outreach-activities"],"summary":"Get Activity","description":"Get a specific outreach activity.","operationId":"get_activity_api_v1_profiles__profile_id__outreach_activities__activity_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["outreach-activities"],"summary":"Update Activity","description":"Update an outreach activity (drafts only for subject/body changes).","operationId":"update_activity_api_v1_profiles__profile_id__outreach_activities__activity_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["outreach-activities"],"summary":"Delete Activity","description":"Delete an outreach activity (drafts only).","operationId":"delete_activity_api_v1_profiles__profile_id__outreach_activities__activity_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/activities/{activity_id}/send":{"post":{"tags":["outreach-activities"],"summary":"Send Activity","description":"Send an outreach email.\n\nOwner-only: sending is outbound-as-the-student (the reply-to is the\nstudent's profile email), which a ``can_edit`` grant does not convey\n(ARCHITECTURE §\"Cross-persona boards\" rule 4, #498). Composing/editing a\ndraft (create/update) stays ``can_edit`` — only the irreversible send is\ngated to the owner.","operationId":"send_activity_api_v1_profiles__profile_id__outreach_activities__activity_id__send_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivitySend"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/statistics":{"get":{"tags":["outreach-activities"],"summary":"Get Outreach Statistics","description":"Get outreach statistics for a profile.","operationId":"get_outreach_statistics_api_v1_profiles__profile_id__outreach_statistics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachStatistics"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/activities/{activity_id}/preview":{"get":{"tags":["outreach-activities"],"summary":"Preview Activity","description":"Preview an outreach activity with merge fields resolved from profile data.","operationId":"preview_activity_api_v1_profiles__profile_id__outreach_activities__activity_id__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActivityPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/profiles/{profile_id}/outreach/activities/{activity_id}/thread":{"get":{"tags":["outreach-activities"],"summary":"Get Activity Thread","description":"Get the full conversation thread for an outreach activity.\n\nReturns the root outbound activity and all of its replies, ordered\nchronologically.","operationId":"get_activity_thread_api_v1_profiles__profile_id__outreach_activities__activity_id__thread_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Profile UUID","title":"Profile Id"},"description":"Profile UUID"},{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Activity UUID","title":"Activity Id"},"description":"Activity UUID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/resources":{"get":{"tags":["resources"],"summary":"List Articles","description":"List published articles, optionally filtered by category.","operationId":"list_articles_api_v1_resources_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by article category","title":"Category"},"description":"Filter by article category"},{"name":"featured","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter for featured articles only","title":"Featured"},"description":"Filter for featured articles only"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Maximum results to return","default":50,"title":"Limit"},"description":"Maximum results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Offset"},"description":"Number of records to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ArticleSummary"},"title":"Response List Articles Api V1 Resources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/resources/slugs":{"get":{"tags":["resources"],"summary":"List Article Slugs","description":"Get all published article slugs (for sitemap/static generation).","operationId":"list_article_slugs_api_v1_resources_slugs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response List Article Slugs Api V1 Resources Slugs Get"}}}}}}},"/api/v1/resources/{slug}":{"get":{"tags":["resources"],"summary":"Get Article By Slug","description":"Get a single published article by slug.","operationId":"get_article_by_slug_api_v1_resources__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","description":"Article URL slug","title":"Slug"},"description":"Article URL slug"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleOut"}}}},"404":{"description":"Article not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articles/images/{image_id}":{"get":{"tags":["articles"],"summary":"Get Article Image","description":"Return the raw image bytes for the given article-image id.\n\n404 if the row doesn't exist. Browser/CDN caching is aggressive\nbecause image IDs are unique per upload — content is immutable.","operationId":"get_article_image_api_v1_articles_images__image_id__get","parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events":{"post":{"tags":["events"],"summary":"Ingest Events","description":"Ingest a batch of user interaction events.\n\nAccepts both authenticated and anonymous requests.\nAuthenticated requests capture user_id from JWT.\nAnonymous requests must include anonymous_id on each event.","operationId":"ingest_events_api_v1_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventBatchIn"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventBatchOut"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/register":{"post":{"tags":["developer"],"summary":"Register as a developer","description":"Upgrade the current user to the ``developer`` role and persist optional\nprofile metadata. Idempotent — re-registering only updates fields that\nare explicitly supplied; omitted fields are preserved.","operationId":"register_developer_api_v1_developer_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperRegisterRequest","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperProfileResponse"}}}},"401":{"description":"Missing or invalid credentials"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/profile":{"get":{"tags":["developer"],"summary":"Get developer profile","description":"Return the developer profile and a summary of issued keys.\n\nIf the user has a developer/admin role but never explicitly registered\n(no row in ``developer_profiles``), we auto-create a blank profile here\nso they don't get bounced through the registration form for a step that\nwould only ever default-fill the same nullable fields. The explicit\n``POST /api/developer/register`` flow remains useful for collecting\noptional metadata (app_name, website, use_case).","operationId":"get_profile_api_v1_developer_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperProfileResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/scopes":{"get":{"tags":["developer"],"summary":"List grantable API key scopes","description":"Return the scopes the current developer may request for a new key.\n\nFor admins, ``all`` includes the full superset; for non-admin developers\n``all`` equals ``public``.","operationId":"list_scopes_api_v1_developer_scopes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopesResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/keys":{"get":{"tags":["developer"],"summary":"List API keys","description":"List all API keys belonging to the current user. Hashes are never\nexposed; only the key prefix and metadata are returned.","operationId":"list_keys_api_v1_developer_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiKeyResponse"},"type":"array","title":"Response List Keys Api V1 Developer Keys Get"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["developer"],"summary":"Create an API key","description":"Generate a new API key. The raw key is returned **once** in this\nresponse and cannot be retrieved again.","operationId":"create_key_api_v1_developer_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreatedResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"},"422":{"description":"Unknown scope(s)"}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/keys/{key_id}":{"get":{"tags":["developer"],"summary":"Get a single API key","description":"Fetch metadata for a single key. Returns 404 for keys not owned by\nthe current user — existence of foreign keys is never disclosed.","operationId":"get_key_api_v1_developer_keys__key_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"},"404":{"description":"Key not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["developer"],"summary":"Revoke an API key","description":"Soft-delete an API key. Idempotent — revoking an already-revoked key\nis a no-op and still returns 204.","operationId":"revoke_key_api_v1_developer_keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"},"404":{"description":"Key not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/developer/keys/{key_id}/rotate":{"post":{"tags":["developer"],"summary":"Rotate an API key","description":"Atomically revoke an existing key and issue a replacement with the\nsame name, scopes, tier, and expiry. The new raw key is returned once.\n\nA revoked key can't be rotated (409), and the key's scopes must still be\nones the caller may grant (403), #1011.","operationId":"rotate_key_api_v1_developer_keys__key_id__rotate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreatedResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"},"404":{"description":"Key not found"},"409":{"description":"Key has been revoked"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/developer/usage":{"get":{"tags":["developer"],"summary":"Aggregate usage stats","description":"Return aggregate usage across all of the current user's API keys.","operationId":"get_usage_api_v1_developer_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"}},"security":[{"HTTPBearer":[]}]}},"/api/v1/developer/changelog":{"get":{"tags":["developer"],"summary":"Public API changelog","description":"List API changelog entries newest first. Public — no auth required so\nthat anonymous developers can review the changelog before signing up.\nSupports filtering by version and \"breaking only\".","operationId":"get_changelog_api_v1_developer_changelog_get","parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by API version (e.g. v1)","title":"Version"},"description":"Filter by API version (e.g. v1)"},{"name":"breaking","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"If true, only breaking changes","title":"Breaking"},"description":"If true, only breaking changes"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiChangelogListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/developer/changelog.rss":{"get":{"tags":["developer"],"summary":"Public API changelog (RSS feed)","description":"RSS 2.0 feed of the most recent 50 changelog entries.\n\nHonors ``If-None-Match`` for cheap 304 revalidation — feed readers poll\naggressively, so a weak ETag derived from the most recent ``updated_at``\nkeeps repeat polls free.","operationId":"get_changelog_rss_api_v1_developer_changelog_rss_get","responses":{"200":{"description":"Successful Response"}}}},"/api/v1/developer/usage/{key_id}":{"get":{"tags":["developer"],"summary":"Per-key usage stats","description":"Return usage stats scoped to a single API key.","operationId":"get_key_usage_api_v1_developer_usage__key_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"description":"Missing or invalid credentials"},"403":{"description":"User is not registered as a developer"},"404":{"description":"Key not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations":{"post":{"tags":["organizations"],"summary":"Create Organization","operationId":"create_organization_api_v1_organizations_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"List Organizations","operationId":"list_organizations_api_v1_organizations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/listing-me":{"get":{"tags":["organizations"],"summary":"List Organizations Listing Me","description":"Organizations that list the caller on their student roster.\n\nA roster row is created unilaterally by an org admin, and `GET /organizations`\nonly returns *memberships* -- so without this a student has no way to see, or\nask about, an organization that has listed them.","operationId":"list_organizations_listing_me_api_v1_organizations_listing_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationListingMeResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/organizations/by-slug/{slug}":{"get":{"tags":["organizations"],"summary":"Get Organization By Slug","description":"Resolve an org by its slug. Returns the same payload as ``GET /{org_id}``\nso the frontend can use slug-based URLs (#123) while keeping every other\norg endpoint UUID-keyed. 404 for non-members (privacy).","operationId":"get_organization_by_slug_api_v1_organizations_by_slug__slug__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}":{"get":{"tags":["organizations"],"summary":"Get Organization","operationId":"get_organization_api_v1_organizations__org_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["organizations"],"summary":"Update Organization","operationId":"update_organization_api_v1_organizations__org_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["organizations"],"summary":"Delete Organization","operationId":"delete_organization_api_v1_organizations__org_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/members":{"get":{"tags":["organizations"],"summary":"List Organization Members","operationId":"list_organization_members_api_v1_organizations__org_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationMemberListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/members/{user_id}/role":{"patch":{"tags":["organizations"],"summary":"Change Organization Member Role","operationId":"change_organization_member_role_api_v1_organizations__org_id__members__user_id__role_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationMemberRoleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationMemberRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/members/{user_id}":{"delete":{"tags":["organizations"],"summary":"Remove Organization Member","operationId":"remove_organization_member_api_v1_organizations__org_id__members__user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"reassign_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Member who inherits the removed member's assigned students. Required (409 otherwise) when the member has any — a caseload is never dropped silently (#662).","title":"Reassign To"},"description":"Member who inherits the removed member's assigned students. Required (409 otherwise) when the member has any — a caseload is never dropped silently (#662)."}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/transfer":{"post":{"tags":["organizations"],"summary":"Transfer Organization Ownership","operationId":"transfer_organization_ownership_api_v1_organizations__org_id__transfer_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationOwnershipTransfer"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/leave":{"post":{"tags":["organizations"],"summary":"Leave Organization Endpoint","operationId":"leave_organization_endpoint_api_v1_organizations__org_id__leave_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invitations":{"post":{"tags":["organizations"],"summary":"Create Organization Invitation","operationId":"create_organization_invitation_api_v1_organizations__org_id__invitations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"List Organization Invitations","operationId":"list_organization_invitations_api_v1_organizations__org_id__invitations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["pending","accepted","expired","revoked"],"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invitations/{invitation_id}":{"delete":{"tags":["organizations"],"summary":"Revoke Organization Invitation","operationId":"revoke_organization_invitation_api_v1_organizations__org_id__invitations__invitation_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"invitation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invitation Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invitations/{invitation_id}/resend":{"post":{"tags":["organizations"],"summary":"Resend Organization Invitation","operationId":"resend_organization_invitation_api_v1_organizations__org_id__invitations__invitation_id__resend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"invitation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invitation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/student-invitations":{"post":{"tags":["organizations"],"summary":"Create Student Invitations","operationId":"create_student_invitations_api_v1_organizations__org_id__student_invitations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentInvitationCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentInvitationCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"List Student Invitations","operationId":"list_student_invitations_api_v1_organizations__org_id__student_invitations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["pending","accepted","expired","revoked"],"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/join-codes":{"post":{"tags":["organizations"],"summary":"Create Join Code","description":"Create the org's join code; any active one is revoked.","operationId":"create_join_code_api_v1_organizations__org_id__join_codes_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationJoinCodeCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationJoinCodeRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"List Join Codes","operationId":"list_join_codes_api_v1_organizations__org_id__join_codes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationJoinCodeListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/join-codes/{code_id}":{"delete":{"tags":["organizations"],"summary":"Revoke Join Code","operationId":"revoke_join_code_api_v1_organizations__org_id__join_codes__code_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"code_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Code Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/join/{code}":{"get":{"tags":["organizations"],"summary":"Look Up Join Code","description":"Public: the organization a join code belongs to (name and type only).\n\nEvery unusable code gets the same 404, so the lookup doesn't say whether a\ncode exists, expired, ran out or was revoked. Rate-limited per IP.","operationId":"look_up_join_code_api_v1_organizations_join__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinCodePublicRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/join":{"post":{"tags":["organizations"],"summary":"Join By Code","description":"Join an organization's student list with its code, answering whether\nto share my college list and progress with its counselor.","operationId":"join_by_code_api_v1_organizations_join_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/organizations/invitations/mine":{"get":{"tags":["organizations"],"summary":"List My Organization Invitations","description":"The signed-in user's own pending invitations, with their tokens (#873).","operationId":"list_my_organization_invitations_api_v1_organizations_invitations_mine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrganizationInvitationMine"},"type":"array","title":"Response List My Organization Invitations Api V1 Organizations Invitations Mine Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/organizations/invitations/{token}":{"get":{"tags":["organizations"],"summary":"Get Organization Invitation Public","description":"Pre-login lookup for the frontend join page. Public on purpose: the\ntoken is the bearer secret. Returns no privileged fields (no org_id).","operationId":"get_organization_invitation_public_api_v1_organizations_invitations__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationPublicRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students":{"get":{"tags":["organizations"],"summary":"List Organization Students","operationId":"list_organization_students_api_v1_organizations__org_id__students_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"assigned_counselor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Counselor Id"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organizations"],"summary":"Add Organization Student","operationId":"add_organization_student_api_v1_organizations__org_id__students_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/bulk":{"post":{"tags":["organizations"],"summary":"Bulk Add Organization Students","operationId":"bulk_add_organization_students_api_v1_organizations__org_id__students_bulk_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentBulkAdd"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentBulkAddResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/attention":{"get":{"tags":["organizations"],"summary":"Get Roster Attention","description":"Which students need attention this week, and why (#1091, ARCHITECTURE\nrule 6b). The caller's caseload or organization; profile flags only behind\nthe viewer's own grant; owners and admins also get per-counselor counts.\nOne audit row per request.","operationId":"get_roster_attention_api_v1_organizations__org_id__students_attention_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RosterAttentionRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/me":{"delete":{"tags":["organizations"],"summary":"Leave Organization Roster","description":"The signed-in student leaves this organization's student list.","operationId":"leave_organization_roster_api_v1_organizations__org_id__students_me_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/me/consent":{"put":{"tags":["organizations"],"summary":"Set My Share Consent","description":"Share, or stop sharing, my college list and progress with this\norganization's assigned counselor.","operationId":"set_my_share_consent_api_v1_organizations__org_id__students_me_consent_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareConsentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationListingMeRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/me/records":{"get":{"tags":["organizations"],"summary":"Get My Org Records","description":"What this organization has recorded about me (#874): read-only.","operationId":"get_my_org_records_api_v1_organizations__org_id__students_me_records_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnRecordsRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/me/activity":{"get":{"tags":["organizations"],"summary":"Get My Activity View","description":"What this organization's counselor sees of my college search (#1090),\nand when they last looked. Not audited: it's my own.","operationId":"get_my_activity_view_api_v1_organizations__org_id__students_me_activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentActivityRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/tracker":{"get":{"tags":["organizations"],"summary":"Get Organization Tracker","description":"The caseload (a counselor) or the organization (owner, admin), with the\norganization's records, and the student's own answers and list flag only\nwhere the viewer holds a grant on the student's profile.","operationId":"get_organization_tracker_api_v1_organizations__org_id__tracker_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"counselor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Counselor"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Q"}},{"name":"class_year","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Class Year"}},{"name":"fafsa_step","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Fafsa Step"}},{"name":"flag","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Flag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackerResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/tracker/records":{"put":{"tags":["organizations"],"summary":"Update Organization Tracker Records","description":"Record or clear one step for one or more students. A counselor records\nonly for their own caseload.","operationId":"update_organization_tracker_records_api_v1_organizations__org_id__tracker_records_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackerRecordUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackerUpdateResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/tracker/class-year":{"put":{"tags":["organizations"],"summary":"Update Organization Tracker Class Year","operationId":"update_organization_tracker_class_year_api_v1_organizations__org_id__tracker_class_year_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackerClassYearUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackerUpdateResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/tracker/export.csv":{"get":{"tags":["organizations"],"summary":"Export Organization Tracker","description":"The same rows as the screen, as CSV. Audited (counts and filters only).","operationId":"export_organization_tracker_api_v1_organizations__org_id__tracker_export_csv_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"counselor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Counselor"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Q"}},{"name":"class_year","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Class Year"}},{"name":"fafsa_step","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Fafsa Step"}},{"name":"flag","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Flag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/{student_user_id}":{"delete":{"tags":["organizations"],"summary":"Remove Organization Student","operationId":"remove_organization_student_api_v1_organizations__org_id__students__student_user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"student_user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Student User Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"Get Organization Student","operationId":"get_organization_student_api_v1_organizations__org_id__students__student_user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"student_user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Student User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/{student_user_id}/assign":{"patch":{"tags":["organizations"],"summary":"Assign Organization Student Counselor","operationId":"assign_organization_student_counselor_api_v1_organizations__org_id__students__student_user_id__assign_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"student_user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Student User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentAssign"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationStudentRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/students/{student_user_id}/activity":{"get":{"tags":["organizations"],"summary":"Get Organization Student Activity","description":"How one student's college search is going (#1090, ARCHITECTURE rule\n6a). Profile data only behind the viewer's own grant; every view audited.","operationId":"get_organization_student_activity_api_v1_organizations__org_id__students__student_user_id__activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"student_user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Student User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentActivityRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/analytics/overview":{"get":{"tags":["organizations"],"summary":"Get Organization Analytics Overview","description":"Aggregate stats: students, counselors, saved colleges, conversations,\nprofile completion rate, and 30-day active student count. Owners and\nadmins get the organization; a counselor gets their own caseload\n(``scope`` says which, #661). Cached for 5 minutes.","operationId":"get_organization_analytics_overview_api_v1_organizations__org_id__analytics_overview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgAnalyticsOverview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/analytics/engagement":{"get":{"tags":["organizations"],"summary":"Get Organization Analytics Engagement","description":"Engagement time series (active students, conversations started, messages\nsent) bucketed by day/week/month. Defaults to the last 30 days; max range\n365 days. Cached for 1 hour. Owners and admins get the organization; a\ncounselor gets their own caseload (#661).","operationId":"get_organization_analytics_engagement_api_v1_organizations__org_id__analytics_engagement_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End"}},{"name":"granularity","in":"query","required":false,"schema":{"enum":["day","week","month"],"type":"string","default":"day","title":"Granularity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgEngagementSeries"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/analytics/counselors":{"get":{"tags":["organizations"],"summary":"Get Organization Analytics Counselors","description":"Per-counselor activity: assigned students, 30-day active assigned\nstudents, and the counselor's own last-message timestamp. Cached for 1\nhour. Admin role or above required.","operationId":"get_organization_analytics_counselors_api_v1_organizations__org_id__analytics_counselors_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgCounselorActivity"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/analytics/students":{"get":{"tags":["organizations"],"summary":"List Organization Analytics Students","description":"Per-student progress table (profile completion, colleges saved,\nconversation count, last activity). Counselors see only their assigned\nstudents; admins/owners see all. Not cached. Supports pagination, name/\nemail search, and sorting.","operationId":"list_organization_analytics_students_api_v1_organizations__org_id__analytics_students_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["name","last_active","profile_completion","colleges_saved"],"type":"string","default":"last_active","title":"Sort"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgStudentProgressList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/schools":{"post":{"tags":["organizations"],"summary":"Attach School To District Endpoint","description":"Attach an existing school org to a district. The caller must be\nowner/admin of the district AND owner/admin of the school being attached.","operationId":"attach_school_to_district_endpoint_api_v1_organizations__org_id__schools_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_AttachSchoolRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations"],"summary":"List District Schools Endpoint","description":"List child schools of a district. District owner/admin sees all;\ndistrict counselor sees only schools they individually belong to.\nPaginated; max ``limit`` 200.","operationId":"list_district_schools_endpoint_api_v1_organizations__org_id__schools_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Skip"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/schools/create":{"post":{"tags":["organizations"],"summary":"Create School Under District Endpoint","description":"Create a new school org as a direct child of a district. ``type`` and\n``parent_org_id`` are forced server-side regardless of the request body.","operationId":"create_school_under_district_endpoint_api_v1_organizations__org_id__schools_create_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDetailRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/schools/{school_id}":{"delete":{"tags":["organizations"],"summary":"Detach School From District Endpoint","description":"Detach a school from a district. The school org is preserved (not deleted).","operationId":"detach_school_from_district_endpoint_api_v1_organizations__org_id__schools__school_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}},{"name":"school_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"School Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/analytics/aggregate":{"get":{"tags":["organizations"],"summary":"Get District Analytics Aggregate","description":"District-wide analytics rolled up across all child schools. Admin role\nor above on the district required. Cached for 5 minutes; invalidated on\nattach/detach/create-under-district.","operationId":"get_district_analytics_aggregate_api_v1_organizations__org_id__analytics_aggregate_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistrictAggregateAnalytics"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/tree":{"get":{"tags":["organizations"],"summary":"Get Organization Tree","description":"The org's shape (#1069): staff with their students, the unassigned\nbranch, and child schools as summaries with counts. Owners and admins,\nincluding a district admin on a child school (#121); a suspended org 403s\nthrough the dependency. Parent email contacts appear only as\n``parent_connected``.","operationId":"get_organization_tree_api_v1_organizations__org_id__tree_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationTreeRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/invitations/{token}/accept":{"post":{"tags":["organizations"],"summary":"Accept Organization Invitation","operationId":"accept_organization_invitation_api_v1_organizations_invitations__token__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OrganizationInvitationAcceptRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInvitationAcceptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/best-colleges/{major}/{state}":{"get":{"tags":["programmatic"],"summary":"Get Best Colleges Page","description":"Return the ``/best-colleges/{major}/{state}`` payload.\n\nReturns HTTP 404 when the major slug or state slug is invalid (URL was\nnever valid). Returns HTTP 200 with ``stats.is_thin = True`` when the\nslug combo is valid but resolves to fewer than\n:data:`~app.services.programmatic.THIN_CONTENT_MIN_COLLEGES` colleges\n— the frontend suppresses indexation for those pages rather than 404.","operationId":"get_best_colleges_page_api_v1_programmatic_best_colleges__major___state__get","parameters":[{"name":"major","in":"path","required":true,"schema":{"type":"string","description":"Program slug (e.g. 'nursing')","title":"Major"},"description":"Program slug (e.g. 'nursing')"},{"name":"state","in":"path","required":true,"schema":{"type":"string","description":"Two-letter state code (e.g. 'tx')","title":"State"},"description":"Two-letter state code (e.g. 'tx')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticPage"}}}},"404":{"description":"Unknown major or state slug"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/cheapest-colleges/{major}/{state}":{"get":{"tags":["programmatic"],"summary":"Get Cheapest Colleges Page","description":"Return the ``/cheapest-colleges/{major}/{state}`` payload.\n\n404 on unknown major or state; 200 with ``stats.is_thin = True`` when\nthe combo is valid but resolves to fewer than\n:data:`~app.services.programmatic.THIN_CONTENT_MIN_COLLEGES` colleges.","operationId":"get_cheapest_colleges_page_api_v1_programmatic_cheapest_colleges__major___state__get","parameters":[{"name":"major","in":"path","required":true,"schema":{"type":"string","description":"Program slug (e.g. 'nursing')","title":"Major"},"description":"Program slug (e.g. 'nursing')"},{"name":"state","in":"path","required":true,"schema":{"type":"string","description":"Two-letter state code (e.g. 'tx')","title":"State"},"description":"Two-letter state code (e.g. 'tx')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticPage"}}}},"404":{"description":"Unknown major or state slug"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/colleges-under/{bracket}/{major}":{"get":{"tags":["programmatic"],"summary":"Get Colleges Under Page","description":"Return the ``/colleges-under/{bracket}/{major}`` payload.\n\n404 on unknown bracket or unknown major; 200 with\n``stats.is_thin = True`` when the combo is valid but resolves to\nfewer than :data:`~app.services.programmatic.THIN_CONTENT_MIN_COLLEGES`\ncolleges.","operationId":"get_colleges_under_page_api_v1_programmatic_colleges_under__bracket___major__get","parameters":[{"name":"bracket","in":"path","required":true,"schema":{"type":"string","description":"Net-price bracket slug (e.g. 'under-10k', '30k-plus')","title":"Bracket"},"description":"Net-price bracket slug (e.g. 'under-10k', '30k-plus')"},{"name":"major","in":"path","required":true,"schema":{"type":"string","description":"Program slug (e.g. 'nursing')","title":"Major"},"description":"Program slug (e.g. 'nursing')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticPage"}}}},"404":{"description":"Unknown bracket or major slug"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/athletics/{division}/{sport}/{state}":{"get":{"tags":["programmatic"],"summary":"Get Athletics Page","description":"Return the ``/athletics/{division}/{sport}/{state}`` payload.\n\n404 on any unknown slug in the triple; 200 with\n``stats.is_thin = True`` when the combo is valid but resolves to\nfewer than :data:`~app.services.programmatic.THIN_CONTENT_MIN_COLLEGES`\nathletic programs.","operationId":"get_athletics_page_api_v1_programmatic_athletics__division___sport___state__get","parameters":[{"name":"division","in":"path","required":true,"schema":{"type":"string","description":"Division slug (e.g. 'ncaa-d1', 'naia')","title":"Division"},"description":"Division slug (e.g. 'ncaa-d1', 'naia')"},{"name":"sport","in":"path","required":true,"schema":{"type":"string","description":"Sport slug (e.g. 'mens-basketball')","title":"Sport"},"description":"Sport slug (e.g. 'mens-basketball')"},{"name":"state","in":"path","required":true,"schema":{"type":"string","description":"Two-letter state code (e.g. 'oh')","title":"State"},"description":"Two-letter state code (e.g. 'oh')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticPage"}}}},"404":{"description":"Unknown division, sport, or state slug"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/enumerate":{"get":{"tags":["programmatic"],"summary":"Enumerate Urls","description":"Stream sitemap URLs for programmatic landing pages.\n\nSSR-only consumer (Next.js ``frontend/src/app/sitemap.ts``). No auth,\nno API-key gating — per ARCHITECTURE.md §\"Backend API surface\", this\nrouter carries no ``scope:`` tag. Thin URLs are excluded at the query\nlevel so the sitemap never advertises ``noindex`` pages.\n\nEach page type uses a different cursor shape:\n\n- ``best_colleges`` / ``cheapest_colleges``: ``after_slug`` +\n  ``after_state`` (2-tuple, pipe-delimited).\n- ``colleges_under``: ``after_bracket`` + ``after_slug`` (2-tuple).\n- ``athletics``: ``after_division`` + ``after_sport`` + ``after_state``\n  (3-tuple).\n\nUnknown ``page_type`` → 400. Answers only our frontend server once the\nedge secret is configured (#1019): a page can be 5,000 rows, and nothing\nelse needs the list. Dev and CI, with no secret, still answer.","operationId":"enumerate_urls_api_v1_programmatic_enumerate_get","parameters":[{"name":"page_type","in":"query","required":true,"schema":{"type":"string","description":"One of PageType.VALID_VALUES (e.g. 'best_colleges')","title":"Page Type"},"description":"One of PageType.VALID_VALUES (e.g. 'best_colleges')"},{"name":"after_slug","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: major slug half (best/cheapest/colleges_under)","default":"","title":"After Slug"},"description":"Keyset cursor: major slug half (best/cheapest/colleges_under)"},{"name":"after_state","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: state half (best/cheapest/athletics)","default":"","title":"After State"},"description":"Keyset cursor: state half (best/cheapest/athletics)"},{"name":"after_bracket","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: bracket half (colleges_under)","default":"","title":"After Bracket"},"description":"Keyset cursor: bracket half (colleges_under)"},{"name":"after_division","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: division half (athletics)","default":"","title":"After Division"},"description":"Keyset cursor: division half (athletics)"},{"name":"after_sport","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: sport slug half (athletics)","default":"","title":"After Sport"},"description":"Keyset cursor: sport slug half (athletics)"},{"name":"after_id","in":"query","required":false,"schema":{"type":"string","description":"Keyset cursor: UUID half (colleges/scholarships/programs) — the single-entity sitemap types","default":"","title":"After Id"},"description":"Keyset cursor: UUID half (colleges/scholarships/programs) — the single-entity sitemap types"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"Max URLs per page; capped at 5000","default":5000,"title":"Limit"},"description":"Max URLs per page; capped at 5000"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumerateResponse"}}}},"400":{"description":"Unknown page_type"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/athletics-sport-redirect/{sport}":{"get":{"tags":["programmatic"],"summary":"Get Athletics Sport Redirect","description":"Canonical slug for an athletics sport slug that no longer resolves (#760).\n\nThe ``/athletics/{division}/{sport}/{state}`` lander reads this and\npermanently redirects, so URLs built from spellings the rename cleanup\nretired keep their search standing. Page-layer plumbing like\n``/program-page``, not part of the developer API.","operationId":"get_athletics_sport_redirect_api_v1_programmatic_athletics_sport_redirect__sport__get","parameters":[{"name":"sport","in":"path","required":true,"schema":{"type":"string","description":"Sport slug from an athletics lander URL","title":"Sport"},"description":"Sport slug from an athletics lander URL"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SportSlugRedirect"}}}},"404":{"description":"The slug resolves as it is, or maps to no sport with programs"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/program-page/{identifier}":{"get":{"tags":["programmatic"],"summary":"Get Program Page Target","description":"Return where a program's page lives, by UUID or slug (#773).\n\nOnly 4-digit programs have pages. ``/programs/[slug]``, the ``[major]``\nlanders and the mobile shell read this and permanently redirect a 6-digit\nprogram to ``page_slug``, or to ``/programs/category/{cip_2_digit}`` when\n``page_slug`` is ``None``. Page-layer plumbing like ``/enumerate``, so it\ncarries no ``scope:`` tag and isn't part of the developer API.","operationId":"get_program_page_target_api_v1_programmatic_program_page__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","description":"Program UUID or slug","title":"Identifier"},"description":"Program UUID or slug"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramPageTarget"}}}},"404":{"description":"Unknown program"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/hubs/{hub_type}":{"get":{"tags":["programmatic"],"summary":"Get Hub Page","description":"Return a hub index payload (#202, #885).\n\nThe discovery hubs (``best-colleges``, ``cheapest-colleges``,\n``athletics``) enumerate siblings and keep click-depth ≤3 across the\nprogrammatic URL space. The browse hubs (``programs``, ``colleges-in``,\n``colleges-under``, #885) list every entity of their kind, so every\nsitemap URL is reachable by a link (ARCHITECTURE.md §\"Crawl paths\").\nContent is derived from the same data that feeds the leaf templates; no\neditorial overrides. Unknown ``hub_type`` → 404.","operationId":"get_hub_page_api_v1_programmatic_hubs__hub_type__get","parameters":[{"name":"hub_type","in":"path","required":true,"schema":{"type":"string","description":"One of HubType.VALID_VALUES (best-colleges, cheapest-colleges, athletics, programs, colleges-in, colleges-under)","title":"Hub Type"},"description":"One of HubType.VALID_VALUES (best-colleges, cheapest-colleges, athletics, programs, colleges-in, colleges-under)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HubPage"}}}},"404":{"description":"Unknown hub type"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/programmatic/state-landers/{state_code}":{"get":{"tags":["programmatic"],"summary":"Get State Landers","description":"A state's best- and cheapest-colleges landers, for its state hub (#885).\n\n``/colleges-in/[state]`` and its landers cross-link (ARCHITECTURE.md\n§\"Coexistence\"). Only sitemap-listed landers are returned.","operationId":"get_state_landers_api_v1_programmatic_state_landers__state_code__get","parameters":[{"name":"state_code","in":"path","required":true,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter state code","title":"State Code"},"description":"Two-letter state code"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HubSection"},"title":"Response Get State Landers Api V1 Programmatic State Landers  State Code  Get"}}}},"404":{"description":"Not one of the 50 states or DC"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools":{"get":{"tags":["tools"],"summary":"Get Hub","description":"Return the list of registered tools for the `/tools` hub page.","operationId":"get_hub_api_v1_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HubResponse"}}}}}}},"/api/v1/tools/{tool_id}":{"get":{"tags":["tools"],"summary":"Get Tool Entry","description":"Return metadata for a single tool. 404 on unknown slug.","operationId":"get_tool_entry_api_v1_tools__tool_id__get","parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","title":"Tool Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolEntryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/sessions":{"post":{"tags":["tools"],"summary":"Create Tool Session","description":"Mint a new anonymous (or attributed) tool session.","operationId":"create_tool_session_api_v1_tools_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSessionRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/tools/sessions/{session_id}":{"get":{"tags":["tools"],"summary":"Get Tool Session","description":"Fetch a session by ID. Falls back to a tool-leads snapshot if the\nRedis entry has expired (#208). 404 only if neither source has it.","operationId":"get_tool_session_api_v1_tools_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":{"$ref":"#/components/schemas/ToolSessionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/sessions/{session_id}/state":{"patch":{"tags":["tools"],"summary":"Patch Tool Session State","description":"Merge `step_state` (incremental) and/or replace `result` on a session.","operationId":"patch_tool_session_state_api_v1_tools_sessions__session_id__state_patch","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSessionStateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolSessionOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/sessions/{session_id}/link":{"post":{"tags":["tools"],"summary":"Link Tool Session","description":"Bind an anonymous tool session to the authenticated user.\n\nWrites a `metrics_tool_session_links` row so funnel attribution survives\nthe 30-day Redis TTL. Idempotent on same user; 409 on rebind to a\ndifferent user.\n\n#1055: the link also claims the result into the account (its colleges\nonto the saved list, its answers into EMPTY profile fields) via\n``apply_tool_session_claim``. A re-link by the same account runs the\nclaim again: fill-empty and saved-list dedupe make that a no-op unless the\nstudent has since cleared a field or removed a college.","operationId":"link_tool_session_api_v1_tools_sessions__session_id__link_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/sessions/{session_id}/capture-lead":{"post":{"tags":["tools"],"summary":"Capture Tool Lead","description":"Persist a captured lead, snapshot the session result, and send the\nimmediate transactional email (#208).\n\n- 404 when the session id is unknown / expired.\n- 422 when the session has no ``result`` to snapshot yet.\n- 5 req/hour/IP — chassis spam ceiling per spec.","operationId":"capture_tool_lead_api_v1_tools_sessions__session_id__capture_lead_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureLeadRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureLeadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/net-price/estimate":{"post":{"tags":["tools"],"summary":"Estimate Net Price","description":"Compute a net-price estimate and persist it onto the tool session.\n\nThe session must already exist (minted via ``POST /tools/sessions``) and\nbelong to the ``net-price`` tool. Raw form inputs are merged into\n``step_state``; the full result envelope replaces ``result`` so the\nresult page can render from a single Redis lookup.\n\n422 ``not_enough_data`` when the candidate pool has fewer than three\nmatching colleges even after widening nationally.","operationId":"estimate_net_price_api_v1_tools_net_price_estimate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetPriceEstimateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetPriceEstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/scholarship-match/run":{"post":{"tags":["tools"],"summary":"Run Scholarship Match","description":"Execute the scholarship match quiz and persist the result on the session.\n\nThe session must already exist (minted via ``POST /tools/sessions``) and\nbelong to the ``scholarship-match`` tool. Raw quiz answers are stored\nverbatim in ``step_state`` (overwriting any prior per-step PATCH writes);\nthe result envelope replaces ``result`` so the result page renders from\na single Redis lookup.\n\nReturns 200 with ``total_matches=0`` when the eligibility pool is empty —\nthe UI renders a supportive empty state rather than a hard error.","operationId":"run_scholarship_match_api_v1_tools_scholarship_match_run_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipMatchRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScholarshipMatchRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/admissions-chance/estimate":{"post":{"tags":["tools"],"summary":"Admissions Chance Estimate Endpoint","description":"Compute per-college admit-chance bands for a student profile (#377).\n\nThe session must already exist (minted via ``POST /tools/sessions``) and\nbelong to the ``admissions-chance`` tool. The profile is snapshotted to\n``step_state`` so the slider endpoint can replay with one dimension\noverridden; the full result envelope replaces ``result`` so the result\npage renders from a single Redis lookup.\n\nUnknown ``college_ids`` are silently filtered — the envelope's top-level\n``notes`` lists the skipped IDs so the page surfaces them.","operationId":"admissions_chance_estimate_endpoint_api_v1_tools_admissions_chance_estimate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissionsChanceEstimateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissionsChanceResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/admissions-chance/slider":{"post":{"tags":["tools"],"summary":"Admissions Chance Slider Endpoint","description":"Replay the prior estimate with one input dimension overridden (#377).\n\nReads the prior profile snapshot off ``step_state`` (populated by\n``/estimate``), swaps in the slider value, and re-runs the predictor.\n\n404 when the session is missing, belongs to another tool, or has no\nprior /estimate to replay.","operationId":"admissions_chance_slider_endpoint_api_v1_tools_admissions_chance_slider_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SliderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissionsChanceResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/admissions-chance/methodology/calibration":{"get":{"tags":["tools"],"summary":"Admissions Chance Calibration Read","description":"Return the latest calibration row for the chance-me v1 model (#377).\n\nPublic, anonymous. The methodology page at\n``/tools/admissions-chance/methodology`` reads this on every render\n(ISR cache TTL = 3600s). Cold-start (no rows in the metrics DB) returns\na 200 with default sentinel fields so the page can render a \"data is\nbeing computed\" state without conditional 404 handling.\n\nThe ``stale`` boolean is computed server-side so the page render\ndoesn't need its own clock. A 48-hour grace window covers one missed\ndaily refit fire.","operationId":"admissions_chance_calibration_read_api_v1_tools_admissions_chance_methodology_calibration_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__admissions_chance__CalibrationReadResponse"}}}}}}},"/api/v1/tools/life-path/methodology/calibration":{"get":{"tags":["tools"],"summary":"Life Path Calibration Read","description":"Return the latest calibration row for the life-path v1 model (#384).\n\nPublic, anonymous. The methodology page at\n``/tools/life-path/methodology`` reads this on every render\n(ISR cache TTL = 3600s). Cold-start (no rows in the metrics DB)\nreturns a 200 with default sentinel fields so the page can render\na \"data is being computed\" state without conditional 404 handling.\n\nThe ``stale`` boolean is computed server-side on a 48-hour grace\nwindow — same cadence as chance-me. Both models refit on the same\ndaily 06:30 UTC beat slot.","operationId":"life_path_calibration_read_api_v1_tools_life_path_methodology_calibration_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__life_path__CalibrationReadResponse"}}}}}}},"/api/v1/tools/life-path/estimate":{"post":{"tags":["tools"],"summary":"Life Path Estimate Endpoint","description":"Compute the 10-year trajectory bands for a student profile (#384).\n\nThe session must already exist (minted via ``POST /tools/sessions``) and\nbelong to the ``life-path`` tool. Each college's programs are fuzzy-\nmatched against the visitor's ``intended_major``; unmatched colleges\nfall back to the college-wide 10-year-out earnings figure with a\ndocumented 0.7× scale-down and a per-prediction note.\n\nUnknown ``college_ids`` are silently filtered — the envelope's\ntop-level ``notes`` lists the skipped IDs so the page surfaces them.","operationId":"life_path_estimate_endpoint_api_v1_tools_life_path_estimate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifePathEstimateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifePathResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tools/life-path/levers":{"post":{"tags":["tools"],"summary":"Life Path Levers Endpoint","description":"Replay the prior estimate with lever overrides applied (#384).\n\nReads the prior profile snapshot off ``step_state`` (populated by\n``/estimate``), refetches the colleges + programs from the DB, and\nre-runs ``predict_many`` with ``extra_scholarship_per_year`` and\n``in_state_overrides`` applied as kwargs.\n\n404 when the session is missing, belongs to another tool, or has\nno prior /estimate to replay.","operationId":"life_path_levers_endpoint_api_v1_tools_life_path_levers_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Tool-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Tool-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeverRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifePathResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/feature-flags/all":{"get":{"tags":["feature-flags"],"summary":"Get All Feature Flags","description":"Evaluate every known flag for the caller.","operationId":"get_all_feature_flags_api_v1_feature_flags_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllFeatureFlagsResult"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/feature-flags/{key}":{"post":{"tags":["feature-flags"],"summary":"Evaluate Feature Flag","description":"Evaluate a single flag for the caller (optionally context-scoped).","operationId":"evaluate_feature_flag_api_v1_feature_flags__key__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FeatureFlagContext"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mission-control":{"get":{"tags":["mission-control"],"summary":"Get Mission Control Board","description":"Return the ranked, grouped board for the active profile.\n\nThe board is re-skinned per the viewer's relationship (#498): a ``parent``\ngrant sees the redacted ``persona_scope=\"parent\"`` Family Briefing board\n(``ParentBoardItemOut`` allowlist projection, never the student's raw\nitems); every other grant (owner / counselor / shared) sees the\n``student`` board via ``AgentItemOut`` — unchanged from before.","operationId":"get_mission_control_board_api_v1_mission_control_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mission-control/items/{item_id}/resolve":{"post":{"tags":["mission-control"],"summary":"Resolve Mission Control Item","description":"Record the user's chosen option; execute its action if one is attached.\n\nAuthorization is item-aware (ARCHITECTURE §\"Cross-persona boards\"): the\nboard service checks the caller's grant role against the item's persona and\naction class. A student-scoped item is owner-only; a parent may resolve a\nparent card but not trigger an executor action. When the chosen option\ncarries an ``action_spec``, the executor performs the (reversible) mutation\nand an ``audit_logs`` row is written.","operationId":"resolve_mission_control_item_api_v1_mission_control_items__item_id__resolve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentItemResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mission-control/items/{item_id}/dismiss":{"post":{"tags":["mission-control"],"summary":"Dismiss Mission Control Item","description":"Dismiss an item; the producing agent will not resurface it.\n\nItem-aware authorization (as ``resolve``): a caller may dismiss only items\nof their own persona.","operationId":"dismiss_mission_control_item_api_v1_mission_control_items__item_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}},{"name":"x-profile-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view).","title":"X-Profile-Id"},"description":"UUID of the profile to act on. Optional — if omitted, the user's primary profile is used. Honors invited parent/counselor/shared grants (can_view)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/devices/register":{"post":{"tags":["devices"],"summary":"Register Device","description":"Register (or refresh) a push device token — idempotent upsert.\n\nRe-registering an existing (user, platform, token) triple reactivates the\nrow and bumps ``last_seen_at`` instead of creating a duplicate. One retry\non IntegrityError covers the SELECT-then-INSERT race when the app fires\nregister twice on launch (same posture as organization_invitation).","operationId":"register_device_api_v1_devices_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceTokenOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/devices":{"get":{"tags":["devices"],"summary":"List Devices","description":"List the caller's registered devices (newest first).","operationId":"list_devices_api_v1_devices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DeviceTokenOut"},"type":"array","title":"Response List Devices Api V1 Devices Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/devices/notification-preferences":{"get":{"tags":["devices"],"summary":"Get Notification Preferences","description":"Current per-category push opt-outs (missing key = opted in).","operationId":"get_notification_preferences_api_v1_devices_notification_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferences"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["devices"],"summary":"Update Notification Preferences","description":"Replace the per-category push opt-outs.","operationId":"update_notification_preferences_api_v1_devices_notification_preferences_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferences"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferences"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/devices/{device_id}":{"delete":{"tags":["devices"],"summary":"Revoke Device","description":"Revoke (delete) one of the caller's own devices. 404 on anyone else's.","operationId":"revoke_device_api_v1_devices__device_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"device_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Device Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/journey/roadmap":{"get":{"tags":["journey"],"summary":"Get Roadmap","operationId":"get_roadmap_api_v1_journey_roadmap_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoadmapOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/journey/milestones/{key}":{"put":{"tags":["journey"],"summary":"Update Milestone","operationId":"update_milestone_api_v1_journey_milestones__key__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilestoneUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoadmapOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/journey/preview":{"post":{"tags":["journey"],"summary":"Preview Roadmap","operationId":"preview_roadmap_api_v1_journey_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoadmapPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoadmapPreviewOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/money/could-it-be-zero":{"post":{"tags":["money"],"summary":"Could It Be Zero","description":"Public and stateless: computes the answer, saves nothing, logs no input values.","operationId":"could_it_be_zero_api_v1_money_could_it_be_zero_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyInputs"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/money/family-inputs":{"get":{"tags":["money"],"summary":"Get Family Inputs","operationId":"get_family_inputs_api_v1_money_family_inputs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MoneyInputs"},{"type":"null"}],"title":"Response Get Family Inputs Api V1 Money Family Inputs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["money"],"summary":"Put Family Inputs","operationId":"put_family_inputs_api_v1_money_family_inputs_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyInputs"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyInputs"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/money/home":{"get":{"tags":["money"],"summary":"Get Money Home","description":"The parent's money home: their own answers and the answer derived from\nthem, then the sections for the child's stage.","operationId":"get_money_home_api_v1_money_home_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyHomeOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts":{"get":{"tags":["parent-contacts"],"summary":"List Parent Contacts","operationId":"list_parent_contacts_api_v1_parent_contacts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ParentContactOut"},"title":"Response List Parent Contacts Api V1 Parent Contacts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["parent-contacts"],"summary":"Add Parent Contact","operationId":"add_parent_contact_api_v1_parent_contacts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentContactCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentContactOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/{contact_id}":{"patch":{"tags":["parent-contacts"],"summary":"Update Parent Contact","operationId":"update_parent_contact_api_v1_parent_contacts__contact_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Contact Id"}},{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentContactUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentContactOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["parent-contacts"],"summary":"Remove Parent Contact","operationId":"remove_parent_contact_api_v1_parent_contacts__contact_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Contact Id"}},{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/{contact_id}/resend":{"post":{"tags":["parent-contacts"],"summary":"Resend Parent Confirmation","operationId":"resend_parent_confirmation_api_v1_parent_contacts__contact_id__resend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Contact Id"}},{"name":"profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentContactOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/confirm/info":{"get":{"tags":["parent-contacts"],"summary":"Confirm Info","description":"What the confirm page shows. Read-only: opening the link confirms nothing.","operationId":"confirm_info_api_v1_parent_contacts_confirm_info_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmInfoOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/confirm":{"post":{"tags":["parent-contacts"],"summary":"Confirm Parent Contact","operationId":"confirm_parent_contact_api_v1_parent_contacts_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResultOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/unsubscribe":{"post":{"tags":["parent-contacts"],"summary":"Unsubscribe Parent Contact","description":"The unsubscribe page's button. An already-unsubscribed link still answers ok.","operationId":"unsubscribe_parent_contact_api_v1_parent_contacts_unsubscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResultOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/parent-contacts/unsubscribe/one-click":{"post":{"tags":["parent-contacts"],"summary":"Unsubscribe One Click","description":"RFC 8058: a mail client POSTs ``List-Unsubscribe=One-Click`` here.\n\nThe form body carries nothing we need, so it isn't read. Always 200: the\nclient has no one to show an error to.","operationId":"unsubscribe_one_click_api_v1_parent_contacts_unsubscribe_one_click_post","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","default":"","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/email/announcements/unsubscribe":{"post":{"tags":["email-preferences"],"summary":"Unsubscribe Announcements","description":"The unsubscribe page's button. An already-opted-out link still answers ok.","operationId":"unsubscribe_announcements_api_v1_email_announcements_unsubscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsubscribeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsubscribeOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/email/announcements/unsubscribe/one-click":{"post":{"tags":["email-preferences"],"summary":"Unsubscribe Announcements One Click","description":"RFC 8058: a mail client POSTs ``List-Unsubscribe=One-Click`` here.\n\nAlways 200: the client has no one to show an error to.","operationId":"unsubscribe_announcements_one_click_api_v1_email_announcements_unsubscribe_one_click_post","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","default":"","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/users/me/email-preferences":{"get":{"tags":["email-preferences"],"summary":"Get Email Preferences","operationId":"get_email_preferences_api_v1_users_me_email_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPreferences"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["email-preferences"],"summary":"Update Email Preferences","operationId":"update_email_preferences_api_v1_users_me_email_preferences_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPreferences"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPreferences"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/provenance/verify":{"post":{"tags":["provenance"],"summary":"Verify","operationId":"verify_api_v1_provenance_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/provenance/detect":{"post":{"tags":["provenance"],"summary":"Detect","operationId":"detect_api_v1_provenance_detect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/webhooks/inbound-email":{"post":{"tags":["inbound-email"],"summary":"Receive Inbound Email","description":"Receive an inbound email from Mailjet Parse (Basic Auth flavor).","operationId":"receive_inbound_email_api_webhooks_inbound_email_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundEmailWebhookResponse"}}}}}}},"/api/webhooks/inbound-email/{token}":{"post":{"tags":["inbound-email"],"summary":"Receive Inbound Email Path Token","description":"Receive an inbound email from Mailjet Parse (path-token flavor).","operationId":"receive_inbound_email_path_token_api_webhooks_inbound_email__token__post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundEmailWebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/webhooks/mailjet-events":{"post":{"tags":["inbound-email"],"summary":"Receive Mailjet Events","description":"Mailjet event callback (Basic Auth flavor).","operationId":"receive_mailjet_events_api_webhooks_mailjet_events_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/webhooks/mailjet-events/{token}":{"post":{"tags":["inbound-email"],"summary":"Receive Mailjet Events Path Token","description":"Mailjet event callback (path-token flavor).","operationId":"receive_mailjet_events_path_token_api_webhooks_mailjet_events__token__post","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"}}}}}}},"/api/locations/zip/{zip_code}":{"get":{"tags":["locations"],"summary":"Lookup Zip Code","description":"Resolve a US zip code to city, county, and state.\n\nThis endpoint is useful for auto-filling user location when they enter their zip code.\n\nArgs:\n    zip_code: 5-digit US zip code\n\nReturns:\n    Location information including city, county, and state\n\nExample:\n    GET /api/locations/zip/01103\n    Returns: {\"city\": \"Springfield\", \"county\": \"Hampden\", \"state\": \"Massachusetts\", \"state_code\": \"MA\"}","operationId":"lookup_zip_code_api_locations_zip__zip_code__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"zip_code","in":"path","required":true,"schema":{"type":"string","description":"5-digit US zip code","title":"Zip Code"},"description":"5-digit US zip code"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:locations"]}},"/api/locations/city":{"get":{"tags":["locations"],"summary":"Lookup City","description":"Resolve a city name to county and state.\n\nThis endpoint is useful when a user selects a city from autocomplete,\nand you need to auto-fill the county field.\n\nArgs:\n    city: City name (e.g., \"Springfield\", \"Los Angeles\")\n    state: Optional state code or name to narrow results\n\nReturns:\n    Location information including county and state\n\nExample:\n    GET /api/locations/city?city=Springfield&state=MA\n    Returns: {\"city\": \"Springfield\", \"county\": \"Hampden\", \"state\": \"Massachusetts\", \"state_code\": \"MA\"}","operationId":"lookup_city_api_locations_city_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"city","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"City name","title":"City"},"description":"City name"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"State code (e.g., 'CA', 'MA') or name","title":"State"},"description":"State code (e.g., 'CA', 'MA') or name"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:locations"]}},"/api/locations/search":{"get":{"tags":["locations"],"summary":"Search Cities Endpoint","description":"Search for cities matching a query string (autocomplete).\n\nThis endpoint is useful for implementing city autocomplete in forms.\nUsers start typing a city name, and this returns matching cities.\n\nArgs:\n    query: Search query (partial or complete city name)\n    state: Optional state code to narrow results\n    limit: Maximum number of results (1-50)\n\nReturns:\n    List of matching cities with their location information\n\nExample:\n    GET /api/locations/search?query=Spring&state=MA\n    Returns: {\"results\": [{\"city\": \"Springfield\", \"county\": \"Hampden\", \"state\": \"Massachusetts\", \"state_code\": \"MA\"}]}\n\nNote:\n    This is a simple implementation. For production with many users, consider:\n    - Implementing a local city database\n    - Adding response caching\n    - Rate limiting to prevent abuse","operationId":"search_cities_endpoint_api_locations_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query (partial city name)","title":"Query"},"description":"Search query (partial city name)"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"State code to filter results","title":"State"},"description":"State code to filter results"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum number of results","default":10,"title":"Limit"},"description":"Maximum number of results"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:locations"]}},"/api/locations/health":{"get":{"tags":["locations"],"summary":"Health Check","description":"Health check endpoint for location services.\n\nReturns basic service status.","operationId":"health_check_api_locations_health_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationsHealthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-required-scope":["read:locations"]}},"/.well-known/content-provenance.json":{"get":{"tags":["provenance"],"summary":"Well Known Keys","operationId":"well_known_keys__well_known_content_provenance_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Well Known Keys  Well Known Content Provenance Json Get"}}}}}}},"/health":{"get":{"summary":"Health Check","description":"Health check endpoint for Render and monitoring systems.","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/health":{"get":{"summary":"Health","description":"Legacy health endpoint for backward compatibility.","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}}},"components":{"schemas":{"AccountTypeUpdate":{"properties":{"account_type":{"anyOf":[{"type":"string","enum":["student","parent","counselor"]},{"type":"null"}],"title":"Account Type"}},"type":"object","required":["account_type"],"title":"AccountTypeUpdate","description":"The settings control (#870): sets or clears the persona outright."},"ActiveTaskEntry":{"properties":{"task_name":{"type":"string","title":"Task Name"},"task_id":{"type":"string","title":"Task Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"run_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Kind"},"kwargs":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kwargs"},"age_seconds":{"type":"integer","title":"Age Seconds"},"is_stuck":{"type":"boolean","title":"Is Stuck"},"liveness":{"type":"string","title":"Liveness","default":"unknown"}},"type":"object","required":["task_name","task_id","started_at","age_seconds","is_stuck"],"title":"ActiveTaskEntry","description":"A celery task with an `in_progress` audit row and no terminal pair yet."},"ActiveTasksResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/ActiveTaskEntry"},"type":"array","title":"Entries"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["entries","meta"],"title":"ActiveTasksResponse"},"ActivityCollege":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"name":{"type":"string","title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"status":{"type":"string","title":"Status"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"tier":{"type":"string","title":"Tier"},"net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Price"},"added_recently":{"type":"boolean","title":"Added Recently"}},"additionalProperties":false,"type":"object","required":["college_id","name","slug","status","ranking","tier","net_price","added_recently"],"title":"ActivityCollege"},"ActivityCollegeRef":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"name":{"type":"string","title":"Name"}},"additionalProperties":false,"type":"object","required":["college_id","name"],"title":"ActivityCollegeRef"},"ActivityConversations":{"properties":{"count":{"type":"integer","title":"Count"},"first_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First At"},"last_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last At"},"colleges_discussed":{"items":{"$ref":"#/components/schemas/ActivityCollegeRef"},"type":"array","title":"Colleges Discussed"},"topics":{"items":{"$ref":"#/components/schemas/ActivityTopic"},"type":"array","title":"Topics"}},"additionalProperties":false,"type":"object","required":["count","first_at","last_at","colleges_discussed","topics"],"title":"ActivityConversations"},"ActivityDeadline":{"properties":{"label":{"type":"string","title":"Label"},"kind":{"type":"string","enum":["college","scholarship"],"title":"Kind"},"due":{"type":"string","format":"date","title":"Due"},"days":{"type":"integer","title":"Days"},"overdue":{"type":"boolean","title":"Overdue"}},"additionalProperties":false,"type":"object","required":["label","kind","due","days","overdue"],"title":"ActivityDeadline"},"ActivityEngagement":{"properties":{"active_days_7":{"type":"integer","title":"Active Days 7"},"active_days_30":{"type":"integer","title":"Active Days 30"},"weekly":{"items":{"type":"integer"},"type":"array","title":"Weekly"},"areas":{"items":{"type":"string"},"type":"array","title":"Areas"}},"additionalProperties":false,"type":"object","required":["active_days_7","active_days_30","weekly","areas"],"title":"ActivityEngagement"},"ActivityEvent":{"properties":{"college_name":{"type":"string","title":"College Name"},"title":{"type":"string","title":"Title"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"state":{"type":"string","title":"State"}},"additionalProperties":false,"type":"object","required":["college_name","title","starts_at","state"],"title":"ActivityEvent"},"ActivityMilestones":{"properties":{"stage":{"type":"string","title":"Stage"},"done":{"type":"integer","title":"Done"},"total":{"type":"integer","title":"Total"},"next_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Step"},"steps":{"items":{"$ref":"#/components/schemas/ActivityStep"},"type":"array","title":"Steps"}},"additionalProperties":false,"type":"object","required":["stage","done","total","next_step","steps"],"title":"ActivityMilestones"},"ActivityReadiness":{"properties":{"overall_percentage":{"type":"number","title":"Overall Percentage"},"required_complete":{"type":"boolean","title":"Required Complete"},"sections":{"items":{"$ref":"#/components/schemas/ActivityReadinessSection"},"type":"array","title":"Sections"}},"additionalProperties":false,"type":"object","required":["overall_percentage","required_complete","sections"],"title":"ActivityReadiness"},"ActivityReadinessSection":{"properties":{"name":{"type":"string","title":"Name"},"percentage":{"type":"number","title":"Percentage"},"missing_required":{"items":{"type":"string"},"type":"array","title":"Missing Required"}},"additionalProperties":false,"type":"object","required":["name","percentage","missing_required"],"title":"ActivityReadinessSection"},"ActivityScholarship":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Deadline"}},"additionalProperties":false,"type":"object","required":["scholarship_id","name","status","deadline"],"title":"ActivityScholarship"},"ActivityStep":{"properties":{"key":{"type":"string","title":"Key"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"state":{"type":"string","title":"State"},"due":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Due"}},"additionalProperties":false,"type":"object","required":["key","title","status","state","due"],"title":"ActivityStep"},"ActivityTopic":{"properties":{"topic":{"type":"string","enum":["finding_colleges","majors_careers","applications","essays","testing","financial_aid","scholarships","deadlines","visits_events","athletics","campus_life"],"title":"Topic"},"conversations":{"type":"integer","title":"Conversations"}},"additionalProperties":false,"type":"object","required":["topic","conversations"],"title":"ActivityTopic"},"AdminApiKeySummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"rate_limit_tier":{"type":"string","title":"Rate Limit Tier"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["id","name","prefix","scopes","rate_limit_tier","is_active","created_at"],"title":"AdminApiKeySummary"},"AdminApiUserDetailResponse":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"deactivated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deactivated At"},"app_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"keys":{"items":{"$ref":"#/components/schemas/AdminApiKeySummary"},"type":"array","title":"Keys"},"usage_summary":{"$ref":"#/components/schemas/AdminUserUsageSummary"}},"type":"object","required":["user_id","email","role","is_active","keys","usage_summary"],"title":"AdminApiUserDetailResponse"},"AdminApiUserListItem":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"app_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Name"},"key_count":{"type":"integer","title":"Key Count","default":0},"active_key_count":{"type":"integer","title":"Active Key Count","default":0},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"},"top_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Tier"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["user_id","email","role","is_active"],"title":"AdminApiUserListItem"},"AdminApiUserListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminApiUserListItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminApiUserListResponse"},"AdminApiUserUpdateRequest":{"properties":{"status":{"anyOf":[{"type":"string","enum":["active","suspended"]},{"type":"null"}],"title":"Status"},"admin_notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Admin Notes"}},"type":"object","title":"AdminApiUserUpdateRequest","description":"Update developer status and/or attach an admin note.\n\nAt least one of ``status`` / ``admin_notes`` must be provided."},"AdminAuditLogEntry":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"actor_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor User Id"},"actor_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Email"},"action_type":{"type":"string","title":"Action Type"},"target_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target User Id"},"target_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Key Id"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","timestamp","action_type","status"],"title":"AdminAuditLogEntry"},"AdminAuditLogResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminAuditLogEntry"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminAuditLogResponse"},"AdminCrossOrgMemberItem":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"},"last_login_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Login At"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"organization_name":{"type":"string","title":"Organization Name"},"organization_slug":{"type":"string","title":"Organization Slug"},"organization_type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Organization Type"}},"type":"object","required":["user_id","email","role","joined_at","organization_id","organization_name","organization_slug","organization_type"],"title":"AdminCrossOrgMemberItem","description":"One row in the cross-organization members listing (#130).\n\nCarries both the user *and* the organization context, since the same\nuser may show up in multiple rows (one per membership)."},"AdminCrossOrgMemberListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminCrossOrgMemberItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminCrossOrgMemberListResponse"},"AdminFeatureFlagCreate":{"properties":{"key":{"type":"string","maxLength":100,"minLength":1,"title":"Key","description":"Unique flag key"},"enabled":{"type":"boolean","title":"Enabled","default":false},"rollout_percentage":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Rollout Percentage","default":0},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"}},"type":"object","required":["key"],"title":"AdminFeatureFlagCreate"},"AdminFeatureFlagResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"key":{"type":"string","title":"Key"},"enabled":{"type":"boolean","title":"Enabled"},"rollout_percentage":{"type":"integer","title":"Rollout Percentage"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","key","enabled","rollout_percentage","description","created_at","updated_at"],"title":"AdminFeatureFlagResponse"},"AdminFeatureFlagUpdate":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"rollout_percentage":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Rollout Percentage"},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description"}},"type":"object","title":"AdminFeatureFlagUpdate","description":"PATCH-style — every field optional."},"AdminFeatureFlagsListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminFeatureFlagResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminFeatureFlagsListResponse"},"AdminMessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"AdminMessageResponse","description":"Simple message response for admin actions."},"AdminOrgAddMemberRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"}},"type":"object","required":["user_id","role"],"title":"AdminOrgAddMemberRequest"},"AdminOrgAuditLogEntry":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"admin_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Admin User Id"},"admin_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Email"},"action_type":{"type":"string","title":"Action Type"},"action_description":{"type":"string","title":"Action Description"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"extra_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Data"}},"type":"object","required":["id","timestamp","action_type","action_description"],"title":"AdminOrgAuditLogEntry","description":"One row from the org-management audit log.\n\nConstructed via kwargs from ``audit_row_to_entry`` (not ``model_validate``)\nbecause the ``organization_id`` resolution requires custom logic over both\n``resource_id`` and ``extra_data``. No ``from_attributes`` config needed."},"AdminOrgAuditLogResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminOrgAuditLogEntry"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminOrgAuditLogResponse","description":"Paginated org-management audit-log response —\n`GET /admin/organizations/audit-log`."},"AdminOrgBulkOpFailure":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"error":{"type":"string","title":"Error"}},"type":"object","required":["user_id","error"],"title":"AdminOrgBulkOpFailure"},"AdminOrgBulkOpResult":{"properties":{"succeeded":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Succeeded"},"failed":{"items":{"$ref":"#/components/schemas/AdminOrgBulkOpFailure"},"type":"array","title":"Failed"}},"type":"object","required":["succeeded","failed"],"title":"AdminOrgBulkOpResult","description":"Aggregated result of a bulk member operation.\n\n``succeeded`` is the list of user_ids that completed without error;\n``failed`` carries one entry per row that the underlying single-member\nhelper rejected (e.g. last-owner guard, missing membership). Used for\nboth bulk-remove and bulk-role-change."},"AdminOrgBulkRemoveRequest":{"properties":{"user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":500,"minItems":1,"title":"User Ids"},"reassign_to":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Reassign To","description":"Member who inherits the removed members' assigned students."}},"type":"object","required":["user_ids"],"title":"AdminOrgBulkRemoveRequest","description":"Bulk-remove a set of users from a single organization.\n\nEach user is removed and audited individually so per-user provenance is\npreserved (architecture rule: no synthetic 'bulk' action_type). The\nlast-owner guard is enforced per row, so a request that would remove the\nlast owner reports that row as failed and proceeds with the rest.\n\n``reassign_to`` names the member who inherits every removed member's\nassigned students (#662). A row whose member holds a caseload is refused\n(409, reported per row) when it is absent; the whole request is refused\n(422) when it names a member on the removal list or a non-member."},"AdminOrgBulkRoleChangeRequest":{"properties":{"user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":500,"minItems":1,"title":"User Ids"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"}},"type":"object","required":["user_ids","role"],"title":"AdminOrgBulkRoleChangeRequest","description":"Bulk-change the role of a set of members in a single organization."},"AdminOrgCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"owner_user_id":{"type":"string","format":"uuid","title":"Owner User Id"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"}},"type":"object","required":["name","type","owner_user_id"],"title":"AdminOrgCreateRequest"},"AdminOrgDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"admin_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Notes"},"pricing_tier":{"type":"string","enum":["nonprofit","school","standard","enterprise"],"title":"Pricing Tier","default":"standard"},"pricing_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Notes"},"owner":{"anyOf":[{"$ref":"#/components/schemas/AdminOrgOwnerSummary"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count","default":0},"student_count":{"type":"integer","title":"Student Count","default":0},"members":{"items":{"$ref":"#/components/schemas/AdminOrgMemberSummary"},"type":"array","title":"Members","default":[]},"analytics_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Analytics Summary"},"dpa_signed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Dpa Signed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","slug","type","status","created_at","updated_at"],"title":"AdminOrgDetailResponse"},"AdminOrgDpaRequest":{"properties":{"signed":{"type":"boolean","title":"Signed"}},"type":"object","required":["signed"],"title":"AdminOrgDpaRequest","description":"Record (or clear) the signed data-privacy agreement (#898)."},"AdminOrgGrowthPoint":{"properties":{"period_start":{"type":"string","format":"date","title":"Period Start"},"new_orgs":{"type":"integer","title":"New Orgs"},"cumulative":{"type":"integer","title":"Cumulative"}},"type":"object","required":["period_start","new_orgs","cumulative"],"title":"AdminOrgGrowthPoint"},"AdminOrgGrowthSeries":{"properties":{"granularity":{"type":"string","enum":["day","week","month"],"title":"Granularity"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"type_filter":{"anyOf":[{"type":"string","enum":["school","district","counseling_practice","community_organization"]},{"type":"null"}],"title":"Type Filter"},"points":{"items":{"$ref":"#/components/schemas/AdminOrgGrowthPoint"},"type":"array","title":"Points"}},"type":"object","required":["granularity","start","end","points"],"title":"AdminOrgGrowthSeries","description":"Time-series of organization creation — `GET /admin/organizations/stats/growth`."},"AdminOrgListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"owner":{"anyOf":[{"$ref":"#/components/schemas/AdminOrgOwnerSummary"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count","default":0},"student_count":{"type":"integer","title":"Student Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","slug","type","status","created_at","updated_at"],"title":"AdminOrgListItem"},"AdminOrgListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminOrgListItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminOrgListResponse"},"AdminOrgMemberListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminOrgMemberSummary"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminOrgMemberListResponse"},"AdminOrgMemberRoleRequest":{"properties":{"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"}},"type":"object","required":["role"],"title":"AdminOrgMemberRoleRequest"},"AdminOrgMemberSummary":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"}},"type":"object","required":["user_id","email","role","joined_at"],"title":"AdminOrgMemberSummary"},"AdminOrgOwnerSummary":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"}},"type":"object","required":["user_id","email"],"title":"AdminOrgOwnerSummary"},"AdminOrgPlatformStats":{"properties":{"total_organizations":{"type":"integer","title":"Total Organizations"},"by_status":{"$ref":"#/components/schemas/AdminOrgStatusBreakdown"},"total_members":{"type":"integer","title":"Total Members"},"total_students":{"type":"integer","title":"Total Students"},"avg_members_per_org":{"type":"number","title":"Avg Members Per Org"},"avg_students_per_org":{"type":"number","title":"Avg Students Per Org"},"new_orgs_this_month":{"type":"integer","title":"New Orgs This Month"},"new_orgs_last_month":{"type":"integer","title":"New Orgs Last Month"},"growth_rate_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Rate Pct"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["total_organizations","by_status","total_members","total_students","avg_members_per_org","avg_students_per_org","new_orgs_this_month","new_orgs_last_month","growth_rate_pct","generated_at"],"title":"AdminOrgPlatformStats","description":"Platform-wide organization counts and growth — `GET /admin/organizations/stats`.\n\n``growth_rate_pct`` is ``None`` when the previous month had no organizations\n(e.g. first month of operation, or test fixtures). Frontends should render\nthat as \"—\" rather than \"0%\", which would conflate \"no growth\" with\n\"undefined growth\"."},"AdminOrgStatusBreakdown":{"properties":{"active":{"type":"integer","title":"Active","default":0},"suspended":{"type":"integer","title":"Suspended","default":0},"pending":{"type":"integer","title":"Pending","default":0}},"type":"object","title":"AdminOrgStatusBreakdown"},"AdminOrgStatusRequest":{"properties":{"status":{"type":"string","enum":["active","suspended"],"title":"Status"},"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason"}},"type":"object","required":["status","reason"],"title":"AdminOrgStatusRequest"},"AdminOrgStudentListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminOrgStudentSummary"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"AdminOrgStudentListResponse"},"AdminOrgStudentSummary":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"assigned_counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Counselor Name"},"added_at":{"type":"string","format":"date-time","title":"Added At"},"colleges_saved":{"type":"integer","title":"Colleges Saved","default":0},"conversation_count":{"type":"integer","title":"Conversation Count","default":0},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"}},"type":"object","required":["student_user_id","email","added_at"],"title":"AdminOrgStudentSummary","description":"One roster row in the admin students listing.\n\n**This projection is an allowlist and is deliberately narrow.** The rows\ndescribe minors (the product's audience is 15-18), so the operator-facing\nview carries identity, the counselor assignment, and *whether* a student is\nactive -- never *what* they did. Profile content (GPA, test scores, saved\ncollege identities, conversation text) is intentionally absent: an operator\nanswering \"is this organization actually using the product?\" needs volume\nand recency, not the student's college list.\n\nWidening this is a privacy decision, not a convenience one. The field set is\npinned by a test so it cannot drift open by accident, and SECURITY.md section\n2 carries the corresponding trust-boundary row."},"AdminOrgTopItem":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"student_count":{"type":"integer","title":"Student Count"},"member_count":{"type":"integer","title":"Member Count"},"active_students_30d":{"type":"integer","title":"Active Students 30D"},"last_activity_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Activity At"}},"type":"object","required":["organization_id","name","slug","type","status","student_count","member_count","active_students_30d"],"title":"AdminOrgTopItem"},"AdminOrgTopList":{"properties":{"metric":{"type":"string","enum":["students","members","engagement","last_active"],"title":"Metric"},"limit":{"type":"integer","title":"Limit"},"items":{"items":{"$ref":"#/components/schemas/AdminOrgTopItem"},"type":"array","title":"Items"}},"type":"object","required":["metric","limit","items"],"title":"AdminOrgTopList","description":"Top N organizations ranked by a metric — `GET /admin/organizations/stats/top`."},"AdminOrgTransferRequest":{"properties":{"new_owner_user_id":{"type":"string","format":"uuid","title":"New Owner User Id"}},"type":"object","required":["new_owner_user_id"],"title":"AdminOrgTransferRequest"},"AdminOrgTypeDistribution":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/AdminOrgTypeRow"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"AdminOrgTypeDistribution","description":"Distribution of organizations by type — `GET /admin/organizations/stats/types`."},"AdminOrgTypeRow":{"properties":{"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"count":{"type":"integer","title":"Count"},"percentage":{"type":"number","title":"Percentage"},"active_count":{"type":"integer","title":"Active Count"}},"type":"object","required":["type","count","percentage","active_count"],"title":"AdminOrgTypeRow"},"AdminOrgUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"type":{"anyOf":[{"type":"string","enum":["school","district","counseling_practice","community_organization"]},{"type":"null"}],"title":"Type"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"admin_notes":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Admin Notes"},"pricing_tier":{"anyOf":[{"type":"string","enum":["nonprofit","school","standard","enterprise"]},{"type":"null"}],"title":"Pricing Tier"},"pricing_notes":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Pricing Notes"}},"type":"object","title":"AdminOrgUpdateRequest"},"AdminStatsResponse":{"properties":{"total_developers":{"type":"integer","title":"Total Developers"},"active_developers":{"type":"integer","title":"Active Developers"},"suspended_developers":{"type":"integer","title":"Suspended Developers"},"total_active_keys":{"type":"integer","title":"Total Active Keys"},"tier_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Tier Distribution"},"requests_today":{"type":"integer","title":"Requests Today","default":0},"top_consumers":{"items":{"$ref":"#/components/schemas/AdminTopConsumerItem"},"type":"array","title":"Top Consumers"}},"type":"object","required":["total_developers","active_developers","suspended_developers","total_active_keys"],"title":"AdminStatsResponse"},"AdminTopConsumerItem":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"email":{"type":"string","title":"Email"},"requests":{"type":"integer","title":"Requests","default":0}},"type":"object","required":["user_id","email"],"title":"AdminTopConsumerItem"},"AdminTopConsumersResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AdminTopConsumerItem"},"type":"array","title":"Items"}},"type":"object","title":"AdminTopConsumersResponse"},"AdminUsageTimeSeriesPoint":{"properties":{"bucket":{"type":"string","format":"date-time","title":"Bucket"},"requests":{"type":"integer","title":"Requests"}},"type":"object","required":["bucket","requests"],"title":"AdminUsageTimeSeriesPoint"},"AdminUsageTimeSeriesResponse":{"properties":{"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"},"rate_limit_tiers":{"items":{"type":"string"},"type":"array","title":"Rate Limit Tiers"},"points":{"items":{"$ref":"#/components/schemas/AdminUsageTimeSeriesPoint"},"type":"array","title":"Points"}},"type":"object","title":"AdminUsageTimeSeriesResponse"},"AdminUserSession":{"properties":{"started_at":{"type":"string","format":"date-time","title":"Started At"},"last_activity_at":{"type":"string","format":"date-time","title":"Last Activity At"},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"page_count":{"type":"integer","title":"Page Count","default":0},"event_count":{"type":"integer","title":"Event Count","default":0},"entry_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Page"},"exit_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exit Page"}},"type":"object","required":["started_at","last_activity_at"],"title":"AdminUserSession","description":"One browsing session in a user's history (#855).\n\nAn explicit allowlist of ``user_sessions`` columns: no ``session_id``,\n``anonymous_id`` or ``referrer``. ``ended_at``/``duration_seconds`` are\nnull while a session has no ``session_ended`` event (in progress, or the\ntab closed without one)."},"AdminUserSessionsResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"retention_days":{"type":"integer","title":"Retention Days"},"sessions":{"items":{"$ref":"#/components/schemas/AdminUserSession"},"type":"array","title":"Sessions"}},"type":"object","required":["user_id","email","total","skip","limit","retention_days","sessions"],"title":"AdminUserSessionsResponse","description":"A page of one user's sessions, newest first (#855)."},"AdminUserUsageSummary":{"properties":{"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"},"total_keys":{"type":"integer","title":"Total Keys","default":0},"active_keys":{"type":"integer","title":"Active Keys","default":0},"tier_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Tier Distribution"},"requests_today":{"type":"integer","title":"Requests Today","default":0},"requests_30d":{"type":"integer","title":"Requests 30D","default":0}},"type":"object","title":"AdminUserUsageSummary","description":"Per-user usage summary including real metered request counts."},"AdmissionsChanceEstimateRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"profile":{"$ref":"#/components/schemas/AdmissionsChanceInput"}},"additionalProperties":false,"type":"object","required":["session_id","profile"],"title":"AdmissionsChanceEstimateRequest","description":"Body for ``POST /api/v1/tools/admissions-chance/estimate``.\n\nPairs a pre-minted ``session_id`` with the form profile. The session\nmust already exist (minted via ``POST /tools/sessions``) and belong\nto the ``admissions-chance`` tool — matches the net-price chassis\nconvention."},"AdmissionsChanceInput":{"properties":{"sat_composite":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Composite"},"act_composite":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Composite"},"unweighted_gpa":{"anyOf":[{"type":"number","maximum":4.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"weighted_gpa":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Weighted Gpa"},"weighted_gpa_scale":{"anyOf":[{"type":"string","enum":["4.0","4.5","5.0"]},{"type":"null"}],"title":"Weighted Gpa Scale"},"class_rank":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Class Size"},"first_generation":{"type":"boolean","title":"First Generation","default":false},"state_of_residence":{"type":"string","maxLength":2,"minLength":2,"title":"State Of Residence"},"college_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":12,"minItems":1,"title":"College Ids"},"test_optional_submission":{"type":"boolean","title":"Test Optional Submission","default":false}},"additionalProperties":false,"type":"object","required":["state_of_residence","college_ids"],"title":"AdmissionsChanceInput","description":"Inputs collected from the chance-me tool form.\n\nValidation rules:\n\n1. At least one of ``sat_composite`` or ``act_composite`` must be\n   submitted, OR ``test_optional_submission`` must be ``True``.\n   Setting ``test_optional_submission=True`` is incompatible with\n   submitting any score.\n2. ``weighted_gpa`` and ``weighted_gpa_scale`` must be set together.\n3. ``class_rank`` requires ``class_size``, and ``rank <= size``.\n4. ``state_of_residence`` is uppercased on ingest."},"AdmissionsChancePrediction":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"p_lo":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Lo"},"p_hi":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Hi"},"p_midpoint":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Midpoint"},"statistical":{"$ref":"#/components/schemas/app__schemas__admissions_chance__UncertaintyComponent"},"out_of_model":{"$ref":"#/components/schemas/app__schemas__admissions_chance__UncertaintyComponent"},"drivers":{"items":{"$ref":"#/components/schemas/Driver"},"type":"array","title":"Drivers"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"tier":{"type":"string","enum":["safety","match","reach","far_reach","insufficient_data"],"title":"Tier"}},"type":"object","required":["college_id","p_lo","p_hi","p_midpoint","statistical","out_of_model","tier"],"title":"AdmissionsChancePrediction","description":"Per-college admit-chance prediction envelope.\n\nSee module docstring for the honesty contract."},"AdmissionsChanceResult":{"properties":{"session_id":{"type":"string","title":"Session Id"},"predictions":{"items":{"$ref":"#/components/schemas/AdmissionsChancePrediction"},"type":"array","title":"Predictions"},"levers":{"additionalProperties":{"items":{"type":"string","format":"uuid"},"type":"array"},"propertyNames":{"enum":["sat_composite","gpa_unweighted"]},"type":"object","title":"Levers"},"out_of_model_summary":{"items":{"type":"string"},"type":"array","title":"Out Of Model Summary"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["session_id","predictions","levers","out_of_model_summary"],"title":"AdmissionsChanceResult","description":"Response envelope for both ``/estimate`` and ``/slider``.\n\nPer ARCHITECTURE.md §\"Prediction Tools\" — every per-college band\nsurvives the wire intact; the result page reads it as-is. Predictions\nare sorted server-side by selectivity tier (safety → match → reach →\nfar_reach → insufficient_data) so the page renders the same order\non every render and clients don't need their own sort."},"AdmissionsEventInstance":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"}},"type":"object","required":["id","starts_at"],"title":"AdmissionsEventInstance","description":"One stored date of a series, with the row id an \"I'm going\" is made against (#705)."},"AgentFunnelResponse":{"properties":{"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"min_sample":{"type":"integer","title":"Min Sample"},"rows":{"items":{"$ref":"#/components/schemas/AgentFunnelRow"},"type":"array","title":"Rows"}},"type":"object","required":["start","end","min_sample","rows"],"title":"AgentFunnelResponse"},"AgentFunnelRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"agent_name":{"type":"string","title":"Agent Name"},"kind":{"type":"string","title":"Kind"},"created_count":{"type":"integer","title":"Created Count"},"pending_count":{"type":"integer","title":"Pending Count"},"decided_count":{"type":"integer","title":"Decided Count"},"dismissed_count":{"type":"integer","title":"Dismissed Count"},"expired_count":{"type":"integer","title":"Expired Count"},"done_count":{"type":"integer","title":"Done Count"},"failed_count":{"type":"integer","title":"Failed Count"},"archived_count":{"type":"integer","title":"Archived Count"},"surfaced_decisions":{"type":"integer","title":"Surfaced Decisions"},"open_ended_count":{"type":"integer","title":"Open Ended Count"},"acceptance_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acceptance Rate"},"dismiss_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dismiss Rate"},"expiry_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expiry Rate"},"p50_time_to_decision_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P50 Time To Decision Ms"},"impact_value_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impact Value Total"},"low_sample":{"type":"boolean","title":"Low Sample"}},"type":"object","required":["metric_date","agent_name","kind","created_count","pending_count","decided_count","dismissed_count","expired_count","done_count","failed_count","archived_count","surfaced_decisions","open_ended_count","acceptance_rate","dismiss_rate","expiry_rate","p50_time_to_decision_ms","impact_value_total","low_sample"],"title":"AgentFunnelRow","description":"One ``metrics_agent_items_daily`` row + the computed ``low_sample`` flag."},"AgentItemResolveRequest":{"properties":{"option_id":{"type":"string","title":"Option Id"},"source":{"type":"string","enum":["board","concierge_chat"],"title":"Source","default":"board"}},"type":"object","required":["option_id"],"title":"AgentItemResolveRequest","description":"Body for resolving a decision (choosing one of its options)."},"AgentRunsDailyResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/AgentRunsDailyRow"},"type":"array","title":"Rows"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"},"capture_enabled":{"type":"boolean","title":"Capture Enabled","description":"Whether this environment records chat turns (`AGENT_OBSERVABILITY_ENABLED`). When false, zero rows mean nothing was recorded, not that nothing happened."}},"type":"object","required":["rows","since","until","capture_enabled"],"title":"AgentRunsDailyResponse","description":"Range-filtered list of daily agent-run rollups."},"AgentRunsDailyRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"code_path":{"type":"string","title":"Code Path"},"turns_total":{"type":"integer","title":"Turns Total"},"turns_with_search":{"type":"integer","title":"Turns With Search"},"turns_no_search":{"type":"integer","title":"Turns No Search"},"intent_explore":{"type":"integer","title":"Intent Explore"},"intent_search":{"type":"integer","title":"Intent Search"},"intent_compare":{"type":"integer","title":"Intent Compare"},"fallback_to_legacy_count":{"type":"integer","title":"Fallback To Legacy Count"},"error_count":{"type":"integer","title":"Error Count"},"p50_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P50 Duration Ms"},"p95_duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"P95 Duration Ms"},"tokens_in_total":{"type":"integer","title":"Tokens In Total"},"tokens_out_total":{"type":"integer","title":"Tokens Out Total"},"cost_usd_total":{"type":"string","title":"Cost Usd Total"},"search_no_results_count":{"type":"integer","title":"Search No Results Count"},"recommender_branch_counts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recommender Branch Counts"}},"type":"object","required":["metric_date","code_path","turns_total","turns_with_search","turns_no_search","intent_explore","intent_search","intent_compare","fallback_to_legacy_count","error_count","tokens_in_total","tokens_out_total","cost_usd_total","search_no_results_count"],"title":"AgentRunsDailyRow","description":"One row from ``metrics_agent_runs_daily`` (#258, Phase 2)."},"AgentSessionMessage":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"role":{"type":"string","title":"Role"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"content":{"type":"string","title":"Content","description":"Redacted text: the student's name and email, phones, birth dates and SAT/ACT scores are replaced with tags."}},"type":"object","required":["id","role","created_at","content"],"title":"AgentSessionMessage","description":"One chat message, redacted through ``redact_for_telemetry`` (#709, option 1)."},"AgentSessionResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"guest":{"type":"boolean","title":"Guest"},"muted":{"type":"boolean","title":"Muted"},"turns":{"items":{"$ref":"#/components/schemas/AgentSessionTurn"},"type":"array","title":"Turns"},"messages":{"items":{"$ref":"#/components/schemas/AgentSessionMessage"},"type":"array","title":"Messages"},"capture_enabled":{"type":"boolean","title":"Capture Enabled"}},"type":"object","required":["conversation_id","guest","muted","turns","messages","capture_enabled"],"title":"AgentSessionResponse","description":"Every captured turn of one conversation, oldest first, with its redacted transcript (#709)."},"AgentSessionTurn":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id"},"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"code_path":{"type":"string","title":"Code Path"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"},"terminal_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminal Node"},"streaming":{"type":"boolean","title":"Streaming","default":false},"tokens_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens In"},"tokens_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Out"},"cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Usd"},"colleges_found_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Colleges Found Count"},"search_returned_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Returned Count"},"error_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Node"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"spans":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Spans"},"tool_calls":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"extra_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Data"},"question_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Question Message Id","description":"The latest user message before this turn's reply."},"reply_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Reply Message Id","description":"The assistant message this turn produced (`message_id`)."}},"type":"object","required":["id","conversation_id","started_at","code_path"],"title":"AgentSessionTurn","description":"A turn in a session, paired with the messages it answered and produced."},"AgentTurnDetail":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id"},"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"code_path":{"type":"string","title":"Code Path"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"},"terminal_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminal Node"},"streaming":{"type":"boolean","title":"Streaming","default":false},"tokens_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens In"},"tokens_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Out"},"cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Usd"},"colleges_found_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Colleges Found Count"},"search_returned_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Returned Count"},"error_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Node"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"spans":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Spans"},"tool_calls":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"extra_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Data"}},"type":"object","required":["id","conversation_id","started_at","code_path"],"title":"AgentTurnDetail","description":"Full row including the JSON span / tool-call detail for drill-down."},"AgentTurnListResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/AgentTurnRow"},"type":"array","title":"Rows"},"next_cursor":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor","description":"Pass as the `cursor` query param to fetch the next page (older rows)."},"count":{"type":"integer","title":"Count"},"capture_enabled":{"type":"boolean","title":"Capture Enabled","description":"Whether this environment records chat turns (`AGENT_OBSERVABILITY_ENABLED`). When false, an empty page means nothing was recorded, not that nothing happened."}},"type":"object","required":["rows","count","capture_enabled"],"title":"AgentTurnListResponse","description":"Paginated list of recent agent turns."},"AgentTurnRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id"},"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"code_path":{"type":"string","title":"Code Path"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"},"terminal_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terminal Node"},"streaming":{"type":"boolean","title":"Streaming","default":false},"tokens_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens In"},"tokens_out":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tokens Out"},"cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Usd"},"colleges_found_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Colleges Found Count"},"search_returned_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Returned Count"},"error_node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Node"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","conversation_id","started_at","code_path"],"title":"AgentTurnRow","description":"One row from ``metrics_agent_turns`` (list view — no large JSON columns)."},"AidPackageComparisonRequest":{"properties":{"parent_income":{"type":"number","minimum":0.0,"title":"Parent Income"},"parent_assets":{"type":"number","minimum":0.0,"title":"Parent Assets","default":0},"student_income":{"type":"number","minimum":0.0,"title":"Student Income","default":0},"student_assets":{"type":"number","minimum":0.0,"title":"Student Assets","default":0},"family_size":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Family Size","default":4},"num_in_college":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Num In College","default":1},"state_tax_rate":{"type":"number","maximum":0.15,"minimum":0.0,"title":"State Tax Rate","default":0.05},"college_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"College Ids","description":"List of college IDs to compare"}},"type":"object","required":["parent_income","college_ids"],"title":"AidPackageComparisonRequest","description":"Request body for comparing aid packages across multiple colleges."},"AidPackageComparisonResponse":{"properties":{"sai":{"type":"integer","title":"Sai"},"sai_breakdown":{"$ref":"#/components/schemas/SAIBreakdown"},"estimated_pell_grant":{"type":"integer","title":"Estimated Pell Grant"},"pell_eligible":{"type":"boolean","title":"Pell Eligible"},"colleges":{"items":{"$ref":"#/components/schemas/CollegeAidComparison"},"type":"array","title":"Colleges"},"disclaimer":{"type":"string","title":"Disclaimer"}},"type":"object","required":["sai","sai_breakdown","estimated_pell_grant","pell_eligible","colleges","disclaimer"],"title":"AidPackageComparisonResponse"},"AidPackageRequest":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id","description":"College ID"},"sai":{"type":"integer","title":"Sai","description":"Student Aid Index"},"estimated_pell":{"type":"integer","minimum":0.0,"title":"Estimated Pell","description":"Estimated Pell Grant","default":0},"residency_status":{"type":"string","title":"Residency Status","description":"in-state or out-of-state","default":"out-of-state"}},"type":"object","required":["college_id","sai"],"title":"AidPackageRequest","description":"Request body for aid package estimation."},"AidPackageResponse":{"properties":{"cost_of_attendance":{"type":"integer","title":"Cost Of Attendance"},"financial_need":{"type":"integer","title":"Financial Need"},"sai":{"type":"integer","title":"Sai"},"estimated_aid_package":{"$ref":"#/components/schemas/EstimatedAidPackage"},"estimated_out_of_pocket":{"type":"integer","title":"Estimated Out Of Pocket"},"disclaimer":{"type":"string","title":"Disclaimer"},"college_name":{"type":"string","title":"College Name"},"college_id":{"type":"string","title":"College Id"},"estimated_grants":{"type":"integer","title":"Estimated Grants"},"estimated_federal_loans":{"type":"integer","title":"Estimated Federal Loans"},"estimated_work_study":{"type":"integer","title":"Estimated Work Study"}},"type":"object","required":["cost_of_attendance","financial_need","sai","estimated_aid_package","estimated_out_of_pocket","disclaimer","college_name","college_id","estimated_grants","estimated_federal_loans","estimated_work_study"],"title":"AidPackageResponse"},"AllFeatureFlagsResult":{"properties":{"flags":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Flags"}},"type":"object","required":["flags"],"title":"AllFeatureFlagsResult","description":"Response for the batch evaluation endpoint."},"AnswerOut":{"properties":{"pell":{"$ref":"#/components/schemas/PellOutlookOut"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"colleges":{"items":{"$ref":"#/components/schemas/NearZeroCollegeOut"},"type":"array","title":"Colleges"},"college_count":{"type":"integer","title":"College Count"},"scorecard_updated":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Scorecard Updated"},"near_zero":{"type":"integer","title":"Near Zero"},"colleges_are_lowest":{"type":"boolean","title":"Colleges Are Lowest"}},"type":"object","required":["pell","state","colleges","college_count","scorecard_updated","near_zero","colleges_are_lowest"],"title":"AnswerOut"},"ApiChangelogCreate":{"properties":{"version":{"type":"string","maxLength":20,"minLength":1,"title":"Version"},"date":{"type":"string","format":"date","title":"Date"},"category":{"type":"string","enum":["added","changed","deprecated","removed","fixed","security"],"title":"Category"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"description":{"type":"string","minLength":1,"title":"Description"},"breaking":{"type":"boolean","title":"Breaking","default":false}},"type":"object","required":["version","date","category","title","description"],"title":"ApiChangelogCreate"},"ApiChangelogListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ApiChangelogResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"ApiChangelogListResponse"},"ApiChangelogResponse":{"properties":{"version":{"type":"string","maxLength":20,"minLength":1,"title":"Version"},"date":{"type":"string","format":"date","title":"Date"},"category":{"type":"string","enum":["added","changed","deprecated","removed","fixed","security"],"title":"Category"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"description":{"type":"string","minLength":1,"title":"Description"},"breaking":{"type":"boolean","title":"Breaking","default":false},"id":{"type":"integer","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["version","date","category","title","description","id","created_at","updated_at"],"title":"ApiChangelogResponse"},"ApiChangelogUpdate":{"properties":{"version":{"anyOf":[{"type":"string","maxLength":20,"minLength":1},{"type":"null"}],"title":"Version"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"category":{"anyOf":[{"type":"string","enum":["added","changed","deprecated","removed","fixed","security"]},{"type":"null"}],"title":"Category"},"title":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Description"},"breaking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Breaking"}},"type":"object","title":"ApiChangelogUpdate","description":"All fields optional — PATCH-style partial update."},"ApiKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Scopes"},"expires_in_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Expires In Days"}},"type":"object","required":["name","scopes"],"title":"ApiKeyCreateRequest"},"ApiKeyCreatedResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"rate_limit_tier":{"type":"string","title":"Rate Limit Tier"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"key":{"type":"string","title":"Key"}},"type":"object","required":["id","name","prefix","scopes","rate_limit_tier","is_active","created_at","key"],"title":"ApiKeyCreatedResponse","description":"Returned exactly once on creation/rotation. Contains the raw key."},"ApiKeyResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"rate_limit_tier":{"type":"string","title":"Rate Limit Tier"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","name","prefix","scopes","rate_limit_tier","is_active","created_at"],"title":"ApiKeyResponse"},"AppleAuthRequest":{"properties":{"identity_token":{"type":"string","maxLength":8192,"minLength":1,"title":"Identity Token"},"user":{"anyOf":[{"$ref":"#/components/schemas/AppleUserPayload"},{"type":"null"}]},"authorization_code":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Authorization Code"},"redirect_uri":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Redirect Uri"}},"type":"object","required":["identity_token"],"title":"AppleAuthRequest"},"AppleUserName":{"properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"}},"type":"object","title":"AppleUserName","description":"Name fragment of Apple's first-authorization ``user`` payload.\n\nField names are camelCase because they mirror Apple's JS SDK response\nverbatim (the frontend forwards it untouched)."},"AppleUserPayload":{"properties":{"name":{"anyOf":[{"$ref":"#/components/schemas/AppleUserName"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","title":"AppleUserPayload","description":"Apple's first-authorization ``user`` payload (sent exactly once).\n\n``email`` is accepted for shape-compatibility but never trusted — the\nauthoritative email is the verified identity token's claim."},"ApplicationRequirementCreate":{"properties":{"requirement_type":{"type":"string","title":"Requirement Type"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"essay_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Essay Prompt"},"word_count_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count Min"},"word_count_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count Max"},"completed":{"type":"boolean","title":"Completed","default":false},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"}},"type":"object","required":["requirement_type","title"],"title":"ApplicationRequirementCreate","description":"The application comes from the URL, never the body (#1013): a body\n`application_id` from an older client is ignored."},"ApplicationRequirementOut":{"properties":{"requirement_type":{"type":"string","title":"Requirement Type"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"essay_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Essay Prompt"},"word_count_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count Min"},"word_count_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count Max"},"completed":{"type":"boolean","title":"Completed","default":false},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"},"id":{"type":"string","format":"uuid","title":"Id"},"application_id":{"type":"string","format":"uuid","title":"Application Id"},"completed_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["requirement_type","title","id","application_id","completed_date","created_at","updated_at"],"title":"ApplicationRequirementOut"},"ApplicationRequirementUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Completed"},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"},"completed_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed Date"}},"type":"object","title":"ApplicationRequirementUpdate"},"ArticleOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"slug":{"type":"string","title":"Slug"},"description":{"type":"string","title":"Description"},"content":{"type":"string","title":"Content"},"category":{"type":"string","title":"Category"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"author":{"type":"string","title":"Author"},"reading_time":{"type":"integer","title":"Reading Time"},"featured":{"type":"boolean","title":"Featured"},"status":{"type":"string","title":"Status"},"related_slugs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Related Slugs"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","title","slug","description","content","category","author","reading_time","featured","status","created_at","updated_at"],"title":"ArticleOut"},"ArticleSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"slug":{"type":"string","title":"Slug"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"author":{"type":"string","title":"Author"},"reading_time":{"type":"integer","title":"Reading Time"},"featured":{"type":"boolean","title":"Featured"},"status":{"type":"string","title":"Status"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","title","slug","description","category","author","reading_time","featured","status","created_at","updated_at"],"title":"ArticleSummary","description":"Lightweight article summary without full content (for listing pages)."},"AthleteVideoCreate":{"properties":{"title":{"type":"string","maxLength":255,"title":"Title"},"url":{"type":"string","maxLength":500,"title":"Url"},"sport":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sport"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"sort_order":{"type":"integer","title":"Sort Order","default":0}},"type":"object","required":["title","url"],"title":"AthleteVideoCreate"},"AthleteVideoOut":{"properties":{"title":{"type":"string","maxLength":255,"title":"Title"},"url":{"type":"string","maxLength":500,"title":"Url"},"sport":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sport"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"sort_order":{"type":"integer","title":"Sort Order","default":0},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["title","url","id","profile_id","created_at","updated_at"],"title":"AthleteVideoOut"},"AthleteVideoUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url"},"sport":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sport"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_primary":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Primary"},"sort_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sort Order"}},"type":"object","title":"AthleteVideoUpdate"},"AthleticBenchmarkOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"sport":{"type":"string","title":"Sport"},"division_level":{"type":"string","title":"Division Level"},"stat_name":{"type":"string","title":"Stat Name"},"stat_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stat Unit"},"benchmark_value":{"type":"string","title":"Benchmark Value"},"benchmark_level":{"type":"string","title":"Benchmark Level"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["id","sport","division_level","stat_name","benchmark_value","benchmark_level"],"title":"AthleticBenchmarkOut"},"AthleticCoachCreate":{"properties":{"name":{"type":"string","title":"Name"},"title":{"type":"string","title":"Title"},"photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo Url"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"office_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Location"},"contact_hours":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Hours"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"alma_mater":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alma Mater"},"playing_experience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playing Experience"},"coaching_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching History"},"career_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Wins"},"career_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Losses"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"coaching_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching Achievements"},"recruiting_coordinator":{"type":"boolean","title":"Recruiting Coordinator","default":false},"recruiting_territories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruiting Territories"},"specialization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialization"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"is_active":{"type":"boolean","title":"Is Active","default":true},"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"}},"type":"object","required":["name","title","athletic_program_id"],"title":"AthleticCoachCreate"},"AthleticCoachOut":{"properties":{"name":{"type":"string","title":"Name"},"title":{"type":"string","title":"Title"},"photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo Url"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"office_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Location"},"contact_hours":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Hours"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"alma_mater":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alma Mater"},"playing_experience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playing Experience"},"coaching_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching History"},"career_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Wins"},"career_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Losses"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"coaching_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching Achievements"},"recruiting_coordinator":{"type":"boolean","title":"Recruiting Coordinator","default":false},"recruiting_territories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruiting Territories"},"specialization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialization"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"is_active":{"type":"boolean","title":"Is Active","default":true},"id":{"type":"string","format":"uuid","title":"Id"},"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["name","title","id","athletic_program_id","created_at","updated_at"],"title":"AthleticCoachOut"},"AthleticCoachUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"photo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo Url"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"office_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Office Location"},"contact_hours":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Hours"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"alma_mater":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alma Mater"},"playing_experience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Playing Experience"},"coaching_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching History"},"career_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Wins"},"career_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Career Losses"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"coaching_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coaching Achievements"},"recruiting_coordinator":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Recruiting Coordinator"},"recruiting_territories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruiting Territories"},"specialization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialization"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"AthleticCoachUpdate"},"AthleticOpponentCreate":{"properties":{"opponent_name":{"type":"string","title":"Opponent Name"},"opponent_division":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opponent Division"},"conference_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Affiliation"},"is_conference_opponent":{"type":"boolean","title":"Is Conference Opponent","default":false},"games_per_season":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Games Per Season"},"rivalry_game":{"type":"boolean","title":"Rivalry Game","default":false},"opponent_strength":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opponent Strength"},"all_time_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"All Time Record"},"recent_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Record"},"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"}},"type":"object","required":["opponent_name","athletic_program_id"],"title":"AthleticOpponentCreate"},"AthleticOpponentOut":{"properties":{"opponent_name":{"type":"string","title":"Opponent Name"},"opponent_division":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opponent Division"},"conference_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Affiliation"},"is_conference_opponent":{"type":"boolean","title":"Is Conference Opponent","default":false},"games_per_season":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Games Per Season"},"rivalry_game":{"type":"boolean","title":"Rivalry Game","default":false},"opponent_strength":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opponent Strength"},"all_time_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"All Time Record"},"recent_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Record"},"id":{"type":"string","format":"uuid","title":"Id"},"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["opponent_name","id","athletic_program_id","created_at","updated_at"],"title":"AthleticOpponentOut"},"AthleticPerformanceEntryCreate":{"properties":{"sport":{"type":"string","maxLength":100,"title":"Sport"},"stat_name":{"type":"string","maxLength":100,"title":"Stat Name"},"stat_value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Stat Value"},"stat_unit":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Stat Unit"},"recorded_date":{"type":"string","format":"date","title":"Recorded Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["sport","stat_name","stat_value","recorded_date"],"title":"AthleticPerformanceEntryCreate"},"AthleticPerformanceEntryOut":{"properties":{"sport":{"type":"string","maxLength":100,"title":"Sport"},"stat_name":{"type":"string","maxLength":100,"title":"Stat Name"},"stat_value":{"type":"string","title":"Stat Value"},"stat_unit":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Stat Unit"},"recorded_date":{"type":"string","format":"date","title":"Recorded Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["sport","stat_name","stat_value","recorded_date","id","profile_id","created_at"],"title":"AthleticPerformanceEntryOut"},"AthleticPerformanceEntryUpdate":{"properties":{"sport":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sport"},"stat_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Stat Name"},"stat_value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Stat Value"},"stat_unit":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Stat Unit"},"recorded_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Recorded Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"AthleticPerformanceEntryUpdate"},"AthleticProgramCreate":{"properties":{"sport_name":{"type":"string","title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":true},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"type":"boolean","title":"Is Active","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"college_id":{"type":"string","format":"uuid","title":"College Id"}},"type":"object","required":["sport_name","gender","college_id"],"title":"AthleticProgramCreate"},"AthleticProgramMatch":{"properties":{"program":{"$ref":"#/components/schemas/AthleticProgramOut"},"match_score":{"type":"number","title":"Match Score","description":"Overall match score (0-100)"},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons","description":"Reasons for the match"},"score_breakdown":{"additionalProperties":{"type":"number"},"type":"object","title":"Score Breakdown","description":"Breakdown of score by category"}},"type":"object","required":["program","match_score","match_reasons","score_breakdown"],"title":"AthleticProgramMatch","description":"Athletic program match result with scoring."},"AthleticProgramOut":{"properties":{"sport_name":{"type":"string","title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":true},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"type":"boolean","title":"Is Active","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college":{"anyOf":[{"$ref":"#/components/schemas/CollegeBasicInfo"},{"type":"null"}]},"last_verified_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"freshness_status":{"anyOf":[{"type":"string","enum":["fresh","stale","archived"]},{"type":"null"}],"title":"Freshness Status"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."}},"type":"object","required":["sport_name","gender","id","college_id","last_verified_date","created_at","updated_at"],"title":"AthleticProgramOut"},"AthleticProgramOutWithConfidence":{"properties":{"sport_name":{"type":"string","title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":true},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"type":"boolean","title":"Is Active","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college":{"anyOf":[{"$ref":"#/components/schemas/CollegeBasicInfo"},{"type":"null"}]},"last_verified_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"freshness_status":{"anyOf":[{"type":"string","enum":["fresh","stale","archived"]},{"type":"null"}],"title":"Freshness Status"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."},"confidence_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Confidence Scores"},"last_scraped_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scraped At"},"data_sources":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Sources"}},"type":"object","required":["sport_name","gender","id","college_id","last_verified_date","created_at","updated_at"],"title":"AthleticProgramOutWithConfidence","description":"Athletic program with per-field confidence, last-scrape timestamp, and\ndata-source provenance from the agentic scraper pipeline.\n\nOpt in by passing ``include_confidence=true`` on the athletics read endpoints."},"AthleticProgramSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"sport_name":{"type":"string","title":"Sport Name"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":false},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"}},"type":"object","required":["id","sport_name","gender"],"title":"AthleticProgramSummary","description":"Lightweight program info for school cards."},"AthleticProgramUpdate":{"properties":{"sport_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Scholarships Available"},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","title":"AthleticProgramUpdate"},"AthleticProgramWithDetails":{"properties":{"sport_name":{"type":"string","title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":true},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"type":"boolean","title":"Is Active","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college":{"anyOf":[{"$ref":"#/components/schemas/CollegeBasicInfo"},{"type":"null"}]},"last_verified_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"freshness_status":{"anyOf":[{"type":"string","enum":["fresh","stale","archived"]},{"type":"null"}],"title":"Freshness Status"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."},"coaches":{"items":{"$ref":"#/components/schemas/AthleticCoachOut"},"type":"array","title":"Coaches","default":[]},"opponents":{"items":{"$ref":"#/components/schemas/AthleticOpponentOut"},"type":"array","title":"Opponents","default":[]}},"type":"object","required":["sport_name","gender","id","college_id","last_verified_date","created_at","updated_at"],"title":"AthleticProgramWithDetails","description":"Athletic program with related data."},"AthleticProgramWithDetailsWithConfidence":{"properties":{"sport_name":{"type":"string","title":"Sport Name"},"sport_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Category"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Description"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"facilities_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":true},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"full_ride_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Full Ride Scholarships"},"scholarship_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scholarship Notes"},"min_gpa_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"athletic_requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Requirements"},"program_website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Website"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"notable_alumni":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Notable Alumni"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"is_active":{"type":"boolean","title":"Is Active","default":true},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college":{"anyOf":[{"$ref":"#/components/schemas/CollegeBasicInfo"},{"type":"null"}]},"last_verified_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"freshness_status":{"anyOf":[{"type":"string","enum":["fresh","stale","archived"]},{"type":"null"}],"title":"Freshness Status"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."},"coaches":{"items":{"$ref":"#/components/schemas/AthleticCoachOut"},"type":"array","title":"Coaches","default":[]},"opponents":{"items":{"$ref":"#/components/schemas/AthleticOpponentOut"},"type":"array","title":"Opponents","default":[]},"confidence_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Confidence Scores"},"last_scraped_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scraped At"},"data_sources":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Sources"}},"type":"object","required":["sport_name","gender","id","college_id","last_verified_date","created_at","updated_at"],"title":"AthleticProgramWithDetailsWithConfidence","description":"Athletic program detail with coaches, opponents, and confidence metadata.\n\nOpt in by passing ``include_confidence=true`` on ``GET /athletics/programs/{id}``."},"AthleticsContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff the college has at least one EADA snapshot or one athletic_programs row. Drives sitemap inclusion + noindex."},"total_athletic_aid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Athletic Aid"},"athletes_men":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Athletes Men"},"athletes_women":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Athletes Women"},"divisions":{"items":{"type":"string"},"type":"array","title":"Divisions"},"conferences":{"items":{"type":"string"},"type":"array","title":"Conferences"},"sports":{"items":{"$ref":"#/components/schemas/AthleticsSportRow"},"type":"array","title":"Sports"},"peer_schools":{"items":{"$ref":"#/components/schemas/AthleticsPeerSchool"},"type":"array","title":"Peer Schools"},"eada_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eada Year","description":"Latest EADA filing year used for the aggregate numbers. May differ across schools; surfaced in the page sources block."},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","has_any_data","last_retrieved_at"],"title":"AthleticsContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/athletics-context``.\n\nPer-school aggregate showing total athletic aid, participation, sponsored\nsports, division/conference, and peer-school cards. See ARCHITECTURE.md\n§\"Detail-page SEO sub-routes\" for the rendering contract on the consuming\nNext.js page."},"AthleticsDataQualityResponse":{"properties":{"total_programs":{"type":"integer","title":"Total Programs"},"programs_missing_coaches":{"type":"integer","title":"Programs Missing Coaches"},"programs_missing_division":{"type":"integer","title":"Programs Missing Division"},"programs_missing_scholarship_info":{"type":"integer","title":"Programs Missing Scholarship Info"},"division_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Division Breakdown"},"coach_coverage":{"$ref":"#/components/schemas/CoachCoverage"},"flagged_records":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Flagged Records"},"college_coverage":{"$ref":"#/components/schemas/CollegeCoverage"},"prominent_colleges_missing":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Prominent Colleges Missing"},"stale_by_sport":{"additionalProperties":{"type":"integer"},"type":"object","title":"Stale By Sport"},"archived_by_sport":{"additionalProperties":{"type":"integer"},"type":"object","title":"Archived By Sport"},"shared_athletics_hosts":{"items":{"$ref":"#/components/schemas/SharedAthleticsHost"},"type":"array","title":"Shared Athletics Hosts"}},"type":"object","required":["total_programs","programs_missing_coaches","programs_missing_division","programs_missing_scholarship_info","division_breakdown","coach_coverage","flagged_records","college_coverage","prominent_colleges_missing"],"title":"AthleticsDataQualityResponse","description":"Athletics data quality report payload returned by `/athletics/data-quality`."},"AthleticsPeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"primary_athletic_division":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Athletic Division"},"total_athletic_aid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Athletic Aid"}},"type":"object","required":["id","slug","name","state","primary_athletic_division","total_athletic_aid"],"title":"AthleticsPeerSchool","description":"One peer-school card on /colleges/[id]/athletics."},"AthleticsSportRow":{"properties":{"sport":{"type":"string","title":"Sport"},"has_men":{"type":"boolean","title":"Has Men"},"has_women":{"type":"boolean","title":"Has Women"},"athletes_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Athletes Total"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":false},"avg_scholarship_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Scholarship Amount"}},"type":"object","required":["sport","has_men","has_women"],"title":"AthleticsSportRow","description":"One sponsored sport on /colleges/[id]/athletics.\n\nSpine fields (``athletes_total``, gender flags) come from EADA; the\nscholarship fields are enriched from ``athletic_programs`` and are None\nwhen no matching program row carries them."},"AthleticsUrlUpdate":{"properties":{"athletics_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Athletics Url"}},"type":"object","title":"AthleticsUrlUpdate"},"AttentionRollup":{"properties":{"counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counselor Id"},"counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counselor Name"},"students":{"type":"integer","title":"Students"},"sharing":{"type":"integer","title":"Sharing"},"quiet":{"type":"integer","title":"Quiet"},"active":{"type":"integer","title":"Active"},"list_unbalanced":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"List Unbalanced"},"deadline_at_risk":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Deadline At Risk"},"profile_gaps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Profile Gaps"}},"type":"object","required":["counselor_id","counselor_name","students","sharing","quiet","active","list_unbalanced","deadline_at_risk","profile_gaps"],"title":"AttentionRollup","description":"One counselor's caseload in counts, as that counselor's grants see it.\nThe profile counts are None when fewer than ``ROLLUP_MIN_SHARING`` share."},"AttentionStudent":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"name":{"type":"string","title":"Name"},"flags":{"items":{"type":"string","enum":["quiet","active","list_unbalanced","deadline_at_risk","profile_gaps"]},"type":"array","title":"Flags"},"list_flag":{"anyOf":[{"type":"string","enum":["all_reach","undermatched"]},{"type":"null"}],"title":"List Flag"},"activity_basis":{"type":"string","enum":["active_days","last_chat"],"title":"Activity Basis"},"shares":{"type":"boolean","title":"Shares"}},"type":"object","required":["student_user_id","name","flags","activity_basis","shares"],"title":"AttentionStudent"},"AuditLogListResponse":{"properties":{"logs":{"items":{"$ref":"#/components/schemas/AuditLogOut"},"type":"array","title":"Logs"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["logs","total","page","page_size","total_pages"],"title":"AuditLogListResponse","description":"Paginated list of audit log entries."},"AuditLogMarkExportRequest":{"properties":{"log_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Log Ids","description":"List of audit log IDs to mark for export"}},"type":"object","required":["log_ids"],"title":"AuditLogMarkExportRequest","description":"Schema for marking audit logs for export."},"AuditLogMarkExportResponse":{"properties":{"message":{"type":"string","title":"Message"},"marked_count":{"type":"integer","title":"Marked Count"}},"type":"object","required":["message","marked_count"],"title":"AuditLogMarkExportResponse","description":"Response after marking audit logs for export."},"AuditLogOut":{"properties":{"action_type":{"type":"string","title":"Action Type","description":"Type of action performed"},"action_category":{"type":"string","title":"Action Category","description":"Category of action"},"action_description":{"type":"string","title":"Action Description","description":"Human-readable description"},"actor_type":{"type":"string","title":"Actor Type","description":"Type of actor (user, system, celery_task, admin)"},"id":{"type":"string","format":"uuid","title":"Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"resource_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Type"},"resource_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Id"},"request_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Path"},"request_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Method"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"status":{"type":"string","title":"Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"extra_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Data"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"marked_for_export":{"type":"boolean","title":"Marked For Export"},"exported_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Exported At"}},"type":"object","required":["action_type","action_category","action_description","actor_type","id","timestamp","status","marked_for_export"],"title":"AuditLogOut","description":"Schema for returning audit log entries."},"AuditLogStatsResponse":{"properties":{"total_logs":{"type":"integer","title":"Total Logs"},"by_category":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Category"},"by_actor_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Actor Type"},"by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Status"},"marked_for_export":{"type":"integer","title":"Marked For Export"}},"type":"object","required":["total_logs","by_category","by_actor_type","by_status","marked_for_export"],"title":"AuditLogStatsResponse","description":"Audit log summary statistics."},"AuditLogUnmarkExportResponse":{"properties":{"message":{"type":"string","title":"Message"},"unmarked_count":{"type":"integer","title":"Unmarked Count"}},"type":"object","required":["message","unmarked_count"],"title":"AuditLogUnmarkExportResponse","description":"Response after unmarking audit logs for export."},"BandPoint":{"properties":{"year":{"type":"integer","title":"Year"},"low":{"type":"integer","title":"Low"},"high":{"type":"integer","title":"High"}},"type":"object","required":["year","low","high"],"title":"BandPoint","description":"One year's mid-50% band (25th–75th percentile) for a score metric."},"BatchEmailFilters":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_active":{"anyOf":[{"type":"boolean","const":true},{"type":"null"}],"title":"Is Active"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"}},"type":"object","title":"BatchEmailFilters","description":"Filters for selecting batch email recipients."},"BatchEmailJobList":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/BatchEmailJobResponse"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["jobs","total"],"title":"BatchEmailJobList","description":"Paginated list of batch email jobs."},"BatchEmailJobResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"admin_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Admin Id"},"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"text_body":{"type":"string","title":"Text Body"},"filters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filters"},"total_recipients":{"type":"integer","title":"Total Recipients"},"sent_count":{"type":"integer","title":"Sent Count"},"failed_count":{"type":"integer","title":"Failed Count"},"status":{"type":"string","title":"Status"},"celery_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Celery Task Id"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","admin_id","subject","body","text_body","total_recipients","sent_count","failed_count","status","created_at"],"title":"BatchEmailJobResponse","description":"Response for a single batch email job."},"BatchEmailPreviewRequest":{"properties":{"filters":{"$ref":"#/components/schemas/BatchEmailFilters"}},"type":"object","title":"BatchEmailPreviewRequest","description":"Request to preview batch email recipients."},"BatchEmailPreviewResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"sample_recipients":{"items":{"$ref":"#/components/schemas/SampleRecipient"},"type":"array","title":"Sample Recipients"}},"type":"object","required":["total_count","sample_recipients"],"title":"BatchEmailPreviewResponse","description":"Response showing how many users match the filters."},"BatchEmailSendRequest":{"properties":{"subject":{"type":"string","maxLength":200,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":100000,"minLength":1,"title":"Body"},"text_body":{"type":"string","maxLength":50000,"minLength":1,"title":"Text Body"},"filters":{"$ref":"#/components/schemas/BatchEmailFilters"},"confirm_recipient_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Confirm Recipient Count"}},"type":"object","required":["subject","body","text_body"],"title":"BatchEmailSendRequest","description":"Request to send a batch email."},"BeatScheduleEntry":{"properties":{"beat_name":{"type":"string","title":"Beat Name"},"task_name":{"type":"string","title":"Task Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"crontab_raw":{"type":"string","title":"Crontab Raw"},"crontab_human":{"type":"string","title":"Crontab Human"},"kwargs":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kwargs"},"options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Options"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"last_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status"},"current_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Status"},"next_fire_at":{"type":"string","format":"date-time","title":"Next Fire At"},"run_count":{"type":"integer","title":"Run Count"}},"type":"object","required":["beat_name","task_name","display_name","crontab_raw","crontab_human","next_fire_at","run_count"],"title":"BeatScheduleEntry","description":"One entry in the Celery beat schedule with last-run / next-fire metadata."},"BeatScheduleResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/BeatScheduleEntry"},"type":"array","title":"Entries"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["entries","meta"],"title":"BeatScheduleResponse"},"Body_import_indexation_csv_api_v1_admin_seo_indexation_import_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"GSC Performance export CSV."}},"type":"object","required":["file"],"title":"Body_import_indexation_csv_api_v1_admin_seo_indexation_import_post"},"Body_import_wages_api_v1_admin_occupations_wages_import_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"OEWS national workbook (.xlsx)."},"vintage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vintage","description":"OEWS reference year; inferred from filename if omitted."}},"type":"object","required":["file"],"title":"Body_import_wages_api_v1_admin_occupations_wages_import_post"},"Body_login_api_v1_auth_login_post":{"properties":{"grant_type":{"anyOf":[{"type":"string","pattern":"^password$"},{"type":"null"}],"title":"Grant Type"},"username":{"type":"string","title":"Username"},"password":{"type":"string","format":"password","title":"Password"},"scope":{"type":"string","title":"Scope","default":""},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"client_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"password","title":"Client Secret"}},"type":"object","required":["username","password"],"title":"Body_login_api_v1_auth_login_post"},"Body_native_challenge_api_v1_auth_native_challenge_post":{"properties":{"token":{"type":"string","title":"Token"},"state":{"type":"string","title":"State"}},"type":"object","required":["token","state"],"title":"Body_native_challenge_api_v1_auth_native_challenge_post"},"Body_upload_document_api_v1_profiles__profile_id__documents_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title","description":"Document title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional document description"},"document_type":{"$ref":"#/components/schemas/DocumentType","description":"Type of document"},"category":{"$ref":"#/components/schemas/DocumentCategory","description":"Document category"}},"type":"object","required":["file","title","document_type","category"],"title":"Body_upload_document_api_v1_profiles__profile_id__documents_post"},"BulkAddAlreadyPresent":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"}},"type":"object","required":["email","student_user_id"],"title":"BulkAddAlreadyPresent"},"BulkAddSkipped":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"reason":{"type":"string","const":"unavailable","title":"Reason"}},"type":"object","required":["email","reason"],"title":"BulkAddSkipped"},"BulkAthleticsUrlItem":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"athletics_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Athletics Url"}},"type":"object","required":["college_id"],"title":"BulkAthleticsUrlItem"},"BulkAthleticsUrlResult":{"properties":{"updated":{"type":"integer","title":"Updated"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"}},"type":"object","required":["updated","errors"],"title":"BulkAthleticsUrlResult"},"BulkAthleticsUrlUpdate":{"properties":{"updates":{"items":{"$ref":"#/components/schemas/BulkAthleticsUrlItem"},"type":"array","title":"Updates"}},"type":"object","required":["updates"],"title":"BulkAthleticsUrlUpdate"},"BulkDeleteRequest":{"properties":{"ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Ids"}},"type":"object","required":["ids"],"title":"BulkDeleteRequest"},"BulkUpdateRankingsRequest":{"properties":{"rankings":{"items":{"$ref":"#/components/schemas/RankingUpdate"},"type":"array","title":"Rankings"}},"type":"object","required":["rankings"],"title":"BulkUpdateRankingsRequest"},"BulkUpdateRoleRequest":{"properties":{"user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"User Ids"},"new_role":{"type":"string","title":"New Role"}},"type":"object","required":["user_ids","new_role"],"title":"BulkUpdateRoleRequest"},"BulkUserIdsRequest":{"properties":{"user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"User Ids"}},"type":"object","required":["user_ids"],"title":"BulkUserIdsRequest"},"BulkUserOperationResponse":{"properties":{"succeeded":{"items":{"type":"string"},"type":"array","title":"Succeeded"},"failed":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Failed"}},"type":"object","required":["succeeded","failed"],"title":"BulkUserOperationResponse"},"CDSSummary":{"properties":{"total_colleges":{"type":"integer","title":"Total Colleges"},"with_cds_data":{"type":"integer","title":"With Cds Data"},"with_cds_url":{"type":"integer","title":"With Cds Url"},"without_cds_url":{"type":"integer","title":"Without Cds Url"},"success":{"type":"integer","title":"Success"},"no_url_found":{"type":"integer","title":"No Url Found"},"not_a_pdf":{"type":"integer","title":"Not A Pdf"},"not_cds_document":{"type":"integer","title":"Not Cds Document"},"extraction_failed":{"type":"integer","title":"Extraction Failed"},"too_few_fields":{"type":"integer","title":"Too Few Fields"},"pending":{"type":"integer","title":"Pending"}},"type":"object","required":["total_colleges","with_cds_data","with_cds_url","without_cds_url","success","no_url_found","not_a_pdf","not_cds_document","extraction_failed","too_few_fields","pending"],"title":"CDSSummary"},"CDSURLUpdate":{"properties":{"cds_url":{"type":"string","title":"Cds Url"}},"type":"object","required":["cds_url"],"title":"CDSURLUpdate"},"CalendarLinksOut":{"properties":{"ics_url":{"type":"string","title":"Ics Url"},"google_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Url"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["ics_url","expires_at"],"title":"CalendarLinksOut"},"CalendarSubscriptionCreated":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"token_prefix":{"type":"string","title":"Token Prefix"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_fetched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Fetched At"},"last_client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Client"},"url":{"type":"string","title":"Url"},"webcal_url":{"type":"string","title":"Webcal Url"},"apple_url":{"type":"string","title":"Apple Url"},"google_url":{"type":"string","title":"Google Url"}},"type":"object","required":["id","token_prefix","created_at","url","webcal_url","apple_url","google_url"],"title":"CalendarSubscriptionCreated","description":"A new link. The token is in these URLs and is shown only this once."},"CalendarSubscriptionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"token_prefix":{"type":"string","title":"Token Prefix"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_fetched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Fetched At"},"last_client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Client"}},"type":"object","required":["id","token_prefix","created_at"],"title":"CalendarSubscriptionOut","description":"One calendar link, as the student's list shows it. Never the token."},"CampusLifeContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"indexable":{"type":"boolean","title":"Indexable","description":"True iff the synthesis renders to anonymous users (status fresh/stale AND license in PUBLIC_ANON_LICENSES). Drives sitemap inclusion + the page's index/noindex robots meta."},"synthesis":{"$ref":"#/components/schemas/SynthesisResponse"},"peer_schools":{"items":{"$ref":"#/components/schemas/CampusLifePeerSchool"},"type":"array","title":"Peer Schools"},"fetched_at":{"type":"string","format":"date-time","title":"Fetched At"}},"type":"object","required":["college_id","college_slug","college_name","indexable","synthesis","fetched_at"],"title":"CampusLifeContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/campus-life-context``.\n\nBacks the SSR ``/colleges/[id]/campus-life`` page. ``synthesis`` is the\nshared gated envelope; ``indexable`` is computed against the ANONYMOUS\nrender predicate regardless of caller auth, so the page's ``robots`` meta\nreflects what Googlebot can actually see."},"CampusLifePeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"has_campus_life":{"type":"boolean","title":"Has Campus Life","description":"True iff the peer's synthesis is anonymously renderable (so its /campus-life page is itself indexable). Lets the UI prefer / annotate peers that lead somewhere."}},"type":"object","required":["id","slug","name","state","has_campus_life"],"title":"CampusLifePeerSchool","description":"One peer-school card on /colleges/[id]/campus-life."},"CaptureLeadRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"marketing_opt_in":{"type":"boolean","title":"Marketing Opt In","default":false}},"type":"object","required":["email"],"title":"CaptureLeadRequest"},"CaptureLeadResponse":{"properties":{"lead_id":{"type":"string","format":"uuid","title":"Lead Id"},"email_sent":{"type":"boolean","title":"Email Sent"}},"type":"object","required":["lead_id","email_sent"],"title":"CaptureLeadResponse"},"CardContext":{"properties":{"agent_name":{"type":"string","title":"Agent Name"},"kind":{"type":"string","title":"Kind"},"item_id":{"type":"string","format":"uuid","title":"Item Id"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}},"type":"object","required":["agent_name","kind","item_id"],"title":"CardContext","description":"Structured context from a Mission Control board card (#428).\n\nSent on the opening turn when the user taps a card's \"Ask\" button so the\nConcierge can route deterministically by ``agent_name`` and frame its reply\nwith awareness of the specific card — instead of the LLM re-deriving intent\nfrom the seed prose.\n\nSECURITY: ``payload`` is a client-supplied HINT only. The backend re-loads\nthe ``AgentItem`` by ``item_id`` scoped to the caller's profile and\nre-derives anything sensitive from that validated row — the client payload\nis never trusted for sensitive data. ids/enums/counts only; no PII."},"CareerOutcomePeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"median_earnings_10yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings 10Yr"},"num_publishable_majors":{"type":"integer","minimum":0.0,"title":"Num Publishable Majors"}},"type":"object","required":["id","slug","name","state","median_earnings_10yr","num_publishable_majors"],"title":"CareerOutcomePeerSchool","description":"One peer-school card on /colleges/[id]/career-outcomes."},"CareerOutcomesContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"college_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College State"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff the college has at least one publishable ``college_programs`` row (n>=30, has median_earnings). Drives sitemap inclusion + noindex."},"college_median_earnings_10yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"College Median Earnings 10Yr"},"majors":{"items":{"$ref":"#/components/schemas/MajorOutcomeRow"},"type":"array","title":"Majors"},"peer_schools":{"items":{"$ref":"#/components/schemas/CareerOutcomePeerSchool"},"type":"array","title":"Peer Schools"},"doctorate_origins":{"anyOf":[{"$ref":"#/components/schemas/DoctorateOrigins"},{"type":"null"}]},"data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Year","description":"Always None: per-major and 10-year earnings are cohort measures, dated only by their Scorecard data file, so no academic year is stated for them (#722)."},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","has_any_data","last_retrieved_at"],"title":"CareerOutcomesContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/career-outcomes-context``.\n\nPer-school aggregate showing 10-year earnings + top-N majors with\ncompact trajectory bands + peer-school cards. See ARCHITECTURE.md\n§\"Detail-page SEO sub-routes\" for the rendering contract on the\nconsuming Next.js page."},"CeleryTaskDefinition":{"properties":{"name":{"type":"string","title":"Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"}},"type":"object","required":["name","display_name","description","schedule"],"title":"CeleryTaskDefinition","description":"Definition of an available Celery task."},"ChatEvalCaseCreate":{"properties":{"case_slug":{"type":"string","maxLength":128,"minLength":1,"title":"Case Slug"},"message":{"type":"string","minLength":1,"title":"Message"},"min_response_chars":{"type":"integer","title":"Min Response Chars","default":100},"max_response_chars":{"type":"integer","title":"Max Response Chars","default":8000},"response_contains_any":{"items":{"type":"string"},"type":"array","title":"Response Contains Any","default":[]},"response_contains_all":{"items":{"type":"string"},"type":"array","title":"Response Contains All","default":[]},"response_excludes_all":{"items":{"type":"string"},"type":"array","title":"Response Excludes All","default":[]},"min_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Colleges"},"max_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Colleges"},"colleges_must_have_field":{"items":{"type":"string"},"type":"array","title":"Colleges Must Have Field","default":[]},"judge_rubric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Rubric"},"judge_min_score":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Judge Min Score","default":3},"judge_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Model"},"expect_tool_calls":{"items":{"$ref":"#/components/schemas/ToolCallExpectationIn"},"type":"array","title":"Expect Tool Calls","default":[]},"student_fixture":{"anyOf":[{"$ref":"#/components/schemas/StudentFixtureIn"},{"type":"null"}]},"expect_proposal":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Expect Proposal"},"enabled":{"type":"boolean","title":"Enabled","default":true},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["case_slug","message"],"title":"ChatEvalCaseCreate"},"ChatEvalCaseResultRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"case_id":{"type":"string","title":"Case Id"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"passed":{"type":"boolean","title":"Passed"},"layer1_passed":{"type":"boolean","title":"Layer1 Passed"},"judge_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Judge Score"},"judge_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Rationale"},"tool_assertions_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tool Assertions Passed"},"response_snapshot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Snapshot"},"tool_calls_snapshot":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tool Calls Snapshot"},"colleges_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Colleges Count"},"failure_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Detail"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","run_id","case_id","passed","layer1_passed","created_at"],"title":"ChatEvalCaseResultRow","description":"One case's result within a run."},"ChatEvalCaseRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"case_slug":{"type":"string","title":"Case Slug"},"message":{"type":"string","title":"Message"},"min_response_chars":{"type":"integer","title":"Min Response Chars"},"max_response_chars":{"type":"integer","title":"Max Response Chars"},"response_contains_any":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Contains Any"},"response_contains_all":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Contains All"},"response_excludes_all":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Excludes All"},"min_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Colleges"},"max_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Colleges"},"colleges_must_have_field":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colleges Must Have Field"},"judge_rubric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Rubric"},"judge_min_score":{"type":"integer","title":"Judge Min Score"},"judge_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Model"},"expect_tool_calls":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Expect Tool Calls"},"student_fixture":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Student Fixture"},"expect_proposal":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Expect Proposal"},"enabled":{"type":"boolean","title":"Enabled"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","case_slug","message","min_response_chars","max_response_chars","judge_min_score","enabled","created_at","updated_at"],"title":"ChatEvalCaseRow"},"ChatEvalCaseUpdate":{"properties":{"message":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Message"},"min_response_chars":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Response Chars"},"max_response_chars":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Response Chars"},"response_contains_any":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Contains Any"},"response_contains_all":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Contains All"},"response_excludes_all":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Response Excludes All"},"min_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Colleges"},"max_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Colleges"},"colleges_must_have_field":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colleges Must Have Field"},"judge_rubric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Rubric"},"judge_min_score":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Judge Min Score"},"judge_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judge Model"},"expect_tool_calls":{"anyOf":[{"items":{"$ref":"#/components/schemas/ToolCallExpectationIn"},"type":"array"},{"type":"null"}],"title":"Expect Tool Calls"},"student_fixture":{"anyOf":[{"$ref":"#/components/schemas/StudentFixtureIn"},{"type":"null"}]},"expect_proposal":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Expect Proposal"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"ChatEvalCaseUpdate","description":"All optional — PATCH semantics. Cross-field bounds are re-checked in the\nrouter against the merged row (a partial update can't see the other side)."},"ChatEvalRunDetail":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"status":{"type":"string","title":"Status"},"trigger":{"type":"string","title":"Trigger"},"git_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Git Sha"},"total_cases":{"type":"integer","title":"Total Cases"},"passed_cases":{"type":"integer","title":"Passed Cases"},"mean_judge_score":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mean Judge Score"},"total_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Total Cost Usd"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"cases":{"items":{"$ref":"#/components/schemas/ChatEvalCaseResultRow"},"type":"array","title":"Cases","default":[]}},"type":"object","required":["id","started_at","status","trigger","total_cases","passed_cases"],"title":"ChatEvalRunDetail","description":"Run summary + its per-case results (drill-down)."},"ChatEvalRunListResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ChatEvalRunRow"},"type":"array","title":"Rows"},"next_cursor":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["rows","count"],"title":"ChatEvalRunListResponse"},"ChatEvalRunRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"status":{"type":"string","title":"Status"},"trigger":{"type":"string","title":"Trigger"},"git_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Git Sha"},"total_cases":{"type":"integer","title":"Total Cases"},"passed_cases":{"type":"integer","title":"Passed Cases"},"mean_judge_score":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mean Judge Score"},"total_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Total Cost Usd"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["id","started_at","status","trigger","total_cases","passed_cases"],"title":"ChatEvalRunRow","description":"One run (list view — no per-case detail)."},"ChatMessage":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id"},"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"colleges":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Colleges"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."}},"type":"object","required":["role","content"],"title":"ChatMessage"},"ChatReportRequest":{"properties":{"reason":{"type":"string","enum":["inaccurate","inappropriate","harmful","dont_show_again","other","helpful"],"title":"Reason"},"details":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Details"}},"type":"object","required":["reason"],"title":"ChatReportRequest"},"ChatReportResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"report_id":{"type":"string","format":"uuid","title":"Report Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","report_id","message"],"title":"ChatReportResponse"},"ChatReportUpdateRequest":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"internal_notes":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Internal Notes"}},"type":"object","title":"ChatReportUpdateRequest","description":"Partial update: status, internal notes, or both.\n\nStatus values are validated against ``CHAT_REPORT_STATUSES`` in the router\nso the 400 carries the offending value (a ``Literal`` here would surface a\nless legible 422)."},"ChatRequest":{"properties":{"message":{"type":"string","maxLength":4000,"title":"Message"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"},"card_context":{"anyOf":[{"$ref":"#/components/schemas/CardContext"},{"type":"null"}]},"locale":{"type":"string","enum":["en","es"],"title":"Locale","default":"en"}},"type":"object","required":["message"],"title":"ChatRequest"},"ChatResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message":{"$ref":"#/components/schemas/ChatMessage"},"colleges":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Colleges"},"proposed_action":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proposed Action"},"page_link":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Page Link"},"suggested_followups":{"items":{"type":"string"},"type":"array","title":"Suggested Followups","default":[]}},"type":"object","required":["conversation_id","message"],"title":"ChatResponse"},"ChatSuggestionsResponse":{"properties":{"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"}},"type":"object","required":["suggestions"],"title":"ChatSuggestionsResponse","description":"Opening chips for a conversation with no turns yet."},"CitedClaim":{"properties":{"text":{"type":"string","maxLength":500,"minLength":1,"title":"Text"},"source_doc_ids":{"items":{"type":"string","format":"uuid"},"type":"array","minItems":1,"title":"Source Doc Ids"}},"type":"object","required":["text","source_doc_ids"],"title":"CitedClaim","description":"One claim with at least one supporting source-doc UUID.\n\nValidation happens post-LLM-call in ``validator.validate_citations`` —\nthe schema enforces shape (text + non-empty list) but not that the\nUUIDs map to docs in the input set; that check is post-hoc."},"CitySearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/LocationResponse"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"CitySearchResponse","description":"Response for city search/autocomplete."},"CoachCommunicationCreate":{"properties":{"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"coach_name":{"type":"string","maxLength":255,"title":"Coach Name"},"coach_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Coach Email"},"communication_type":{"type":"string","enum":["email","phone","visit","text","letter","camp"],"title":"Communication Type"},"communication_date":{"type":"string","format":"date-time","title":"Communication Date"},"direction":{"type":"string","enum":["inbound","outbound"],"title":"Direction","default":"outbound"},"subject":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Subject"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"follow_up_completed":{"type":"boolean","title":"Follow Up Completed","default":false}},"type":"object","required":["athletic_program_id","coach_name","communication_type","communication_date"],"title":"CoachCommunicationCreate"},"CoachCommunicationOut":{"properties":{"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"coach_name":{"type":"string","maxLength":255,"title":"Coach Name"},"coach_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Coach Email"},"communication_type":{"type":"string","enum":["email","phone","visit","text","letter","camp"],"title":"Communication Type"},"communication_date":{"type":"string","format":"date-time","title":"Communication Date"},"direction":{"type":"string","enum":["inbound","outbound"],"title":"Direction","default":"outbound"},"subject":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Subject"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"follow_up_completed":{"type":"boolean","title":"Follow Up Completed","default":false},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"college_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Name"},"sport_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Name"},"program_gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Gender"}},"type":"object","required":["athletic_program_id","coach_name","communication_type","communication_date","id","profile_id","created_at","updated_at"],"title":"CoachCommunicationOut"},"CoachCommunicationUpdate":{"properties":{"coach_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Coach Name"},"coach_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Coach Email"},"communication_type":{"anyOf":[{"type":"string","enum":["email","phone","visit","text","letter","camp"]},{"type":"null"}],"title":"Communication Type"},"communication_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Communication Date"},"direction":{"anyOf":[{"type":"string","enum":["inbound","outbound"]},{"type":"null"}],"title":"Direction"},"subject":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Subject"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"follow_up_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Follow Up Completed"}},"type":"object","title":"CoachCommunicationUpdate"},"CoachCoverage":{"properties":{"with_coaches":{"type":"integer","title":"With Coaches"},"without_coaches":{"type":"integer","title":"Without Coaches"},"pct":{"type":"number","title":"Pct"}},"type":"object","required":["with_coaches","without_coaches","pct"],"title":"CoachCoverage","description":"Coach-coverage breakdown for the athletics data quality report."},"CoachCreateBody":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"email":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"recruiting_coordinator":{"type":"boolean","title":"Recruiting Coordinator","default":false}},"type":"object","required":["name"],"title":"CoachCreateBody","description":"Admin-submitted body for adding a coach to an athletic program.\n\nLimited to the fields the curation UI surfaces. ``name`` is required and\nmust be non-blank after stripping surrounding whitespace."},"CoachCurateItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"recruiting_coordinator":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Recruiting Coordinator"},"active_overrides":{"items":{"$ref":"#/components/schemas/OverrideOut"},"type":"array","title":"Active Overrides"}},"type":"object","required":["id","name","title","email","phone","recruiting_coordinator"],"title":"CoachCurateItem"},"CoachCuratePanelResponse":{"properties":{"coach":{"$ref":"#/components/schemas/CoachCurateItem"},"program":{"$ref":"#/components/schemas/ProgramCurateSummary"},"active_overrides":{"items":{"$ref":"#/components/schemas/OverrideOut"},"type":"array","title":"Active Overrides"}},"type":"object","required":["coach","program","active_overrides"],"title":"CoachCuratePanelResponse","description":"Response for GET /admin/athletics/coaches/{id}/curate."},"CollegeAidComparison":{"properties":{"college_name":{"type":"string","title":"College Name"},"college_id":{"type":"string","title":"College Id"},"cost_of_attendance":{"type":"integer","title":"Cost Of Attendance"},"estimated_grants":{"type":"integer","title":"Estimated Grants"},"estimated_federal_loans":{"type":"integer","title":"Estimated Federal Loans"},"estimated_work_study":{"type":"integer","title":"Estimated Work Study"},"estimated_out_of_pocket":{"type":"integer","title":"Estimated Out Of Pocket"}},"type":"object","required":["college_name","college_id","cost_of_attendance","estimated_grants","estimated_federal_loans","estimated_work_study","estimated_out_of_pocket"],"title":"CollegeAidComparison"},"CollegeAthleticsCard":{"properties":{"college":{"$ref":"#/components/schemas/CollegeBasicInfo"},"programs":{"items":{"$ref":"#/components/schemas/AthleticProgramSummary"},"type":"array","title":"Programs"},"total_programs":{"type":"integer","title":"Total Programs"},"sports":{"items":{"type":"string"},"type":"array","title":"Sports"},"divisions":{"items":{"type":"string"},"type":"array","title":"Divisions"},"has_scholarships":{"type":"boolean","title":"Has Scholarships"}},"type":"object","required":["college","programs","total_programs","sports","divisions","has_scholarships"],"title":"CollegeAthleticsCard","description":"One card = one school with aggregated athletics data."},"CollegeAthleticsItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"athletics_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletics Url"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"has_athletic_programs":{"type":"boolean","title":"Has Athletic Programs"},"shared_host_with":{"items":{"type":"string"},"type":"array","title":"Shared Host With","default":[]}},"type":"object","required":["id","name","state","athletics_url","url","has_athletic_programs"],"title":"CollegeAthleticsItem"},"CollegeAthleticsListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CollegeAthleticsItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"CollegeAthleticsListResponse"},"CollegeAthleticsPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CollegeAthleticsCard"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["items","total","page","page_size"],"title":"CollegeAthleticsPage","description":"Paginated response for school-level athletics browse."},"CollegeBasicInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"operating_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operating Status"}},"type":"object","required":["id","name"],"title":"CollegeBasicInfo"},"CollegeCoverage":{"properties":{"total_colleges":{"type":"integer","title":"Total Colleges"},"with_athletics_url":{"type":"integer","title":"With Athletics Url"},"without_athletics_url":{"type":"integer","title":"Without Athletics Url"}},"type":"object","required":["total_colleges","with_athletics_url","without_athletics_url"],"title":"CollegeCoverage","description":"How many colleges have athletics URLs vs not."},"CollegeDetailOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"scorecard_id":{"type":"integer","title":"Scorecard Id"},"name":{"type":"string","title":"Name"},"alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alias"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"},"sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Avg"},"act_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Avg"},"undergraduate_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Undergraduate Size"},"tuition_in_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition In State"},"tuition_out_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition Out State"},"avg_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price"},"avg_net_price_0_30k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 0 30K"},"avg_net_price_30_48k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 30 48K"},"avg_net_price_48_75k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 48 75K"},"avg_net_price_75_110k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 75 110K"},"avg_net_price_110k_plus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 110K Plus"},"completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Rate"},"median_earnings_10yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings 10Yr"},"retention_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retention Rate"},"programs_offered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Programs Offered"},"other_programs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Programs"},"room_and_board":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Room And Board"},"is_hbcu":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hbcu"},"religious_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Religious Affiliation"},"student_faculty_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Student Faculty Ratio"},"pct_receiving_federal_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Federal Grant"},"pct_receiving_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Grant"},"pct_receiving_pell_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Pell Grant"},"avg_grant_aid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Grant Aid"},"avg_federal_loan":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Federal Loan"},"enrollment_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrollment Total"},"pct_women":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Women"},"pct_white":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct White"},"pct_black":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Black"},"pct_hispanic":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Hispanic"},"pct_asian":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Asian"},"institution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Institution Type"},"control":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Control"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"application_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Deadline"},"early_action_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Action Deadline"},"early_decision_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Decision Deadline"},"opeid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opeid"},"cohort_default_rate_3yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 3Yr"},"cohort_default_rate_2yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 2Yr"},"cdr_numerator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Numerator"},"cdr_denominator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Denominator"},"cdr_fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Fiscal Year"},"cdr_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cdr Last Updated"},"cdr_risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdr Risk Level"},"climate_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Climate Last Updated"},"crime_rate_per_1000":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Crime Rate Per 1000"},"safety_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safety Level"},"crime_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crime Last Updated"},"cds_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Url"},"cds_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Year"},"cds_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cds Last Updated"},"cds_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Status"},"total_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Applicants"},"total_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Admits"},"total_enrolled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Enrolled"},"early_decision_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Applicants"},"early_decision_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Admits"},"early_action_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Applicants"},"early_action_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Admits"},"wait_list_offered":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Offered"},"wait_list_accepted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Accepted"},"wait_list_admitted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Admitted"},"sat_erw_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 25Th"},"sat_erw_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 75Th"},"sat_math_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 25Th"},"sat_math_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 75Th"},"act_composite_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 25Th"},"act_composite_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 75Th"},"pct_freshmen_top_10_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 10 Hs"},"pct_freshmen_top_25_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 25 Hs"},"avg_hs_gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Hs Gpa"},"pct_classes_under_20":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes Under 20"},"pct_classes_20_29":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 20 29"},"pct_classes_30_39":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 30 39"},"pct_classes_40_49":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 40 49"},"pct_classes_50_99":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 50 99"},"pct_classes_100_plus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 100 Plus"},"admission_factors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Admission Factors"},"demonstrated_interest_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demonstrated Interest Level"},"visit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visit Url"},"transportation_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Transportation Data"},"transportation_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Transportation Last Updated"},"quality_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quality Scores"},"quality_scores_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Quality Scores Updated At"},"primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Color"},"secondary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary Color"},"google_place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Place Id"},"css_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Css Code"},"requires_css_profile_domestic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile Domestic"},"requires_css_profile_international":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile International"},"requires_css_noncustodial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Noncustodial"},"uses_idoc":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Uses Idoc"},"css_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Css Last Updated"},"operating_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operating Status"},"data_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data Updated At"},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating"},"review_count":{"type":"integer","title":"Review Count","default":0},"has_trends":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Trends"},"climate_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Climate Data"},"crime_stats":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Crime Stats"},"test_score_sources":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Test Score Sources"},"main_image":{"anyOf":[{"$ref":"#/components/schemas/CollegeMainImage"},{"type":"null"}]},"admissions_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admissions Url"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"published_subroutes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Published Subroutes"},"score_bands":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Bands","description":"CDS C9/C11 distributions with band edges joined (#525).\n\n``{group: [ScoreBand, ...]}`` ordered low → high, or None. Fractions\ndescribe ENROLLED freshmen. Lazy import keeps the schema module free\nof the service-layer import chain at load time.","readOnly":true}},"type":"object","required":["id","scorecard_id","name","score_bands"],"title":"CollegeDetailOut","description":"`GET /colleges/{id}` response — CollegeOut plus detail-only fields.\n\n`has_trends` (#571) rides ONLY here: list endpoints and the warm\n`colleges:all` cache keep serializing plain CollegeOut, per the\nARCHITECTURE.md §\"College Statistics History\" payload boundary. None\n(field absent upstream) means \"unknown\" — frontend gates default-show\non `!== false` so stale cached payloads keep today's behavior.\n`crime_stats` and `climate_data` (#1133) ride only here for the same reason."},"CollegeMainImage":{"properties":{"url":{"type":"string","title":"Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"credit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credit"},"license_short":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License Short"},"description_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Url"}},"type":"object","required":["url"],"title":"CollegeMainImage","description":"The college's Wikidata main image for the campus banner (#346).\n\nAttribution is mandatory where it renders (Wikimedia licenses):\n``credit`` and ``license_short``, linked to ``description_url``."},"CollegeOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"scorecard_id":{"type":"integer","title":"Scorecard Id"},"name":{"type":"string","title":"Name"},"alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alias"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"},"sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Avg"},"act_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Avg"},"undergraduate_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Undergraduate Size"},"tuition_in_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition In State"},"tuition_out_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition Out State"},"avg_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price"},"avg_net_price_0_30k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 0 30K"},"avg_net_price_30_48k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 30 48K"},"avg_net_price_48_75k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 48 75K"},"avg_net_price_75_110k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 75 110K"},"avg_net_price_110k_plus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 110K Plus"},"completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Rate"},"median_earnings_10yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings 10Yr"},"retention_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retention Rate"},"programs_offered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Programs Offered"},"other_programs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Programs"},"room_and_board":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Room And Board"},"is_hbcu":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hbcu"},"religious_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Religious Affiliation"},"student_faculty_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Student Faculty Ratio"},"pct_receiving_federal_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Federal Grant"},"pct_receiving_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Grant"},"pct_receiving_pell_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Pell Grant"},"avg_grant_aid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Grant Aid"},"avg_federal_loan":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Federal Loan"},"enrollment_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrollment Total"},"pct_women":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Women"},"pct_white":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct White"},"pct_black":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Black"},"pct_hispanic":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Hispanic"},"pct_asian":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Asian"},"institution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Institution Type"},"control":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Control"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"application_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Deadline"},"early_action_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Action Deadline"},"early_decision_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Decision Deadline"},"opeid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opeid"},"cohort_default_rate_3yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 3Yr"},"cohort_default_rate_2yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 2Yr"},"cdr_numerator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Numerator"},"cdr_denominator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Denominator"},"cdr_fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Fiscal Year"},"cdr_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cdr Last Updated"},"cdr_risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdr Risk Level"},"climate_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Climate Last Updated"},"crime_rate_per_1000":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Crime Rate Per 1000"},"safety_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safety Level"},"crime_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crime Last Updated"},"cds_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Url"},"cds_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Year"},"cds_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cds Last Updated"},"cds_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Status"},"total_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Applicants"},"total_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Admits"},"total_enrolled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Enrolled"},"early_decision_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Applicants"},"early_decision_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Admits"},"early_action_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Applicants"},"early_action_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Admits"},"wait_list_offered":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Offered"},"wait_list_accepted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Accepted"},"wait_list_admitted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Admitted"},"sat_erw_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 25Th"},"sat_erw_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 75Th"},"sat_math_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 25Th"},"sat_math_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 75Th"},"act_composite_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 25Th"},"act_composite_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 75Th"},"pct_freshmen_top_10_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 10 Hs"},"pct_freshmen_top_25_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 25 Hs"},"avg_hs_gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Hs Gpa"},"pct_classes_under_20":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes Under 20"},"pct_classes_20_29":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 20 29"},"pct_classes_30_39":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 30 39"},"pct_classes_40_49":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 40 49"},"pct_classes_50_99":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 50 99"},"pct_classes_100_plus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 100 Plus"},"admission_factors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Admission Factors"},"demonstrated_interest_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demonstrated Interest Level"},"visit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visit Url"},"transportation_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Transportation Data"},"transportation_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Transportation Last Updated"},"quality_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quality Scores"},"quality_scores_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Quality Scores Updated At"},"primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Color"},"secondary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary Color"},"google_place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Place Id"},"css_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Css Code"},"requires_css_profile_domestic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile Domestic"},"requires_css_profile_international":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile International"},"requires_css_noncustodial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Noncustodial"},"uses_idoc":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Uses Idoc"},"css_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Css Last Updated"},"operating_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operating Status"},"data_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data Updated At"},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating"},"review_count":{"type":"integer","title":"Review Count","default":0},"score_bands":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Bands","description":"CDS C9/C11 distributions with band edges joined (#525).\n\n``{group: [ScoreBand, ...]}`` ordered low → high, or None. Fractions\ndescribe ENROLLED freshmen. Lazy import keeps the schema module free\nof the service-layer import chain at load time.","readOnly":true}},"type":"object","required":["id","scorecard_id","name","score_bands"],"title":"CollegeOut"},"CollegeProgramWithProgram":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"program_id":{"type":"string","format":"uuid","title":"Program Id"},"id":{"type":"string","format":"uuid","title":"Id"},"credential_level":{"type":"string","title":"Credential Level","description":"Credential: certificate, associates or bachelors (#1138)","default":"bachelors"},"num_graduates":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Graduates","description":"Number of graduates/completions"},"median_earnings":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings","description":"Median earnings (long-term)"},"earnings_1yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings 1Yr","description":"Median earnings 1 year after graduation"},"earnings_highest_1yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings Highest 1Yr","description":"Highest credential 1-year earnings"},"completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Rate","description":"Program completion rate"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"program":{"$ref":"#/components/schemas/ProgramOut"}},"type":"object","required":["college_id","program_id","id","created_at","updated_at","program"],"title":"CollegeProgramWithProgram","description":"College-program association with full program details."},"CollegeSuggestion":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"matched_alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Alias"}},"type":"object","required":["id","name"],"title":"CollegeSuggestion","description":"Minimal row returned by ``GET /api/colleges/suggest`` for typeahead.\n\nKeep this schema intentionally lean — only the fields the dropdown actually renders.\nAdding more fields here defeats the purpose of having a suggest endpoint separate\nfrom the full ``/api/colleges`` list response."},"CollegeSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"state":{"type":"string","maxLength":2,"minLength":2,"title":"State","description":"2-letter state code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Price","description":"Average annual net price after aid (USD)"},"admission_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Admission Rate","description":"0.0-1.0 fraction of applicants admitted"},"earnings_for_major":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings For Major","description":"Median 10yr earnings for this college+major; None when no major in context"}},"type":"object","required":["id","name","state"],"title":"CollegeSummary","description":"Compact per-college payload for the programmatic list view.\n\nOnly fields the list template actually renders. Detail pages go through\n``/api/v1/colleges/{id}`` and render ``CollegeOut`` — not this schema.\n\n``earnings_for_major`` is populated only when a major is in page context\n(``best_colleges``, ``cheapest_colleges``, ``colleges_under``). For\n``athletics`` it is always ``None``."},"CollegeTier":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"tier":{"type":"string","enum":["safety","match","reach","far_reach","insufficient_data"],"title":"Tier"},"p_lo":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Lo"},"p_hi":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Hi"},"p_midpoint":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Midpoint"},"explanation":{"$ref":"#/components/schemas/TierExplanation"}},"type":"object","required":["college_id","tier","p_lo","p_hi","p_midpoint","explanation"],"title":"CollegeTier","description":"One college's tier + band + explanation."},"CollegeTiersRequest":{"properties":{"college_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200,"minItems":1,"title":"College Ids"}},"additionalProperties":false,"type":"object","required":["college_ids"],"title":"CollegeTiersRequest","description":"Body for ``POST /api/v1/colleges/tiers``.\n\nThe profile is resolved server-side from the caller's session (and the\noptional ``X-Profile-Id`` header), never sent in the body — a student's\nscores are not a request parameter someone can vary."},"CollegeTiersResponse":{"properties":{"tiers":{"items":{"$ref":"#/components/schemas/CollegeTier"},"type":"array","title":"Tiers"},"profile_has_signal":{"type":"boolean","title":"Profile Has Signal"},"model_version":{"type":"string","title":"Model Version"}},"type":"object","required":["tiers","profile_has_signal","model_version"],"title":"CollegeTiersResponse","description":"Response for ``POST /api/v1/colleges/tiers``.\n\n``profile_has_signal`` is False when the student has no test score and no\nGPA — the client renders the add-your-scores nudge rather than a chip.\nUnknown / unreadable college ids are simply absent from ``tiers``; a\npartial answer beats failing the whole grid over one stale id."},"CollegeWithProgramData":{"properties":{"college_id":{"type":"string","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"credential_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Level"},"num_graduates":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Graduates"},"number_of_graduates":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Graduates"},"median_earnings":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings"},"earnings_1yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Earnings 1Yr"}},"type":"object","required":["college_id","college_name"],"title":"CollegeWithProgramData","description":"College with program-specific outcome data."},"ComparisonProgram":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_name":{"type":"string","title":"College Name"},"college_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College City"},"college_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College State"},"sport_name":{"type":"string","title":"Sport Name"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"scholarships_available":{"type":"boolean","title":"Scholarships Available","default":false},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"max_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Scholarship Amount"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"avg_team_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Team Gpa"},"min_gpa_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa Requirement"},"min_sat_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat Requirement"},"min_act_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act Requirement"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"facilities_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facilities Rating"},"academic_progress_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Academic Progress Rate"}},"type":"object","required":["id","college_name","sport_name","gender"],"title":"ComparisonProgram","description":"Program data formatted for side-by-side comparison."},"ConfirmIn":{"properties":{"token":{"type":"string","maxLength":128,"minLength":1,"title":"Token"},"language":{"anyOf":[{"type":"string","enum":["en","es"]},{"type":"null"}],"title":"Language"}},"additionalProperties":false,"type":"object","required":["token"],"title":"ConfirmIn","description":"The confirm button. ``language``, when given, is the parent's own choice (#904)."},"ConfirmInfoOut":{"properties":{"valid":{"type":"boolean","title":"Valid"},"student_first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Student First Name"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories","default":[]},"language":{"type":"string","title":"Language","default":"en"}},"type":"object","required":["valid"],"title":"ConfirmInfoOut","description":"What the confirm page shows. ``valid`` is false for a used, expired or unknown link.\n\n``student_first_name`` is null when the profile has no name; the page says\n\"Your student\" in its own language."},"ConsumptionResponse":{"properties":{"queues":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Queues"},"last_capture":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Capture"},"heal":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Heal"},"unrouted_scan":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Unrouted Scan"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["queues","meta"],"title":"ConsumptionResponse","description":"Per-queue consumption verdicts (#568). ``state`` is one of\n``live | stalled | suspect | unknown``; ``unknown`` means a read was blind,\nnever that the queue is fine. ``last_capture`` points at the newest\nwedged-state capture (an ``audit_logs`` row, category ``consumption_watch``).\n\n``unrouted_scan`` is the #790 half and must be read before concluding\nanything from the *absence* of an unrouted queue: ``complete: false`` means\nthe sweep stopped short of the end of the broker keyspace, so a queue\nnothing consumes may exist beyond where it stopped. ``null`` means the scan\nwas not collected at all."},"ContentProvenanceOut":{"properties":{"v":{"type":"integer","title":"V","default":1},"ai_generated":{"type":"boolean","title":"Ai Generated","default":true},"digital_source_type":{"type":"string","title":"Digital Source Type"},"generator":{"type":"string","title":"Generator"},"content_kind":{"type":"string","title":"Content Kind"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"content":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Content","description":"SHA-256 of each field's NFC UTF-8 text, by field name."},"kid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kid","description":"Key id; see /.well-known/content-provenance.json."},"sig":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sig","description":"Ed25519 signature (base64url) over the canonical manifest."}},"additionalProperties":true,"type":"object","required":["digital_source_type","generator","content_kind"],"title":"ContentProvenanceOut"},"ConversationContextResponse":{"properties":{"context_string":{"type":"string","title":"Context String"},"summary":{"$ref":"#/components/schemas/ConversationContextSummary"}},"type":"object","required":["context_string","summary"],"title":"ConversationContextResponse","description":"Formatted context summary with structured preference grouping."},"ConversationContextSummary":{"properties":{"location_preferences":{"additionalProperties":{"type":"string"},"type":"object","title":"Location Preferences"},"academic_preferences":{"additionalProperties":{"type":"string"},"type":"object","title":"Academic Preferences"},"financial_preferences":{"additionalProperties":{"type":"string"},"type":"object","title":"Financial Preferences"},"other_preferences":{"additionalProperties":{"type":"string"},"type":"object","title":"Other Preferences"},"total_preferences":{"type":"integer","title":"Total Preferences","default":0}},"type":"object","title":"ConversationContextSummary","description":"Summary of all preferences for a conversation, grouped by category"},"ConversationOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"is_muted":{"type":"boolean","title":"Is Muted","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","title":"Messages","default":[]}},"type":"object","required":["id","created_at"],"title":"ConversationOut"},"ConversationPreferenceOut":{"properties":{"preference_key":{"type":"string","maxLength":100,"title":"Preference Key","description":"The preference key (e.g., 'preferred_location')"},"preference_value":{"type":"string","title":"Preference Value","description":"The preference value (e.g., 'California')"},"category":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Category","description":"Category: location, academic, financial, etc."},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence","description":"Confidence score (0.0 to 1.0)","default":1.0},"id":{"type":"string","format":"uuid","title":"Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"extracted_at":{"type":"string","format":"date-time","title":"Extracted At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["preference_key","preference_value","id","conversation_id","user_id","extracted_at","last_used_at"],"title":"ConversationPreferenceOut","description":"Schema for returning conversation preference data"},"CountResponse":{"properties":{"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"CountResponse","description":"Generic count response for collection-size endpoints."},"CreateSessionRequest":{"properties":{"tool_id":{"type":"string","title":"Tool Id","description":"Slug from TOOL_REGISTRY"},"bind":{"type":"boolean","title":"Bind","description":"#1056: also mint a write token. Every later write to the session (state, the tool's run, the lead form, the link) must then send it as X-Tool-Session-Token. Without it the session stays open, as before.","default":false}},"type":"object","required":["tool_id"],"title":"CreateSessionRequest"},"CreateSessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"tool_id":{"type":"string","title":"Tool Id"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"write_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Write Token","description":"Shown once, only when the request set `bind`; never readable again."}},"type":"object","required":["session_id","tool_id","expires_at"],"title":"CreateSessionResponse"},"CuratePanelResponse":{"properties":{"program":{"$ref":"#/components/schemas/ProgramCurateSummary"},"coaches":{"items":{"$ref":"#/components/schemas/CoachCurateItem"},"type":"array","title":"Coaches"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"active_overrides":{"items":{"$ref":"#/components/schemas/OverrideOut"},"type":"array","title":"Active Overrides"}},"type":"object","required":["program","coaches","evidence","active_overrides"],"title":"CuratePanelResponse","description":"Response for GET /admin/athletics/programs/{id}/curate."},"DataYearsOut":{"properties":{"scorecard":{"additionalProperties":{"type":"integer"},"type":"object","title":"Scorecard","description":"College Scorecard columns → year, recorded by the weekly Scorecard sync."},"ipeds":{"additionalProperties":{"type":"integer"},"type":"object","title":"Ipeds","description":"IPEDS columns → year, recorded by the weekly IPEDS pass."}},"type":"object","title":"DataYearsOut","description":"What year each source's figures are from, per ``colleges`` column.\n\nYears are the fall year of the academic year (2024 = 2024–25). A column\nwith no entry has no recorded year: either no sync has dated it yet, or it\nis a cohort measure (loan, completion, earnings), which is never dated."},"DeleteAccountRequest":{"properties":{"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"code":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Code"}},"type":"object","title":"DeleteAccountRequest"},"DeletionRequestResponse":{"properties":{"message":{"type":"string","title":"Message"},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled For"},"confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Confirmed"}},"type":"object","required":["message"],"title":"DeletionRequestResponse","description":"Response for account-deletion request, confirm, and cancel flows."},"DeletionTokenRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"DeletionTokenRequest"},"DetectRequest":{"properties":{"text":{"type":"string","maxLength":20000,"title":"Text"}},"type":"object","required":["text"],"title":"DetectRequest"},"DetectResponse":{"properties":{"match":{"type":"boolean","title":"Match"},"match_type":{"type":"string","enum":["exact","near","none"],"title":"Match Type"},"content_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Kind"},"generator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generator"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["match","match_type","content_kind","generator","generated_at"],"title":"DetectResponse"},"DeveloperProfileResponse":{"properties":{"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"app_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"key_count":{"type":"integer","title":"Key Count","default":0}},"type":"object","required":["email","role"],"title":"DeveloperProfileResponse"},"DeveloperRegisterRequest":{"properties":{"app_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"App Name"},"website":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Website"},"use_case":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Use Case"}},"type":"object","title":"DeveloperRegisterRequest","description":"Optional metadata supplied at developer registration time.\n\nAll fields are optional — submitting an empty body upgrades the user to\nthe developer role without recording any extra metadata. On re-register,\nomitted fields are left untouched (no clobbering with null)."},"DeviceRegisterRequest":{"properties":{"platform":{"type":"string","enum":["ios","android","web-push"],"title":"Platform"},"token":{"type":"string","maxLength":512,"minLength":8,"title":"Token"}},"type":"object","required":["platform","token"],"title":"DeviceRegisterRequest"},"DeviceTokenOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"platform":{"type":"string","title":"Platform"},"token_preview":{"type":"string","title":"Token Preview"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"}},"type":"object","required":["id","platform","token_preview","is_active","created_at","last_seen_at"],"title":"DeviceTokenOut"},"DistrictAggregateAnalytics":{"properties":{"district_id":{"type":"string","format":"uuid","title":"District Id"},"total_schools":{"type":"integer","title":"Total Schools"},"total_students":{"type":"integer","title":"Total Students"},"total_active_students_30d":{"type":"integer","title":"Total Active Students 30D"},"total_counselors":{"type":"integer","title":"Total Counselors"},"total_colleges_saved":{"type":"integer","title":"Total Colleges Saved"},"total_conversations":{"type":"integer","title":"Total Conversations"},"avg_profile_completion_rate":{"type":"number","title":"Avg Profile Completion Rate","description":"Student-weighted average of child schools' profile completion rates (0–100)."},"schools":{"items":{"$ref":"#/components/schemas/DistrictAggregateSchoolRow"},"type":"array","title":"Schools"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["district_id","total_schools","total_students","total_active_students_30d","total_counselors","total_colleges_saved","total_conversations","avg_profile_completion_rate","schools","generated_at"],"title":"DistrictAggregateAnalytics","description":"District-wide analytics rolled up across all child schools (#121).\n\nTotals are simple sums of the per-school overview values. Profile\ncompletion is a student-weighted average so districts with one large\nschool don't get distorted by smaller schools' rates."},"DistrictAggregateSchoolRow":{"properties":{"school_id":{"type":"string","format":"uuid","title":"School Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"overview":{"$ref":"#/components/schemas/OrgAnalyticsOverview"}},"type":"object","required":["school_id","name","slug","overview"],"title":"DistrictAggregateSchoolRow","description":"One row per child school in a district aggregate response."},"DistrictSummary":{"properties":{"leaid":{"type":"string","title":"Leaid"},"lea_name":{"type":"string","title":"Lea Name"},"state":{"type":"string","title":"State"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"school_count":{"type":"integer","title":"School Count"}},"type":"object","required":["leaid","lea_name","state","city","county","school_count"],"title":"DistrictSummary","description":"Summary of a school district."},"DoctorateField":{"properties":{"field":{"type":"string","title":"Field"},"recipients":{"type":"integer","minimum":0.0,"title":"Recipients"}},"type":"object","required":["field","recipients"],"title":"DoctorateField","description":"A field graduates earned research doctorates in (SED trend broad field)."},"DoctorateOrigins":{"properties":{"window_start":{"type":"integer","title":"Window Start"},"window_end":{"type":"integer","title":"Window End"},"bachelors_window_start":{"type":"integer","title":"Bachelors Window Start"},"bachelors_window_end":{"type":"integer","title":"Bachelors Window End"},"below_floor":{"type":"boolean","title":"Below Floor"},"recipients":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Recipients"},"rate_per_100":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Rate Per 100"},"national_rate_per_100":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"National Rate Per 100"},"top_fields":{"items":{"$ref":"#/components/schemas/DoctorateField"},"type":"array","title":"Top Fields"}},"type":"object","required":["window_start","window_end","bachelors_window_start","bachelors_window_end","below_floor"],"title":"DoctorateOrigins","description":"Graduates who went on to a research doctorate (#890), NCSES SED + IPEDS.\n\nResearch doctorates only (PhD, EdD and similar), no MD, JD or MBA.\n``below_floor`` means fewer than 10 in the window: no count, rate or fields\nare given. The rate divides doctorates earned in the window by bachelor's\ndegrees the college awarded in the window shifted back 8 years."},"DocumentCategory":{"type":"string","enum":["academic","athletic","financial","personal","portfolio","admissions","scholarship"],"title":"DocumentCategory","description":"Categories for organizing documents"},"DocumentStatistics":{"properties":{"total_documents":{"type":"integer","title":"Total Documents"},"documents_by_type":{"additionalProperties":true,"type":"object","title":"Documents By Type"},"documents_by_category":{"additionalProperties":true,"type":"object","title":"Documents By Category"},"total_storage_bytes":{"type":"integer","title":"Total Storage Bytes"},"most_sent_document":{"anyOf":[{"$ref":"#/components/schemas/ProfileDocumentResponse"},{"type":"null"}]}},"type":"object","required":["total_documents","documents_by_type","documents_by_category","total_storage_bytes"],"title":"DocumentStatistics","description":"Statistics for documents."},"DocumentType":{"type":"string","enum":["transcript","resume","essay","recommendation_letter","test_scores","athletic_video","portfolio_video","awards_certificate","financial_document","other"],"title":"DocumentType","description":"Types of documents students can upload"},"Driver":{"properties":{"input":{"type":"string","title":"Input"},"marginal_effect":{"type":"number","title":"Marginal Effect"},"direction":{"type":"string","enum":["increases","decreases","neutral"],"title":"Direction"}},"type":"object","required":["input","marginal_effect","direction"],"title":"Driver","description":"A single input dimension's marginal effect on ``p_midpoint``.\n\nUsed by the result page's lever section (\"raising your SAT 50 points\nmoves these schools the most\") and by ``levers()`` for cross-college\nranking."},"EmailPreferences":{"properties":{"announcements":{"type":"boolean","title":"Announcements"}},"additionalProperties":false,"type":"object","required":["announcements"],"title":"EmailPreferences"},"EmailTemplateCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"recipient_type":{"$ref":"#/components/schemas/OutreachRecipientType"},"subject":{"type":"string","maxLength":500,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":50000,"minLength":1,"title":"Body"},"category":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}]},"placeholders":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Placeholders"}},"type":"object","required":["name","recipient_type","subject","body"],"title":"EmailTemplateCreate","description":"Schema for creating an email template."},"EmailTemplateList":{"properties":{"templates":{"items":{"$ref":"#/components/schemas/EmailTemplateResponse"},"type":"array","title":"Templates"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["templates","total","page","page_size"],"title":"EmailTemplateList","description":"Schema for paginated template list."},"EmailTemplateResponse":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"recipient_type":{"$ref":"#/components/schemas/OutreachRecipientType"},"subject":{"type":"string","maxLength":500,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":50000,"minLength":1,"title":"Body"},"category":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}]},"placeholders":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Placeholders"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"},"is_system_template":{"type":"boolean","title":"Is System Template"},"is_active":{"type":"boolean","title":"Is Active"},"times_used":{"type":"integer","title":"Times Used"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["name","recipient_type","subject","body","id","is_system_template","is_active","times_used","created_at"],"title":"EmailTemplateResponse","description":"Schema for email template responses."},"EmailTemplateUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"recipient_type":{"anyOf":[{"$ref":"#/components/schemas/OutreachRecipientType"},{"type":"null"}]},"subject":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Subject"},"body":{"anyOf":[{"type":"string","maxLength":50000,"minLength":1},{"type":"null"}],"title":"Body"},"category":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}]},"placeholders":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Placeholders"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"EmailTemplateUpdate","description":"Schema for updating an email template."},"EnumerateItem":{"properties":{"loc":{"type":"string","pattern":"^/[A-Za-z0-9/_-]+$","title":"Loc","description":"Root-relative URL path (no scheme/domain)"},"lastmod":{"type":"string","format":"date-time","title":"Lastmod","description":"MAX(College.updated_at) across the URL's colleges"}},"type":"object","required":["loc","lastmod"],"title":"EnumerateItem","description":"One entry in the sitemap enumeration stream — a URL + its ``lastmod``.\n\n``loc`` is root-relative (no scheme/domain); the frontend sitemap\nprepends ``NEXT_PUBLIC_BASE_URL`` at render time, so the absolute\ncanonical is built in a single place. ``lastmod`` is the freshest\n``College.updated_at`` across the URL's query result — **not** the\napp deploy timestamp (ARCHITECTURE.md §\"Sitemap architecture\")."},"EnumerateResponse":{"properties":{"page_type":{"type":"string","title":"Page Type","description":"One of PageType.VALID_VALUES"},"urls":{"items":{"$ref":"#/components/schemas/EnumerateItem"},"type":"array","title":"Urls"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass back as after_slug|after_state; None = end of stream"}},"type":"object","required":["page_type"],"title":"EnumerateResponse","description":"Paginated sitemap enumeration payload.\n\nConsumed exclusively by ``frontend/src/app/sitemap.ts`` (SSR-only,\nno auth). Pagination is keyset-based: pass ``next_cursor`` back as\nthe ``after_slug`` / ``after_state`` query pair to fetch the next\npage. ``next_cursor`` is ``None`` once the stream is exhausted.\n\nCursor format is ``\"<after_slug>|<after_state>\"`` — the pair that\nfollows the last emitted row in the enumeration's sort order. The\nfrontend splits on ``|`` and rebuilds the next request; it does not\nparse the format otherwise."},"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail"}},"type":"object","required":["detail"],"title":"ErrorResponse","description":"Standard error response returned by all endpoints."},"EstimatedAidPackage":{"properties":{"pell_grant":{"type":"integer","title":"Pell Grant"},"institutional_grant":{"type":"integer","title":"Institutional Grant"},"work_study":{"type":"integer","title":"Work Study"},"federal_loans":{"type":"integer","title":"Federal Loans"},"total_aid":{"type":"integer","title":"Total Aid"}},"type":"object","required":["pell_grant","institutional_grant","work_study","federal_loans","total_aid"],"title":"EstimatedAidPackage"},"EventBatchIn":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventIn"},"type":"array","maxItems":100,"title":"Events","description":"Up to 100 events per request"}},"type":"object","required":["events"],"title":"EventBatchIn","description":"Batch of events for ingestion."},"EventBatchOut":{"properties":{"accepted":{"type":"integer","title":"Accepted","description":"Number of events successfully ingested"},"duplicates":{"type":"integer","title":"Duplicates","description":"Number of duplicate events skipped","default":0},"rejected":{"type":"integer","title":"Rejected","description":"Number of *events* (not distinct names) dropped for an event_name outside the allowed taxonomy. The rest of the batch is still ingested.","default":0},"rejected_names":{"items":{"type":"string"},"type":"array","title":"Rejected Names","description":"Distinct unknown names from this batch, repr()-quoted and truncated, at most 10. Echoes the caller's own input so a client can log what it got wrong."}},"type":"object","required":["accepted"],"title":"EventBatchOut","description":"Response from event ingestion."},"EventCommitmentCreate":{"properties":{"event_id":{"type":"string","format":"uuid","title":"Event Id"},"intent":{"anyOf":[{"type":"string","enum":["interested","registered"]},{"type":"null"}],"title":"Intent"}},"type":"object","required":["event_id"],"title":"EventCommitmentCreate"},"EventCommitmentOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Event Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"title":{"type":"string","title":"Title"},"event_type":{"type":"string","title":"Event Type"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"timezone_inferred":{"type":"boolean","title":"Timezone Inferred","default":false},"all_day":{"type":"boolean","title":"All Day","default":false},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"is_virtual":{"type":"boolean","title":"Is Virtual","default":false},"registration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Url"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"series_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series Key"},"intent":{"type":"string","enum":["interested","registered"],"title":"Intent"},"state":{"type":"string","enum":["listed","moved","no_longer_listed","past"],"title":"State"},"other_dates_available":{"type":"boolean","title":"Other Dates Available","default":false},"previous_starts_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Previous Starts At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","college_id","college_name","title","event_type","starts_at","intent","state"],"title":"EventCommitmentOut"},"EventCommitmentUpdate":{"properties":{"intent":{"type":"string","enum":["interested","registered"],"title":"Intent"}},"type":"object","required":["intent"],"title":"EventCommitmentUpdate"},"EventCommitmentsResponse":{"properties":{"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"can_change":{"type":"boolean","title":"Can Change","default":false},"rows":{"items":{"$ref":"#/components/schemas/EventCommitmentOut"},"type":"array","title":"Rows"}},"type":"object","required":["generated_at","rows"],"title":"EventCommitmentsResponse"},"EventIn":{"properties":{"event_id":{"type":"string","maxLength":36,"title":"Event Id","description":"Client-generated UUID for dedup"},"event_name":{"type":"string","maxLength":100,"title":"Event Name","description":"Event name from the allowed taxonomy. Names outside `ALLOWED_EVENTS` are dropped by the ingest endpoint and counted in the response — they never fail the batch (#674)."},"anonymous_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Anonymous Id","description":"Anonymous user identifier"},"session_id":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Session Id"},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Properties","description":"Event-specific data"},"page_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Page Url"},"referrer":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Referrer"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp","description":"Event timestamp; defaults to server time"}},"type":"object","required":["event_id","event_name"],"title":"EventIn","description":"Single event in an ingestion batch."},"FafsaStepOut":{"properties":{"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body"},"href":{"type":"string","title":"Href"}},"type":"object","required":["title","body","href"],"title":"FafsaStepOut"},"FafsaSummaryRead":{"properties":{"step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step"},"label":{"type":"string","title":"Label"},"verification":{"type":"string","enum":["none","selected","complete"],"title":"Verification"},"source":{"anyOf":[{"type":"string","enum":["org","student"]},{"type":"null"}],"title":"Source"}},"type":"object","required":["step","label","verification","source"],"title":"FafsaSummaryRead"},"FeatureFlagContext":{"properties":{"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","title":"FeatureFlagContext","description":"Optional evaluation context sent by the frontend client.\n\nThe client posts ``{\"context\": {...}}``; callers may include ``userId``\n(camelCase, as the frontend sends it) to get a per-user rollout decision."},"FeatureFlagResult":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"flag_key":{"type":"string","title":"Flag Key"}},"type":"object","required":["enabled","flag_key"],"title":"FeatureFlagResult","description":"Response for a single-flag evaluation. Matches the frontend client shape."},"FeedbackSubmission":{"properties":{"feedback_type":{"type":"string","enum":["bug","suggestion","data_correction","other"],"title":"Feedback Type","default":"other"},"message":{"type":"string","maxLength":5000,"minLength":1,"title":"Message"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"page_url":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Page Url"},"user_agent":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"User Agent"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"company_website":{"type":"string","title":"Company Website","default":""},"form_mounted_at_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Form Mounted At Ms"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["message"],"title":"FeedbackSubmission","description":"Public submission payload. Accepted authenticated and anonymous.\n\nDeliberately has **no** ``user_id``: the server derives it from the JWT so a\ncaller cannot attribute feedback to someone else. ``email`` is likewise\noverridden with the account address for authenticated callers."},"FeedbackSubmissionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"FeedbackSubmissionResponse"},"FeedbackUpdateRequest":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"internal_notes":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Internal Notes"}},"type":"object","title":"FeedbackUpdateRequest","description":"Partial update: status, internal notes, or both.\n\nStatus values are validated against ``FEEDBACK_STATUSES`` in the router so\nthe 400 carries the offending value (a ``Literal`` here would surface a\nless legible 422)."},"FlushRecommendationCacheRequest":{"properties":{"profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Profile Id"}},"type":"object","title":"FlushRecommendationCacheRequest","description":"Optional flush scope. Omit ``profile_id`` (or send ``null``) to flush\nevery profile's rankings; supply one to scope the flush to that profile.\n\nTyped as ``UUID`` so a malformed id is rejected with 422 rather than\nsilently no-op'ing against a ``rec:colleges:<garbage>:*`` pattern that\nmatches nothing but still reports success."},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"GrantAccessUpdate":{"properties":{"can_edit":{"type":"boolean","title":"Can Edit"},"can_view":{"type":"boolean","title":"Can View","default":true}},"type":"object","required":["can_edit"],"title":"GrantAccessUpdate","description":"An owner changing another account's access to their profile (#875)."},"GuestSessionCreateRequest":{"properties":{"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","title":"GuestSessionCreateRequest","description":"Mint request for an anonymous chat guest session (#509).\n\n``turnstile_token`` is required in environments where\n``TURNSTILE_SECRET_KEY`` is configured; dev/test skip verification."},"GuestSessionCreateResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"message_budget":{"type":"integer","title":"Message Budget"},"messages_used":{"type":"integer","title":"Messages Used"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["session_id","message_budget","messages_used"],"title":"GuestSessionCreateResponse"},"GuestSessionLinkResponse":{"properties":{"linked":{"type":"boolean","title":"Linked"},"session_id":{"type":"string","title":"Session Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"conversations_linked":{"type":"integer","title":"Conversations Linked"}},"type":"object","required":["linked","session_id","user_id","conversations_linked"],"title":"GuestSessionLinkResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service"},"git_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Git Sha"}},"type":"object","required":["status"],"title":"HealthResponse","description":"Standard health-check payload used by `/health` and `/api/health`."},"HubLink":{"properties":{"label":{"type":"string","maxLength":120,"title":"Label"},"url":{"type":"string","pattern":"^/[A-Za-z0-9/_-]+$","title":"Url"},"count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Count","description":"Optional badge count, e.g. '527 colleges'"}},"type":"object","required":["label","url"],"title":"HubLink","description":"One entry in a hub-page section — a visible link with optional count."},"HubPage":{"properties":{"page_type":{"type":"string","title":"Page Type","description":"One of HubType.VALID_VALUES"},"canonical_url":{"type":"string","pattern":"^/[A-Za-z0-9/_-]+$","title":"Canonical Url","description":"Root-relative canonical path"},"h1":{"type":"string","maxLength":200,"title":"H1"},"meta_title":{"type":"string","maxLength":60,"title":"Meta Title","description":"SERP title, without a brand suffix — the frontend title template appends one. Google truncates beyond ~60 chars."},"meta_description":{"type":"string","maxLength":160,"title":"Meta Description","description":"SERP snippet — Google truncates beyond ~160 chars"},"intro":{"type":"string","maxLength":400,"title":"Intro","description":"Hero paragraph; templated copy, never AI-generated"},"stats":{"additionalProperties":true,"type":"object","title":"Stats","description":"Hub-type-specific aggregate stats for the ribbon"},"sections":{"items":{"$ref":"#/components/schemas/HubSection"},"type":"array","title":"Sections"}},"type":"object","required":["page_type","canonical_url","h1","meta_title","meta_description","intro"],"title":"HubPage","description":"Envelope for the three programmatic hub pages (#202).\n\nFrontend renders whichever sections the backend returns; hub-type\nbranching lives in the service layer, not the schema. Adding a new\nhub means adding a ``HubType`` value plus a service function — no\nschema change."},"HubResponse":{"properties":{"tools":{"items":{"$ref":"#/components/schemas/ToolMetaOut"},"type":"array","title":"Tools"}},"type":"object","required":["tools"],"title":"HubResponse","description":"``GET /tools`` payload — list of registered tools."},"HubSection":{"properties":{"title":{"type":"string","maxLength":120,"title":"Title"},"subtitle":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Subtitle"},"links":{"items":{"$ref":"#/components/schemas/HubLink"},"type":"array","title":"Links"}},"type":"object","required":["title"],"title":"HubSection","description":"One section of a hub page — e.g. 'Top majors', 'Top states'."},"HydratedCitation":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"source_type":{"type":"string","title":"Source Type"},"license":{"type":"string","title":"License"}},"type":"object","required":["url","title","source_type","license"],"title":"HydratedCitation","description":"One source-doc reference hydrated into renderable metadata.\n\nKeyed in the response by ``source_doc_id`` (UUID); the synthesis row\nstores citations as UUID lists, and the frontend resolves them against\nthis map to render outbound links + license badges."},"ImproveSatContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff the college has SAT signal + admission_rate (the inputs the #377 predictor requires). Drives sitemap inclusion + noindex."},"admission_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Admission Rate"},"sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Avg"},"sat_25":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat 25"},"sat_75":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat 75"},"rows":{"items":{"$ref":"#/components/schemas/ImproveSatRow"},"type":"array","title":"Rows","description":"Counter-factual table rows — typically 5, one per hypothetical SAT anchor (25th, median, 75th, +100 stretch, 1600 ceiling). Empty when has_any_data is False."},"band_source":{"anyOf":[{"type":"string","enum":["scorecard","cds","ipeds"]},{"type":"null"}],"title":"Band Source","description":"Who supplied the band: College Scorecard, the school's Common Data Set, or the IPEDS admissions figures (#718). None when nothing recorded the writer; the page then names no single source."},"data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Year","description":"Year of the SAT band the anchors come from (2024 = 2024–25), from the source ``band_source`` names. None when none is recorded (#722, #718)."},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","has_any_data","sat_avg","sat_25","sat_75","last_retrieved_at"],"title":"ImproveSatContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/improve-sat-context``.\n\nCounter-factual SAT-improvement page — see ARCHITECTURE.md §\"Detail-page\nSEO sub-routes\" for the contract. The model uses #377's predict() per\nsynthetic profile; honesty contract enforced upstream."},"ImproveSatRow":{"properties":{"label":{"type":"string","title":"Label","description":"Human label like '25th percentile of enrolled freshmen' / 'Median' / 'Stretch goal (+100)' / '1600 (ceiling)'."},"sat_score":{"type":"integer","maximum":1600.0,"minimum":400.0,"title":"Sat Score"},"p_lo":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Lo"},"p_midpoint":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Midpoint"},"p_hi":{"type":"number","maximum":1.0,"minimum":0.0,"title":"P Hi"},"tier":{"type":"string","enum":["safety","match","reach","far_reach","insufficient_data"],"title":"Tier"}},"type":"object","required":["label","sat_score","p_lo","p_midpoint","p_hi","tier"],"title":"ImproveSatRow","description":"One row in the counter-factual SAT-improvement table.\n\nEach row represents a hypothetical SAT score the student could achieve\nand the predicted admit-probability band for that score against the\ntarget college. Predictions come from the #377 admissions-chance model\ninvoked server-side at SSR time."},"InboundEmailWebhookResponse":{"properties":{"status":{"type":"string","title":"Status"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"matched_activity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Activity Id"},"reply_activity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Activity Id"}},"type":"object","required":["status"],"title":"InboundEmailWebhookResponse","description":"Mailjet webhook acknowledgement payload returned by `/api/webhooks/inbound-email`."},"IndexationImportResponse":{"properties":{"rows_upserted":{"type":"integer","title":"Rows Upserted","description":"Per-type rows + aggregate rows written or updated."},"dates_touched":{"items":{"type":"string","format":"date"},"type":"array","title":"Dates Touched"}},"type":"object","required":["rows_upserted","dates_touched"],"title":"IndexationImportResponse","description":"Response after a manual CSV upload."},"IndexationPollResponse":{"properties":{"status":{"type":"string","enum":["success","skipped","error"],"title":"Status"},"target_date":{"type":"string","format":"date","title":"Target Date"},"rows_written":{"type":"integer","title":"Rows Written","default":0},"days_processed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Processed"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["status","target_date"],"title":"IndexationPollResponse","description":"Response from a manual GSC poll trigger."},"IndexationTrendResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/IndexationTrendRow"},"type":"array","title":"Rows"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"}},"type":"object","required":["rows","since","until"],"title":"IndexationTrendResponse","description":"Time-series response for the trends endpoint."},"IndexationTrendRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"page_type":{"type":"string","enum":["best_colleges","cheapest_colleges","colleges_under","athletics","college_detail","article","all"],"title":"Page Type"},"indexed_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Indexed Count"},"impressions":{"type":"integer","title":"Impressions","default":0},"clicks":{"type":"integer","title":"Clicks","default":0},"avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Position"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["metric_date","page_type"],"title":"IndexationTrendRow","description":"One (date, page_type) row for the trends time-series."},"InvitationAccept":{"properties":{"parent_access":{"type":"string","enum":["edit","view","none"],"title":"Parent Access","default":"view"}},"type":"object","title":"InvitationAccept","description":"Body of the accept route (optional). Only a handover reads it (#875):\nwhat the student lets the parent keep. Private to the student."},"InviterInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["id","email"],"title":"InviterInfo","description":"Schema for inviter basic information."},"ItineraryCreateRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name","default":"My visit plan"},"college_ids":{"items":{"type":"string"},"type":"array","title":"College Ids"},"start_location_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Start Location Name"},"start_lat":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Start Lat"},"start_lng":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Start Lng"},"max_drive_hours_per_day":{"anyOf":[{"type":"integer","maximum":16.0,"minimum":1.0},{"type":"null"}],"title":"Max Drive Hours Per Day"},"return_to_start":{"type":"boolean","title":"Return To Start","default":false}},"type":"object","title":"ItineraryCreateRequest"},"ItineraryOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"start_location_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Location Name"},"start_lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Start Lat"},"start_lng":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Start Lng"},"max_drive_hours_per_day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Drive Hours Per Day"},"return_to_start":{"type":"boolean","title":"Return To Start"},"route_stale":{"type":"boolean","title":"Route Stale"},"total_distance_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Distance Miles"},"total_drive_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Drive Minutes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"stops":{"items":{"$ref":"#/components/schemas/ItineraryStopOut"},"type":"array","title":"Stops"}},"type":"object","required":["id","name","return_to_start","route_stale","created_at","updated_at","stops"],"title":"ItineraryOut"},"ItineraryStopOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"position":{"type":"integer","title":"Position"},"day_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Day Index"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"leg_distance_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Leg Distance Miles"},"leg_drive_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Leg Drive Minutes"},"college":{"$ref":"#/components/schemas/StopCollegeOut"},"fit_blurb":{"type":"string","title":"Fit Blurb"},"fit_highlights":{"items":{"type":"string"},"type":"array","title":"Fit Highlights"}},"type":"object","required":["id","college_id","position","college","fit_blurb","fit_highlights"],"title":"ItineraryStopOut"},"ItinerarySummaryOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"stop_count":{"type":"integer","title":"Stop Count"},"college_names":{"items":{"type":"string"},"type":"array","title":"College Names"},"total_distance_miles":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Distance Miles"},"total_drive_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Drive Minutes"},"route_stale":{"type":"boolean","title":"Route Stale"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","stop_count","college_names","route_stale","created_at","updated_at"],"title":"ItinerarySummaryOut"},"ItineraryUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Name"},"start_location_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Start Location Name"},"start_lat":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Start Lat"},"start_lng":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Start Lng"},"max_drive_hours_per_day":{"anyOf":[{"type":"integer","maximum":16.0,"minimum":1.0},{"type":"null"}],"title":"Max Drive Hours Per Day"},"return_to_start":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return To Start"}},"type":"object","title":"ItineraryUpdateRequest"},"JoinCodePublicRead":{"properties":{"organization_name":{"type":"string","title":"Organization Name"},"organization_type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Organization Type"},"organization_verified":{"type":"boolean","title":"Organization Verified"}},"type":"object","required":["organization_name","organization_type","organization_verified"],"title":"JoinCodePublicRead","description":"``GET /join/{code}``: the organization's name, type and whether a\nplatform admin has checked it (#979), nothing else."},"JoinRequest":{"properties":{"code":{"type":"string","maxLength":32,"minLength":1,"title":"Code"},"share":{"type":"boolean","title":"Share"}},"type":"object","required":["code","share"],"title":"JoinRequest"},"JoinResponse":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"organization_name":{"type":"string","title":"Organization Name"},"shared":{"type":"boolean","title":"Shared"}},"type":"object","required":["organization_id","organization_name","shared"],"title":"JoinResponse"},"LastRunStartResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"task_name":{"type":"string","title":"Task Name"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"kwargs":{"additionalProperties":true,"type":"object","title":"Kwargs"},"started_status":{"type":"string","title":"Started Status"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"finished_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finished Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"run_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Kind"}},"type":"object","required":["task_id","task_name","started_at","kwargs","started_status"],"title":"LastRunStartResponse","description":"Most recent run of a long-running Celery task.\n\nJoins the started row (``status=\"in_progress\"``) and the matching terminal\nrow (``status IN (\"success\",\"error\",\"failure\")``) by ``resource_id`` so a\ncaller can prefill resume parameters from the started_at of a failed run\neven when the worker was SIGKILLed before the terminal row landed."},"LeadSubmission":{"properties":{"name":{"type":"string","maxLength":255,"title":"Name"},"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"message":{"type":"string","maxLength":2000,"title":"Message"},"company_website":{"type":"string","maxLength":500,"title":"Company Website","default":""},"form_mounted_at_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Form Mounted At Ms"},"turnstile_token":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Turnstile Token"},"source_page":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Source Page"},"attribution":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attribution"}},"type":"object","required":["name","email","message"],"title":"LeadSubmission"},"LeadSubmissionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"LeadSubmissionResponse"},"LeverRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"extra_scholarship_per_year":{"type":"integer","maximum":50000.0,"minimum":0.0,"title":"Extra Scholarship Per Year","default":0},"in_state_overrides":{"additionalProperties":{"type":"boolean"},"type":"object","title":"In State Overrides"}},"additionalProperties":false,"type":"object","required":["session_id"],"title":"LeverRequest","description":"Body for ``POST /api/v1/tools/life-path/levers``.\n\nReplays the prior estimate with one or more lever values overridden.\nThe prior profile is read from the session's ``step_state`` — the\nfrontend never resends the full form.\n\n``extra_scholarship_per_year`` is in whole dollars; the result page\nslider snaps to $500 steps.\n\n``in_state_overrides`` maps ``college_id`` (as string for JSON\nportability) → bool. ``True`` forces the college to be treated as\nin-state regardless of ``profile.state_of_residence``; ``False``\nforces out-of-state; omitting a college_id falls back to the\nauto-detected value."},"LifePathEstimateRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"profile":{"$ref":"#/components/schemas/LifePathInput"}},"additionalProperties":false,"type":"object","required":["session_id","profile"],"title":"LifePathEstimateRequest","description":"Body for ``POST /api/v1/tools/life-path/estimate``.\n\nPairs a pre-minted ``session_id`` with the form profile. The session\nmust already exist (minted via ``POST /tools/sessions``) and belong\nto the ``life-path`` tool — matches the chassis convention used by\nnet-price and admissions-chance."},"LifePathInput":{"properties":{"college_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":3,"minItems":1,"title":"College Ids"},"intended_major":{"type":"string","maxLength":255,"minLength":1,"title":"Intended Major"},"household_income_range":{"type":"string","enum":["under-30k","30k-60k","60k-100k","100k-150k","150k-250k","over-250k"],"title":"Household Income Range"},"state_of_residence":{"type":"string","maxLength":2,"minLength":2,"title":"State Of Residence"},"gpa_range":{"type":"string","enum":["under-2.5","2.5-3.0","3.0-3.5","3.5-3.8","3.8-plus"],"title":"Gpa Range"},"dependents":{"type":"integer","maximum":10.0,"minimum":0.0,"title":"Dependents","default":0}},"additionalProperties":false,"type":"object","required":["college_ids","intended_major","household_income_range","state_of_residence","gpa_range"],"title":"LifePathInput","description":"Inputs collected from the life-path tool form.\n\nValidation rules:\n\n1. ``college_ids`` is 1–3 items (the form scales via \"Add another\n   college\" affordance per plan §\"Decisions locked\").\n2. ``state_of_residence`` is uppercased on ingest.\n3. ``intended_major`` is free text; fuzzy-matched to program titles\n   at service-call time via the same ``FuzzyMatcher.match_major``\n   primitive used by ``app.services.tools.net_price``.\n4. ``household_income_range`` maps to dollars via the shared\n   ``INCOME_BRACKETS`` lookup in ``app.services.tools.net_price``\n   (re-used, not duplicated).\n5. ``dependents`` defaults to 0; the SAI calculator treats family\n   size as ``dependents + 2`` (two parents + the student is one of\n   the dependents — see ``net_price.py`` Open Question #3)."},"LifePathPrediction":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"program_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Program Id"},"yearly_projections":{"items":{"$ref":"#/components/schemas/YearProjection"},"type":"array","maxItems":10,"minItems":10,"title":"Yearly Projections"},"break_even_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Break Even Year"},"statistical":{"$ref":"#/components/schemas/app__schemas__life_path__UncertaintyComponent"},"out_of_model":{"$ref":"#/components/schemas/app__schemas__life_path__UncertaintyComponent"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"additionalProperties":false,"type":"object","required":["college_id","program_id","yearly_projections","break_even_year","statistical","out_of_model"],"title":"LifePathPrediction","description":"Per-college 10-year trajectory envelope.\n\n``program_id`` is None when the visitor's intended major can't be\nmatched to any program offered by this college; in that case the\nmath service falls back to the college-wide\n``median_earnings_10yr`` field as the Y1 earnings anchor and the\n``notes`` list documents the fallback.\n\n``break_even_year`` is the first post-grad year where cumulative\npost-grad earnings overtake the gross college bill (sum of\n``net_price`` during the four in-school years) — the \"was the\ndegree worth it?\" signal per the feature spec doc. ``None`` when\nbreak-even doesn't occur within the 10-year window. Note this is\ndifferent from ``cumulative_net`` (per-year cash-flow position\nincluding loan payments): the bands chart and the break-even\nthreshold answer two different user questions, and we surface\nboth honestly.\n\n``statistical`` and ``out_of_model`` describe the per-metric\nband-composition methodology applied uniformly across the\n``yearly_projections`` rows; the methodology page renders both\ndescriptions to explain the band shape to visitors."},"LifePathResult":{"properties":{"session_id":{"type":"string","title":"Session Id"},"predictions":{"items":{"$ref":"#/components/schemas/LifePathPrediction"},"type":"array","title":"Predictions"},"out_of_model_summary":{"items":{"type":"string"},"type":"array","title":"Out Of Model Summary"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"additionalProperties":false,"type":"object","required":["session_id","predictions","out_of_model_summary"],"title":"LifePathResult","description":"Response envelope for both ``/estimate`` and ``/levers``.\n\nPer ``ARCHITECTURE.md`` §\"Prediction Tools\" — every per-college\ntrajectory survives the wire intact; the result page reads it\nas-is. Predictions are returned in **input order** (the visitor\nchose these colleges; they have an existing mental model — no\nserver-side resort)."},"LinkUserResponse":{"properties":{"linked":{"type":"boolean","title":"Linked","default":true},"session_id":{"type":"string","title":"Session Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"profile_fields_filled":{"items":{"type":"string"},"type":"array","title":"Profile Fields Filled"},"colleges_saved":{"type":"integer","title":"Colleges Saved","default":0}},"type":"object","required":["session_id","user_id"],"title":"LinkUserResponse"},"LlmUsageDailyResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/LlmUsageDailyRow"},"type":"array","title":"Rows"},"totals":{"$ref":"#/components/schemas/LlmUsageTotals"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"},"coverage_note":{"type":"string","title":"Coverage Note"}},"type":"object","required":["rows","totals","since","until","coverage_note"],"title":"LlmUsageDailyResponse","description":"Range-filtered daily LLM usage, newest date first.\n\n``coverage_note`` is returned inline rather than left to documentation\nbecause the omissions are load-bearing when reading these numbers: chat and\nsynthesis spend is real but lives in other tables, so a reader who takes\n``totals`` as all-LLM-spend would undercount."},"LlmUsageDailyRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"provider":{"type":"string","title":"Provider"},"model":{"type":"string","title":"Model"},"workload":{"type":"string","title":"Workload"},"call_count":{"type":"integer","title":"Call Count"},"tokens_in_total":{"type":"integer","title":"Tokens In Total"},"tokens_out_total":{"type":"integer","title":"Tokens Out Total"},"cached_tokens_total":{"type":"integer","title":"Cached Tokens Total"},"cost_usd_total":{"type":"string","title":"Cost Usd Total"},"expected_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Cost Usd"}},"type":"object","required":["metric_date","provider","model","workload","call_count","tokens_in_total","tokens_out_total","cached_tokens_total","cost_usd_total"],"title":"LlmUsageDailyRow","description":"One row from ``metrics_llm_usage_daily``, plus a derived audit field.\n\n``cost_usd_total`` is what was **recorded** at flush time, using whatever\npricing table was deployed then. ``expected_cost_usd`` re-prices the row's\nown token counts against the pricing table as it stands **now**. They agree\nunless the row was written under different rates — which is exactly the\ncondition that went undetected for months when Haiku 4.5 sat 4× below its\npublished price. A divergence is the signal; the numbers alone never were.\n\n``expected_cost_usd`` is ``None`` when the model has no pricing row, which\nis itself worth surfacing — an unpriced model records ``cost_usd_total = 0``\nand would otherwise look free."},"LlmUsageTotals":{"properties":{"call_count":{"type":"integer","title":"Call Count"},"tokens_in_total":{"type":"integer","title":"Tokens In Total"},"tokens_out_total":{"type":"integer","title":"Tokens Out Total"},"cached_tokens_total":{"type":"integer","title":"Cached Tokens Total"},"cost_usd_total":{"type":"string","title":"Cost Usd Total"},"expected_cost_usd_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Cost Usd Total"}},"type":"object","required":["call_count","tokens_in_total","tokens_out_total","cached_tokens_total","cost_usd_total"],"title":"LlmUsageTotals","description":"Window totals, so a caller doesn't have to sum the rows client-side."},"LocationResponse":{"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"}},"type":"object","title":"LocationResponse","description":"Location information response."},"LocationsHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"features":{"items":{"type":"string"},"type":"array","title":"Features"}},"type":"object","required":["status","service","features"],"title":"LocationsHealthResponse"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"MajorOutcomeRow":{"properties":{"cip_code":{"type":"string","title":"Cip Code"},"program_slug":{"type":"string","title":"Program Slug"},"program_id":{"type":"string","format":"uuid","title":"Program Id"},"program_title":{"type":"string","title":"Program Title"},"num_graduates":{"type":"integer","minimum":30.0,"title":"Num Graduates"},"median_earnings":{"type":"integer","minimum":0.0,"title":"Median Earnings"},"in_state_share_1yr":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"In State Share 1Yr","description":"Of graduates working and not enrolled 1 year after completing, the share employed in the college's state (Scorecard EARN_IN_STATE_1YR / EARN_COUNT_WNE_1YR, #888). None when suppressed or the base is under 30."},"higher_credential_share_5yr":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Higher Credential Share 5Yr","description":"Of graduates working and not enrolled 5 years after completing, the share who had earned a higher credential (Scorecard EARN_COUNT_HIGH_CRED_5YR / EARN_COUNT_WNE_5YR, #888). Anyone still enrolled is outside the base, so this is not a graduate school rate. None when suppressed or the base is under 30."},"trajectory":{"items":{"$ref":"#/components/schemas/TrajectoryBand"},"type":"array","maxItems":10,"minItems":10,"title":"Trajectory"}},"type":"object","required":["cip_code","program_slug","program_id","program_title","num_graduates","median_earnings","trajectory"],"title":"MajorOutcomeRow","description":"One row in the top-N majors table on /colleges/[id]/career-outcomes."},"MatchScoreComponent":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"explanation":{"type":"string","title":"Explanation"},"share":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Share","description":"This group's share of the score"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score","description":"Weighted fit within the group"}},"type":"object","required":["key","label","explanation","share","score"],"title":"MatchScoreComponent","description":"One group behind a match score (ARCHITECTURE.md §\"Composite scores\")."},"MediaCollegeDetail":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"rows":{"items":{"$ref":"#/components/schemas/MediaRow"},"type":"array","title":"Rows"}},"type":"object","required":["college_id","college_name","rows"],"title":"MediaCollegeDetail"},"MediaCollegeListResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/MediaCollegeSummary"},"type":"array","title":"Rows"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["rows","total","page","page_size","total_pages"],"title":"MediaCollegeListResponse"},"MediaCollegeSummary":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"photo_count":{"type":"integer","title":"Photo Count"},"virtual_tour_count":{"type":"integer","title":"Virtual Tour Count"},"licenses":{"items":{"type":"string"},"type":"array","title":"Licenses"},"latest_derived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Derived At"}},"type":"object","required":["college_id","college_name","photo_count","virtual_tour_count","licenses","latest_derived_at"],"title":"MediaCollegeSummary","description":"One row in the admin media list — per-college aggregate counts."},"MediaDailyResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/MediaDailyRow"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"MediaDailyResponse"},"MediaDailyRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"colleges_processed":{"type":"integer","title":"Colleges Processed"},"media_rows_created":{"type":"integer","title":"Media Rows Created"},"media_rows_skipped":{"type":"integer","title":"Media Rows Skipped"},"colleges_failed":{"type":"integer","title":"Colleges Failed"}},"type":"object","required":["metric_date","colleges_processed","media_rows_created","media_rows_skipped","colleges_failed"],"title":"MediaDailyRow","description":"One row from metrics_media_daily."},"MediaRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"media_type":{"type":"string","title":"Media Type"},"url":{"type":"string","title":"Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"credit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credit"},"license":{"type":"string","title":"License"},"source_document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Document Id"},"ordering":{"type":"integer","title":"Ordering"},"projected_at_version":{"type":"integer","title":"Projected At Version"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","media_type","url","thumbnail_url","caption","credit","license","source_document_id","ordering","projected_at_version","created_at","updated_at"],"title":"MediaRow","description":"One media row in admin detail view. Includes provenance details\npublic surface omits (source_document_id, projected_at_version)."},"MeritScholarshipListResponse":{"properties":{"scholarships":{"items":{"$ref":"#/components/schemas/MeritScholarshipWithCollege"},"type":"array","title":"Scholarships"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["scholarships","total","page","page_size"],"title":"MeritScholarshipListResponse","description":"Paginated list of merit scholarships with college info."},"MeritScholarshipResponse":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"amount_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Min"},"amount_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Max"},"amount_type":{"type":"string","title":"Amount Type","default":"annual"},"renewable_years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Renewable Years"},"min_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa"},"min_sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat"},"min_act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act"},"state_residency_required":{"type":"boolean","title":"State Residency Required","default":false},"required_states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Required States"},"eligibility_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eligibility Notes"},"renewal_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Gpa"},"renewal_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Notes"},"automatic_consideration":{"type":"boolean","title":"Automatic Consideration","default":true},"application_required":{"type":"boolean","title":"Application Required","default":false},"separate_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Separate Deadline"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"source":{"type":"string","title":"Source","default":"manual"},"verified":{"type":"boolean","title":"Verified","default":false},"is_active":{"type":"boolean","title":"Is Active","default":true},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"application_effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Effort"},"data_quality_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Quality Score"},"augmentation_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Augmentation Notes"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"last_updated":{"type":"string","format":"date-time","title":"Last Updated"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"},"link_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Kind"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."},"gpa_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa Min","description":"Alias for min_gpa, converted to float for numeric comparison.","readOnly":true},"sat_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Min","description":"Alias for min_sat.","readOnly":true},"act_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Min","description":"Alias for min_act.","readOnly":true},"is_renewable":{"type":"boolean","title":"Is Renewable","description":"Computed field: scholarship is renewable if renewable_years > 0.","readOnly":true}},"type":"object","required":["name","id","college_id","last_updated","created_at","gpa_min","sat_min","act_min","is_renewable"],"title":"MeritScholarshipResponse","description":"Schema for merit scholarship responses.\n\nThe base's bounds check what an admin or an import *writes*. Returned as\nthey're stored: one scraped row with ``renewable_years = 10`` used to fail\nthe ``le=8`` bound here and 500 the whole search page (#820). So the\nbounded fields are re-declared without bounds for output."},"MeritScholarshipWithCollege":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"amount_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Min"},"amount_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Max"},"amount_type":{"type":"string","title":"Amount Type","default":"annual"},"renewable_years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Renewable Years"},"min_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Gpa"},"min_sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat"},"min_act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act"},"state_residency_required":{"type":"boolean","title":"State Residency Required","default":false},"required_states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Required States"},"eligibility_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eligibility Notes"},"renewal_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Gpa"},"renewal_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renewal Notes"},"automatic_consideration":{"type":"boolean","title":"Automatic Consideration","default":true},"application_required":{"type":"boolean","title":"Application Required","default":false},"separate_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Separate Deadline"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"source":{"type":"string","title":"Source","default":"manual"},"verified":{"type":"boolean","title":"Verified","default":false},"is_active":{"type":"boolean","title":"Is Active","default":true},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"application_effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Effort"},"data_quality_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Quality Score"},"augmentation_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Augmentation Notes"},"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"last_updated":{"type":"string","format":"date-time","title":"Last Updated"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"},"link_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Kind"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."},"college_name":{"type":"string","title":"College Name"},"college_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College State"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"gpa_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa Min","description":"Alias for min_gpa, converted to float for numeric comparison.","readOnly":true},"sat_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Min","description":"Alias for min_sat.","readOnly":true},"act_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Min","description":"Alias for min_act.","readOnly":true},"is_renewable":{"type":"boolean","title":"Is Renewable","description":"Computed field: scholarship is renewable if renewable_years > 0.","readOnly":true}},"type":"object","required":["name","id","college_id","last_updated","created_at","college_name","college_state","gpa_min","sat_min","act_min","is_renewable"],"title":"MeritScholarshipWithCollege","description":"Schema for merit scholarship with college information."},"MessageResponse":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageResponse","description":"Generic single-message response (e.g., status acknowledgements)."},"MetricBand":{"properties":{"lo":{"type":"number","title":"Lo"},"hi":{"type":"number","title":"Hi"},"midpoint":{"type":"number","title":"Midpoint"},"unit":{"type":"string","title":"Unit","default":"$"}},"additionalProperties":false,"type":"object","required":["lo","hi","midpoint"],"title":"MetricBand","description":"One metric's confidence band for one year.\n\n``lo`` ≤ ``midpoint`` ≤ ``hi`` is a service-layer invariant; the\nschema does NOT enforce it because the math service is the\nauthoritative source. A test catches violations.\n\n``unit`` is a free-form label rendered by the result page tooltip\n(``\"$\"``, ``\"%\"``, ``\"years\"``). Cross-tool consistency: the\nmethodology page reads it verbatim."},"MfaChallengeRequest":{"properties":{"challenge_token":{"type":"string","maxLength":128,"title":"Challenge Token"},"code":{"type":"string","maxLength":64,"title":"Code"}},"type":"object","required":["challenge_token","code"],"title":"MfaChallengeRequest"},"MfaChallengeRequired":{"properties":{"mfa_required":{"type":"boolean","title":"Mfa Required","default":true},"challenge_token":{"type":"string","title":"Challenge Token"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["challenge_token","expires_in"],"title":"MfaChallengeRequired","description":"Returned by the password login routes when the account has MFA on.\n\nDeliberately a 200 with a different body rather than a 401: the password\n*was* correct, and a 401 here would trip the frontend's global\nstale-token auto-logout. The client narrows on ``mfa_required``."},"MfaCodeRequest":{"properties":{"code":{"type":"string","maxLength":64,"title":"Code"}},"type":"object","required":["code"],"title":"MfaCodeRequest"},"MfaDisableRequest":{"properties":{"password":{"type":"string","title":"Password"},"code":{"type":"string","maxLength":64,"title":"Code"}},"type":"object","required":["password","code"],"title":"MfaDisableRequest"},"MfaDisableResponse":{"properties":{"message":{"type":"string","title":"Message"},"access_token":{"type":"string","title":"Access Token"}},"type":"object","required":["message","access_token"],"title":"MfaDisableResponse","description":"Turning the second step off ends every earlier session; ``access_token``\nkeeps this device signed in (#987)."},"MfaEnrollRequest":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"MfaEnrollRequest","description":"Re-authentication for starting enrollment (#627 review finding).\n\nTurning the second step ON is as security-relevant as turning it off, and\ndisable already required the password. Gating the *start* of the flow keeps\nthe ask to one prompt, before any QR is shown."},"MfaEnrollResponse":{"properties":{"otpauth_uri":{"type":"string","title":"Otpauth Uri"},"secret":{"type":"string","title":"Secret"}},"type":"object","required":["otpauth_uri","secret"],"title":"MfaEnrollResponse","description":"Provisioning material. MFA is NOT yet enabled at this point."},"MfaRecoveryCodesResponse":{"properties":{"recovery_codes":{"items":{"type":"string"},"type":"array","title":"Recovery Codes"},"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}},"type":"object","required":["recovery_codes"],"title":"MfaRecoveryCodesResponse","description":"Plaintext codes, returned exactly once and never retrievable again.\n\n``access_token`` is set when turning the second step on: every earlier\nsession ended, and this is the device's new one (#987)."},"MfaStatusResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"enrolled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Enrolled At"},"recovery_codes_remaining":{"type":"integer","title":"Recovery Codes Remaining","default":0},"can_enroll":{"type":"boolean","title":"Can Enroll","default":true}},"type":"object","required":["enabled"],"title":"MfaStatusResponse"},"MilestoneUpdate":{"properties":{"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"status":{"type":"string","enum":["done","not_done"],"title":"Status"}},"additionalProperties":false,"type":"object","required":["profile_id","status"],"title":"MilestoneUpdate"},"ModerateRequest":{"properties":{"action":{"type":"string","title":"Action"},"seen_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seen Updated At"}},"type":"object","required":["action"],"title":"ModerateRequest"},"MoneyHomeOut":{"properties":{"child_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Child Name"},"stage":{"type":"string","title":"Stage"},"inputs":{"anyOf":[{"$ref":"#/components/schemas/MoneyInputs"},{"type":"null"}]},"answer":{"anyOf":[{"$ref":"#/components/schemas/AnswerOut"},{"type":"null"}]},"sections":{"items":{"$ref":"#/components/schemas/SectionOut"},"type":"array","title":"Sections"},"fafsa_steps":{"items":{"$ref":"#/components/schemas/FafsaStepOut"},"type":"array","title":"Fafsa Steps"},"award_letter_checks":{"items":{"type":"string"},"type":"array","title":"Award Letter Checks"}},"type":"object","required":["child_name","stage","inputs","answer","sections","fafsa_steps","award_letter_checks"],"title":"MoneyHomeOut","description":"What the parent's home shows. ``inputs`` is the caller's own answers only."},"MoneyInputs":{"properties":{"income_band":{"type":"string","enum":["0-30k","30-40k","40-50k","50-60k","60-75k","75-90k","90-110k","110-150k","150k+"],"title":"Income Band"},"household_size":{"type":"integer","maximum":8.0,"minimum":2.0,"title":"Household Size"},"single_parent":{"type":"boolean","title":"Single Parent","default":false},"state":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"title":"State"}},"additionalProperties":false,"type":"object","required":["income_band","household_size"],"title":"MoneyInputs","description":"A parent's four answers. Banded on purpose: no exact income, no assets, no SSN."},"NearZeroCollegeOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"avg_net_price":{"type":"integer","title":"Avg Net Price"}},"type":"object","required":["id","name","slug","city","avg_net_price"],"title":"NearZeroCollegeOut"},"NearbyCenter":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"}},"type":"object","required":["latitude","longitude"],"title":"NearbyCenter"},"NearbyCollege":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"scorecard_id":{"type":"integer","title":"Scorecard Id"},"name":{"type":"string","title":"Name"},"alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alias"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"},"sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Avg"},"act_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Avg"},"undergraduate_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Undergraduate Size"},"tuition_in_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition In State"},"tuition_out_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition Out State"},"avg_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price"},"avg_net_price_0_30k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 0 30K"},"avg_net_price_30_48k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 30 48K"},"avg_net_price_48_75k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 48 75K"},"avg_net_price_75_110k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 75 110K"},"avg_net_price_110k_plus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price 110K Plus"},"completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Rate"},"median_earnings_10yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Earnings 10Yr"},"retention_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retention Rate"},"programs_offered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Programs Offered"},"other_programs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Programs"},"room_and_board":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Room And Board"},"is_hbcu":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hbcu"},"religious_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Religious Affiliation"},"student_faculty_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Student Faculty Ratio"},"pct_receiving_federal_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Federal Grant"},"pct_receiving_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Grant"},"pct_receiving_pell_grant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Receiving Pell Grant"},"avg_grant_aid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Grant Aid"},"avg_federal_loan":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Federal Loan"},"enrollment_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrollment Total"},"pct_women":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Women"},"pct_white":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct White"},"pct_black":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Black"},"pct_hispanic":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Hispanic"},"pct_asian":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Asian"},"institution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Institution Type"},"control":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Control"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"application_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Deadline"},"early_action_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Action Deadline"},"early_decision_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Decision Deadline"},"opeid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opeid"},"cohort_default_rate_3yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 3Yr"},"cohort_default_rate_2yr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cohort Default Rate 2Yr"},"cdr_numerator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Numerator"},"cdr_denominator":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Denominator"},"cdr_fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cdr Fiscal Year"},"cdr_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cdr Last Updated"},"cdr_risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdr Risk Level"},"climate_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Climate Last Updated"},"crime_rate_per_1000":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Crime Rate Per 1000"},"safety_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safety Level"},"crime_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crime Last Updated"},"cds_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Url"},"cds_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Year"},"cds_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cds Last Updated"},"cds_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cds Status"},"total_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Applicants"},"total_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Admits"},"total_enrolled":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Enrolled"},"early_decision_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Applicants"},"early_decision_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Decision Admits"},"early_action_applicants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Applicants"},"early_action_admits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Early Action Admits"},"wait_list_offered":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Offered"},"wait_list_accepted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Accepted"},"wait_list_admitted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Wait List Admitted"},"sat_erw_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 25Th"},"sat_erw_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Erw 75Th"},"sat_math_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 25Th"},"sat_math_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Math 75Th"},"act_composite_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 25Th"},"act_composite_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Composite 75Th"},"pct_freshmen_top_10_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 10 Hs"},"pct_freshmen_top_25_hs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Freshmen Top 25 Hs"},"avg_hs_gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Hs Gpa"},"pct_classes_under_20":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes Under 20"},"pct_classes_20_29":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 20 29"},"pct_classes_30_39":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 30 39"},"pct_classes_40_49":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 40 49"},"pct_classes_50_99":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 50 99"},"pct_classes_100_plus":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Classes 100 Plus"},"admission_factors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Admission Factors"},"demonstrated_interest_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demonstrated Interest Level"},"visit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visit Url"},"transportation_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Transportation Data"},"transportation_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Transportation Last Updated"},"quality_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quality Scores"},"quality_scores_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Quality Scores Updated At"},"primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Color"},"secondary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary Color"},"google_place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Place Id"},"css_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Css Code"},"requires_css_profile_domestic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile Domestic"},"requires_css_profile_international":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Profile International"},"requires_css_noncustodial":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Requires Css Noncustodial"},"uses_idoc":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Uses Idoc"},"css_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Css Last Updated"},"operating_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operating Status"},"data_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data Updated At"},"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating"},"review_count":{"type":"integer","title":"Review Count","default":0},"distance":{"type":"number","title":"Distance"},"score_bands":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Bands","description":"CDS C9/C11 distributions with band edges joined (#525).\n\n``{group: [ScoreBand, ...]}`` ordered low → high, or None. Fractions\ndescribe ENROLLED freshmen. Lazy import keeps the schema module free\nof the service-layer import chain at load time.","readOnly":true}},"type":"object","required":["id","scorecard_id","name","distance","score_bands"],"title":"NearbyCollege","description":"A college within a geographic radius of a target college.\n\nInherits all `CollegeOut` fields and adds the great-circle distance from\nthe search center, in miles."},"NearbyCollegesResponse":{"properties":{"nearby_colleges":{"items":{"$ref":"#/components/schemas/NearbyCollege"},"type":"array","title":"Nearby Colleges"},"count":{"type":"integer","title":"Count"},"center":{"$ref":"#/components/schemas/NearbyCenter"},"radius_miles":{"type":"number","title":"Radius Miles"}},"type":"object","required":["nearby_colleges","count","center","radius_miles"],"title":"NearbyCollegesResponse","description":"Result of `/colleges/{id}/nearby`."},"NearbySuggestionOut":{"properties":{"college":{"$ref":"#/components/schemas/StopCollegeOut"},"distance_miles":{"type":"number","title":"Distance Miles"},"nearest_stop_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Nearest Stop Id"},"nearest_stop_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nearest Stop Name"},"fit_score":{"type":"number","title":"Fit Score"},"admission_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admission Tier"},"fit_blurb":{"type":"string","title":"Fit Blurb"},"fit_highlights":{"items":{"type":"string"},"type":"array","title":"Fit Highlights"}},"type":"object","required":["college","distance_miles","fit_score","fit_blurb","fit_highlights"],"title":"NearbySuggestionOut","description":"One ranked nearby-school suggestion (#503)."},"NetPriceBracketRow":{"properties":{"bracket_slug":{"type":"string","title":"Bracket Slug"},"bracket_label":{"type":"string","title":"Bracket Label"},"bracket_min_usd":{"type":"integer","title":"Bracket Min Usd"},"bracket_max_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bracket Max Usd"},"net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Price"},"national_percentile":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"National Percentile","description":"0-100; 0 = cheapest, 100 = most expensive among all colleges with this bracket populated. None when net_price is None."},"peer_schools":{"items":{"$ref":"#/components/schemas/NetPricePeerSchool"},"type":"array","title":"Peer Schools","description":"Up to 3 schools with same control + similar selectivity, ordered by closeness to this college's net_price."}},"type":"object","required":["bracket_slug","bracket_label","bracket_min_usd","bracket_max_usd","net_price"],"title":"NetPriceBracketRow","description":"One income-bracket row in the stacked table.\n\nBrackets are always emitted in order (0-30k, 30-48k, 48-75k, 75-110k,\n110k-plus). A bracket with no data still emits a row with ``net_price``\nnull + empty ``peer_schools`` — keeps the rendered table layout stable\nand avoids \"missing row\" confusion."},"NetPriceCollegeEstimate":{"properties":{"college_id":{"type":"string","title":"College Id"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"control":{"type":"string","enum":["public","private-nonprofit","for-profit","unknown"],"title":"Control"},"slot":{"type":"string","enum":["public","match","reach","safety","private","selected"],"title":"Slot"},"coa":{"type":"integer","title":"Coa","description":"Estimated cost of attendance used for this calculation"},"net_price":{"type":"integer","title":"Net Price","description":"COA minus total aid (floored at zero)"},"pell_grant":{"type":"integer","title":"Pell Grant"},"institutional_grant":{"type":"integer","title":"Institutional Grant"},"work_study":{"type":"integer","title":"Work Study"},"federal_loans":{"type":"integer","title":"Federal Loans"},"out_of_pocket":{"type":"integer","title":"Out Of Pocket"},"avg_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price","description":"Official Scorecard average net price for context"}},"type":"object","required":["college_id","name","state","control","slot","coa","net_price","pell_grant","institutional_grant","work_study","federal_loans","out_of_pocket"],"title":"NetPriceCollegeEstimate"},"NetPriceContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"median_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Net Price","description":"Median of the lower 4 brackets (0-30k through 75-110k). 110k+ is excluded because the top-bracket tail skews the central tendency. None when fewer than 4 lower brackets are populated."},"brackets":{"items":{"$ref":"#/components/schemas/NetPriceBracketRow"},"type":"array","title":"Brackets"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff at least one bracket has a net_price. Drives sitemap inclusion + noindex."},"data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Year","description":"Fall year of the academic year the bracket figures are from, as the Scorecard sync recorded it (2024 = 2024–25). None until a sync records one (#722)."},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","brackets","has_any_data","last_retrieved_at"],"title":"NetPriceContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/net-price-context``."},"NetPriceEstimateRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"income_bracket":{"type":"string","enum":["under-30k","30k-60k","60k-100k","100k-150k","150k-250k","over-250k"],"title":"Income Bracket"},"dependents":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Dependents"},"state":{"type":"string","maxLength":2,"minLength":2,"title":"State","description":"Two-letter US state code"},"gpa_range":{"type":"string","enum":["under-2.5","2.5-3.0","3.0-3.5","3.5-3.8","3.8-plus"],"title":"Gpa Range"},"intended_major":{"type":"string","maxLength":120,"minLength":1,"title":"Intended Major"},"school":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"School","description":"Optional college UUID or slug for a foregrounded per-school estimate (#412)"}},"type":"object","required":["session_id","income_bracket","dependents","state","gpa_range","intended_major"],"title":"NetPriceEstimateRequest"},"NetPriceEstimateResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"result":{"$ref":"#/components/schemas/NetPriceResultEnvelope"}},"type":"object","required":["session_id","result"],"title":"NetPriceEstimateResponse"},"NetPricePeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"net_price":{"type":"integer","title":"Net Price"}},"type":"object","required":["id","slug","name","state","net_price"],"title":"NetPricePeerSchool","description":"One peer school's net price at a specific bracket."},"NetPriceResultEnvelope":{"properties":{"national_avg_net_price":{"type":"integer","title":"National Avg Net Price"},"colleges":{"items":{"$ref":"#/components/schemas/NetPriceCollegeEstimate"},"type":"array","title":"Colleges"},"disclaimer":{"type":"string","title":"Disclaimer"},"your_school":{"anyOf":[{"$ref":"#/components/schemas/NetPriceCollegeEstimate"},{"type":"null"}],"description":"Foregrounded personalized estimate for the queried school (#412), if one was provided and resolvable"}},"type":"object","required":["national_avg_net_price","colleges","disclaimer"],"title":"NetPriceResultEnvelope"},"NotificationPreferences":{"properties":{"deadlines":{"type":"boolean","title":"Deadlines","default":true},"invitations":{"type":"boolean","title":"Invitations","default":true},"shares":{"type":"boolean","title":"Shares","default":true}},"type":"object","title":"NotificationPreferences","description":"Per-category push opt-outs. Missing/absent = opted in."},"OAuthExchangeRequest":{"properties":{"code":{"type":"string","title":"Code"},"code_verifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Verifier"}},"type":"object","required":["code"],"title":"OAuthExchangeRequest"},"OccupationOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"soc_code":{"type":"string","title":"Soc Code"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"median_hourly_wage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Hourly Wage"},"median_annual_wage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Annual Wage"},"employment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employment Count"},"job_outlook":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Outlook"},"data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Year"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["id","soc_code","title"],"title":"OccupationOut","description":"Schema for occupation output."},"OnboardingClaim":{"properties":{"persona":{"anyOf":[{"type":"string","enum":["student","parent","counselor"]},{"type":"null"}],"title":"Persona"},"intake":{"anyOf":[{"$ref":"#/components/schemas/OnboardingIntake"},{"type":"null"}]}},"type":"object","title":"OnboardingClaim","description":"The anonymous onboarding record, claimed after sign-in (#870).\n\nMirrors ``frontend/src/lib/onboarding.ts``. Every field is optional and\napplies only where the account has no value yet."},"OnboardingIntake":{"properties":{"grade":{"anyOf":[{"type":"string","enum":["9","10","11","12","not_in_high_school"]},{"type":"null"}],"title":"Grade"},"done_keys":{"items":{"type":"string","maxLength":40},"type":"array","maxItems":20,"title":"Done Keys"},"interests":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Interests"}},"additionalProperties":false,"type":"object","title":"OnboardingIntake","description":"The pre-signup intake's answers (#872). No PII by construction: extra\nfields are rejected, so nothing but these three answers can ride along."},"OrgAnalyticsOverview":{"properties":{"scope":{"type":"string","enum":["organization","caseload"],"title":"Scope","default":"organization"},"total_students":{"type":"integer","title":"Total Students"},"active_students_30d":{"type":"integer","title":"Active Students 30D"},"total_counselors":{"type":"integer","title":"Total Counselors"},"unassigned_students":{"type":"integer","title":"Unassigned Students","description":"Active roster students with no assigned counselor (#662) — invisible in every counselor's progress view until reassigned.","default":0},"total_colleges_saved":{"type":"integer","title":"Total Colleges Saved"},"total_conversations":{"type":"integer","title":"Total Conversations"},"profile_completion_rate":{"type":"number","title":"Profile Completion Rate","description":"Percent of org students whose own profile has its required fields (0–100, 1 decimal)."},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["total_students","active_students_30d","total_counselors","total_colleges_saved","total_conversations","profile_completion_rate","generated_at"],"title":"OrgAnalyticsOverview","description":"Aggregate stats for the overview dashboard.\n\n``scope`` says what population the numbers were computed over (#661):\n``organization`` for owners/admins, ``caseload`` — the students assigned to\nthe caller — for counselors. The UI labels from it; it is not a request\nparameter, because a counselor cannot ask for the other scope."},"OrgCounselorActivity":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrgCounselorActivityRow"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"OrgCounselorActivity"},"OrgCounselorActivityRow":{"properties":{"counselor_user_id":{"type":"string","format":"uuid","title":"Counselor User Id"},"counselor_email":{"type":"string","title":"Counselor Email"},"counselor_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counselor Display Name"},"assigned_students":{"type":"integer","title":"Assigned Students"},"active_students_30d":{"type":"integer","title":"Active Students 30D"},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At","description":"MAX(messages.created_at) for the counselor's own user account. Measures the counselor's platform activity, NOT their students'."}},"type":"object","required":["counselor_user_id","counselor_email","counselor_display_name","assigned_students","active_students_30d","last_active_at"],"title":"OrgCounselorActivityRow"},"OrgEngagementPoint":{"properties":{"period_start":{"type":"string","format":"date","title":"Period Start"},"active_students":{"type":"integer","title":"Active Students"},"conversations_started":{"type":"integer","title":"Conversations Started"},"messages_sent":{"type":"integer","title":"Messages Sent"}},"type":"object","required":["period_start","active_students","conversations_started","messages_sent"],"title":"OrgEngagementPoint"},"OrgEngagementSeries":{"properties":{"granularity":{"type":"string","enum":["day","week","month"],"title":"Granularity"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"points":{"items":{"$ref":"#/components/schemas/OrgEngagementPoint"},"type":"array","title":"Points"}},"type":"object","required":["granularity","start","end","points"],"title":"OrgEngagementSeries"},"OrgStudentProgressList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrgStudentProgressRow"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"OrgStudentProgressList"},"OrgStudentProgressRow":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"profile_completed":{"type":"boolean","title":"Profile Completed"},"colleges_saved":{"type":"integer","title":"Colleges Saved"},"conversation_count":{"type":"integer","title":"Conversation Count"},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"}},"type":"object","required":["student_user_id","email","display_name","assigned_counselor_id","profile_completed","colleges_saved","conversation_count","last_active_at"],"title":"OrgStudentProgressRow"},"OrganizationCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"}},"type":"object","required":["name","type"],"title":"OrganizationCreate","description":"Slug is auto-generated by the service (#116) and is not accepted on create."},"OrganizationDetailRead":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"caller_role":{"anyOf":[{"type":"string","enum":["owner","admin","counselor"]},{"type":"null"}],"title":"Caller Role"},"member_count":{"type":"integer","title":"Member Count","default":0},"student_count":{"type":"integer","title":"Student Count","default":0},"dpa_signed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Dpa Signed At"},"requires_dpa":{"type":"boolean","title":"Requires Dpa","default":false}},"type":"object","required":["name","type","id","slug","status","created_at","updated_at"],"title":"OrganizationDetailRead","description":"Detail read used by GET/POST/PATCH endpoints — adds aggregate counts\nand the **acting user's** role inside this org.\n\nComputed by the service layer (#116) via subqueries; not stored on the model.\n``caller_role`` is populated from the ``MembershipContext`` resolved by the\nrouter auth dependency, so the frontend can render role-gated UI without\nmaking a second `/members` call (which is unreliable for orgs larger than\none page)."},"OrganizationInvitationAcceptRequest":{"properties":{"share":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Share"}},"type":"object","title":"OrganizationInvitationAcceptRequest","description":"Optional body for accept. A student invite (#899) requires ``share``:\nthe answer to \"Share my college list and progress with [organization]?\".\nNeither choice is assumed. A staff invite ignores it."},"OrganizationInvitationAcceptResponse":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"organization_slug":{"type":"string","title":"Organization Slug"},"membership_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Membership Id"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","counselor"]},{"type":"null"}],"title":"Role"},"joined_as":{"type":"string","enum":["member","student"],"title":"Joined As","default":"member"},"shared":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Shared"}},"type":"object","required":["organization_id","organization_slug"],"title":"OrganizationInvitationAcceptResponse","description":"Returned by `POST /api/organizations/invitations/{token}/accept`.\n\nA staff invite returns the membership; a student invite (#899) returns\n``joined_as=\"student\"`` with no membership and the sharing answer."},"OrganizationInvitationCreateRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","enum":["admin","counselor"],"title":"Role"}},"type":"object","required":["email","role"],"title":"OrganizationInvitationCreateRequest","description":"Request body for `POST /api/organizations/{org_id}/invitations` (#117).\n\nThe org_id comes from the URL, so it isn't part of the body."},"OrganizationInvitationListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationInvitationRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"OrganizationInvitationListResponse","description":"Paginated list wrapper for `GET /api/organizations/{org_id}/invitations`."},"OrganizationInvitationMine":{"properties":{"token":{"type":"string","title":"Token"},"organization_name":{"type":"string","title":"Organization Name"},"role":{"type":"string","enum":["admin","counselor","student"],"title":"Role"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["token","organization_name","role","expires_at"],"title":"OrganizationInvitationMine","description":"One of the signed-in user's own pending invitations (#873).\n\nCarries the token because it is the invitee's own: it was emailed to this\naddress. Only ``GET /organizations/invitations/mine`` returns it, matched\non the caller's email; admin lists never do (see the read schema above)."},"OrganizationInvitationPublicRead":{"properties":{"organization_name":{"type":"string","title":"Organization Name"},"organization_verified":{"type":"boolean","title":"Organization Verified"},"inviter_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inviter Name"},"role":{"type":"string","enum":["admin","counselor","student"],"title":"Role"},"status":{"type":"string","enum":["pending","accepted","expired","revoked"],"title":"Status"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"invitee_email":{"type":"string","format":"email","title":"Invitee Email"}},"type":"object","required":["organization_name","organization_verified","role","status","expires_at","invitee_email"],"title":"OrganizationInvitationPublicRead","description":"Pre-login metadata for the join page lookup by token (#117).\n\nReturned by the unauthenticated `GET /api/organizations/invitations/{token}`\nso the frontend can render the join page before the user logs in. Does NOT\nleak the org_id or any privileged fields. The invitee email is included\nbecause the holder of the link already knows it (it was emailed to them)."},"OrganizationInvitationRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","enum":["admin","counselor","student"],"title":"Role"},"status":{"type":"string","enum":["pending","accepted","expired","revoked"],"title":"Status"},"invited_by_id":{"type":"string","format":"uuid","title":"Invited By Id"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"accepted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Accepted At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","organization_id","email","role","status","invited_by_id","expires_at","created_at"],"title":"OrganizationInvitationRead","description":"Public invitation read schema. **Never** includes the raw token.\n\nSECURITY: the join token is a bearer secret that proves the invitee's\naddress at sign-up (#873). It goes in the invitation email and in the\ninvitee's own `OrganizationInvitationMine`, never in a response to the\norg: not a list, and not the create or resend response (#978). An org\nadmin holding it could register the invited address."},"OrganizationJoinCodeCreate":{"properties":{"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"max_uses":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Max Uses"}},"type":"object","title":"OrganizationJoinCodeCreate","description":"Create the org's join code. Replaces (revokes) any active one."},"OrganizationJoinCodeListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationJoinCodeRead"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"OrganizationJoinCodeListResponse"},"OrganizationJoinCodeRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"code":{"type":"string","title":"Code"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"assigned_counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Counselor Name"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses"},"use_count":{"type":"integer","title":"Use Count"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","code","use_count","created_at"],"title":"OrganizationJoinCodeRead","description":"A join code, for the org's owners/admins. The code is shareable by\ndesign (posted, read aloud), unlike an invitation token."},"OrganizationListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"OrganizationListResponse","description":"Paginated list wrapper for `GET /api/organizations`."},"OrganizationListingMeRead":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"listed_at":{"type":"string","format":"date-time","title":"Listed At"},"shared":{"type":"boolean","title":"Shared","default":false}},"type":"object","required":["organization_id","name","slug","type","status","listed_at"],"title":"OrganizationListingMeRead","description":"One organization that lists the caller on its student roster (#659).\n\nDeliberately narrow: it answers \"who has listed me\", not \"tell me about this\norganization\". No member list, no student count, no analytics -- a student\nbeing on a roster is not a reason to expose the org's internals to them.\n\n``status`` is included, and suspended orgs are **not** filtered out: a\nsuspended organization still holds a listing, and that is precisely the case\na student might want to ask about."},"OrganizationListingMeResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationListingMeRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"OrganizationListingMeResponse"},"OrganizationMemberDetailRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"},"user":{"$ref":"#/components/schemas/OrganizationMemberUser"}},"type":"object","required":["id","organization_id","role","joined_at","user"],"title":"OrganizationMemberDetailRead","description":"Member listing row with embedded user info (#116 `GET /{org_id}/members`)."},"OrganizationMemberListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationMemberDetailRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"OrganizationMemberListResponse"},"OrganizationMemberRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"},"invited_by_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Invited By Id"}},"type":"object","required":["id","organization_id","user_id","role","joined_at"],"title":"OrganizationMemberRead"},"OrganizationMemberRoleUpdate":{"properties":{"role":{"type":"string","enum":["admin","counselor"],"title":"Role"}},"type":"object","required":["role"],"title":"OrganizationMemberRoleUpdate","description":"Request body for ``PATCH /organizations/{org_id}/members/{user_id}/role``.\n\nOwner promotion is intentionally not allowed — use the dedicated\n``POST /organizations/{org_id}/transfer`` endpoint."},"OrganizationMemberUser":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"email":{"type":"string","format":"email","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["id","email"],"title":"OrganizationMemberUser","description":"Slim user payload embedded in member listings — no PII beyond email/name."},"OrganizationOwnershipTransfer":{"properties":{"new_owner_user_id":{"type":"string","format":"uuid","title":"New Owner User Id"},"current_password":{"type":"string","maxLength":128,"minLength":1,"title":"Current Password"}},"type":"object","required":["new_owner_user_id","current_password"],"title":"OrganizationOwnershipTransfer","description":"Request body for ``POST /organizations/{org_id}/transfer``.\n\nThe acting owner must confirm the operation with their current password.\nOn success the target becomes ``owner`` and the acting user is demoted\nto ``admin`` atomically."},"OrganizationRead":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"caller_role":{"anyOf":[{"type":"string","enum":["owner","admin","counselor"]},{"type":"null"}],"title":"Caller Role"}},"type":"object","required":["name","type","id","slug","status","created_at","updated_at"],"title":"OrganizationRead"},"OrganizationStudentAssign":{"properties":{"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"}},"type":"object","title":"OrganizationStudentAssign","description":"Request body for ``PATCH /organizations/{org_id}/students/{student_id}/assign``."},"OrganizationStudentBulkAdd":{"properties":{"emails":{"items":{"type":"string","format":"email"},"type":"array","maxItems":500,"minItems":1,"title":"Emails"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string","const":"me"},{"type":"null"}],"title":"Assigned Counselor Id"}},"type":"object","required":["emails"],"title":"OrganizationStudentBulkAdd","description":"Request body for ``POST /organizations/{org_id}/students/bulk``."},"OrganizationStudentBulkAddResponse":{"properties":{"added":{"items":{"$ref":"#/components/schemas/OrganizationStudentRead"},"type":"array","title":"Added"},"already_present":{"items":{"$ref":"#/components/schemas/BulkAddAlreadyPresent"},"type":"array","title":"Already Present"},"skipped":{"items":{"$ref":"#/components/schemas/BulkAddSkipped"},"type":"array","title":"Skipped"}},"type":"object","required":["added","already_present","skipped"],"title":"OrganizationStudentBulkAddResponse"},"OrganizationStudentCreate":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"}},"type":"object","required":["student_user_id"],"title":"OrganizationStudentCreate","description":"Request body for ``POST /organizations/{org_id}/students``.\n\n`org_id` comes from the URL path; `added_by_id` is the authenticated user."},"OrganizationStudentDetailRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"email":{"type":"string","format":"email","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"assigned_counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Counselor Name"},"added_by_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Added By Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"unassigned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unassigned At"},"unassigned_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unassigned Reason"},"share_consent":{"type":"boolean","title":"Share Consent","default":false},"user_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Role"},"user_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"User Created At"},"colleges_saved":{"type":"integer","title":"Colleges Saved","default":0},"conversation_count":{"type":"integer","title":"Conversation Count","default":0},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"}},"type":"object","required":["id","organization_id","student_user_id","email","created_at"],"title":"OrganizationStudentDetailRead","description":"Single-student detail view (`GET /students/{student_id}`).\n\nIncludes lightweight engagement counters so the org-context student detail\npage (#123) can render activity stats without a second analytics call."},"OrganizationStudentInvitationCreateRequest":{"properties":{"emails":{"items":{"type":"string","format":"email"},"type":"array","maxItems":100,"minItems":1,"title":"Emails"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"}},"type":"object","required":["emails"],"title":"OrganizationStudentInvitationCreateRequest","description":"``POST /organizations/{org_id}/student-invitations`` (#899)."},"OrganizationStudentInvitationCreateResponse":{"properties":{"invited":{"items":{"$ref":"#/components/schemas/OrganizationInvitationRead"},"type":"array","title":"Invited"},"skipped":{"items":{"$ref":"#/components/schemas/StudentInvitationSkipped"},"type":"array","title":"Skipped"}},"type":"object","required":["invited","skipped"],"title":"OrganizationStudentInvitationCreateResponse"},"OrganizationStudentListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OrganizationStudentRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","skip","limit"],"title":"OrganizationStudentListResponse"},"OrganizationStudentRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"email":{"type":"string","format":"email","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"assigned_counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Assigned Counselor Id"},"assigned_counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Counselor Name"},"added_by_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Added By Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"unassigned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unassigned At"},"unassigned_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unassigned Reason"},"share_consent":{"type":"boolean","title":"Share Consent","default":false}},"type":"object","required":["id","organization_id","student_user_id","email","created_at"],"title":"OrganizationStudentRead","description":"Roster row enriched with the student user's email/display name and the\nassigned counselor's display name (if any)."},"OrganizationTreeRead":{"properties":{"organization":{"$ref":"#/components/schemas/TreeOrg"},"counts":{"$ref":"#/components/schemas/TreeCounts"},"staff":{"items":{"$ref":"#/components/schemas/TreeStaff"},"type":"array","title":"Staff"},"unassigned":{"items":{"$ref":"#/components/schemas/TreeStudent"},"type":"array","title":"Unassigned"},"schools":{"items":{"$ref":"#/components/schemas/TreeSchool"},"type":"array","title":"Schools"}},"type":"object","required":["organization","counts","staff","unassigned","schools"],"title":"OrganizationTreeRead"},"OrganizationUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"type":{"anyOf":[{"type":"string","enum":["school","district","counseling_practice","community_organization"]},{"type":"null"}],"title":"Type"},"domain":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Domain"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"logo_url":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Logo Url"},"parent_org_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Org Id"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"}},"type":"object","title":"OrganizationUpdate"},"OutcomesDailyResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/OutcomesDailyRow"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"OutcomesDailyResponse"},"OutcomesDailyRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"colleges_processed":{"type":"integer","title":"Colleges Processed"},"colleges_derived":{"type":"integer","title":"Colleges Derived"},"colleges_short_circuited":{"type":"integer","title":"Colleges Short Circuited"},"colleges_failed":{"type":"integer","title":"Colleges Failed"},"wikidata_items_fetched":{"type":"integer","title":"Wikidata Items Fetched"},"openalex_authors_fetched":{"type":"integer","title":"Openalex Authors Fetched"}},"type":"object","required":["metric_date","colleges_processed","colleges_derived","colleges_short_circuited","colleges_failed","wikidata_items_fetched","openalex_authors_fetched"],"title":"OutcomesDailyRow","description":"One row from metrics_outcomes_daily."},"OutcomesProfileDetail":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"outcomes_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcomes Status"},"data_depth_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Depth Score"},"notable_alumni":{"items":{"$ref":"#/components/schemas/ResolvedAlumnus"},"type":"array","title":"Notable Alumni"},"top_researchers":{"items":{"$ref":"#/components/schemas/ResolvedAlumnus"},"type":"array","title":"Top Researchers"},"research_areas":{"items":{"$ref":"#/components/schemas/ResolvedAlumnus"},"type":"array","title":"Research Areas"},"sample_size":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sample Size"},"sample_method":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Sample Method"},"derivation_version":{"type":"integer","title":"Derivation Version"},"input_hash":{"type":"string","title":"Input Hash"},"license":{"type":"string","title":"License"},"derived_at":{"type":"string","format":"date-time","title":"Derived At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["college_id","college_name","outcomes_status","data_depth_score","notable_alumni","top_researchers","research_areas","sample_size","sample_method","derivation_version","input_hash","license","derived_at","created_at","updated_at"],"title":"OutcomesProfileDetail"},"OutcomesProfileListResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/OutcomesProfileRow"},"type":"array","title":"Rows"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["rows","total","page","page_size","total_pages"],"title":"OutcomesProfileListResponse"},"OutcomesProfileRow":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"outcomes_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcomes Status"},"data_depth_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Depth Score"},"derivation_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Derivation Version"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"derived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Derived At"},"sample_size":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sample Size"},"sample_method":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Sample Method"}},"type":"object","required":["college_id","college_name","outcomes_status","data_depth_score","derivation_version","license","derived_at","sample_size","sample_method"],"title":"OutcomesProfileRow","description":"One row in the outcomes colleges list."},"OutreachActivityCreate":{"properties":{"recipient_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Recipient Id"},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"subject":{"type":"string","maxLength":500,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":50000,"minLength":1,"title":"Body"},"recipient_email":{"type":"string","format":"email","title":"Recipient Email"},"recipient_name":{"type":"string","maxLength":255,"minLength":1,"title":"Recipient Name"},"status":{"$ref":"#/components/schemas/OutreachStatus","default":"draft"},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"purpose":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Purpose"},"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"},"scholarship_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Scholarship Id"},"document_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Document Ids","description":"IDs of documents to attach"}},"type":"object","required":["subject","body","recipient_email","recipient_name"],"title":"OutreachActivityCreate","description":"Schema for creating an outreach activity."},"OutreachActivityList":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/OutreachActivityResponse"},"type":"array","title":"Activities"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["activities","total","page","page_size"],"title":"OutreachActivityList","description":"Schema for paginated activity list."},"OutreachActivityPreviewResponse":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"}},"type":"object","required":["subject","body"],"title":"OutreachActivityPreviewResponse","description":"Rendered preview of an outreach activity with merge fields resolved."},"OutreachActivityResponse":{"properties":{"recipient_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Recipient Id"},"template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Template Id"},"subject":{"type":"string","maxLength":500,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":50000,"minLength":1,"title":"Body"},"recipient_email":{"type":"string","format":"email","title":"Recipient Email"},"recipient_name":{"type":"string","maxLength":255,"minLength":1,"title":"Recipient Name"},"status":{"$ref":"#/components/schemas/OutreachStatus","default":"draft"},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"purpose":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Purpose"},"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"},"scholarship_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Scholarship Id"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"opened_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Opened At"},"replied_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Replied At"},"follow_up_completed":{"type":"boolean","title":"Follow Up Completed"},"reply_alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Alias"},"direction":{"type":"string","title":"Direction","default":"outbound"},"parent_activity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Activity Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"documents":{"items":{"$ref":"#/components/schemas/OutreachDocumentResponse"},"type":"array","title":"Documents","default":[]}},"type":"object","required":["subject","body","recipient_email","recipient_name","id","profile_id","follow_up_completed","created_at"],"title":"OutreachActivityResponse","description":"Schema for outreach activity responses."},"OutreachActivitySend":{"properties":{"send_copy_to_self":{"type":"boolean","title":"Send Copy To Self","description":"Send a copy to the student","default":false}},"type":"object","title":"OutreachActivitySend","description":"Schema for sending an outreach email."},"OutreachActivityUpdate":{"properties":{"subject":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Subject"},"body":{"anyOf":[{"type":"string","maxLength":50000,"minLength":1},{"type":"null"}],"title":"Body"},"recipient_email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Recipient Email"},"recipient_name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Recipient Name"},"status":{"anyOf":[{"$ref":"#/components/schemas/OutreachStatus"},{"type":"null"}]},"follow_up_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Follow Up Date"},"follow_up_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Follow Up Completed"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"purpose":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Purpose"},"document_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Document Ids"}},"type":"object","title":"OutreachActivityUpdate","description":"Schema for updating an outreach activity."},"OutreachDocumentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"document_id":{"type":"string","format":"uuid","title":"Document Id"},"document_title":{"type":"string","title":"Document Title"},"document_file_name":{"type":"string","title":"Document File Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","document_id","document_title","document_file_name","created_at"],"title":"OutreachDocumentResponse","description":"Schema for attached document info."},"OutreachRecipientCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"organization":{"type":"string","maxLength":255,"minLength":1,"title":"Organization"},"department":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Department"},"recipient_type":{"$ref":"#/components/schemas/OutreachRecipientType"},"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"},"scholarship_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Scholarship Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"preferred_contact_method":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Preferred Contact Method"}},"type":"object","required":["name","email","organization","recipient_type"],"title":"OutreachRecipientCreate","description":"Schema for creating an outreach recipient."},"OutreachRecipientList":{"properties":{"recipients":{"items":{"$ref":"#/components/schemas/OutreachRecipientResponse"},"type":"array","title":"Recipients"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["recipients","total","page","page_size"],"title":"OutreachRecipientList","description":"Schema for paginated recipient list."},"OutreachRecipientResponse":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"organization":{"type":"string","maxLength":255,"minLength":1,"title":"Organization"},"department":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Department"},"recipient_type":{"$ref":"#/components/schemas/OutreachRecipientType"},"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"},"scholarship_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Scholarship Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"preferred_contact_method":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Preferred Contact Method"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["name","email","organization","recipient_type","id","profile_id","is_active","created_at"],"title":"OutreachRecipientResponse","description":"Schema for outreach recipient responses."},"OutreachRecipientType":{"type":"string","enum":["college_admissions","athletic_coach","scholarship_committee","academic_counselor","department_head","financial_aid_officer","recommender","other"],"title":"OutreachRecipientType","description":"Types of stakeholders students contact"},"OutreachRecipientUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"organization":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Organization"},"department":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Department"},"recipient_type":{"anyOf":[{"$ref":"#/components/schemas/OutreachRecipientType"},{"type":"null"}]},"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"},"scholarship_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Scholarship Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"preferred_contact_method":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Preferred Contact Method"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"OutreachRecipientUpdate","description":"Schema for updating an outreach recipient."},"OutreachStatistics":{"properties":{"total_activities":{"type":"integer","title":"Total Activities"},"activities_by_status":{"additionalProperties":true,"type":"object","title":"Activities By Status"},"activities_by_recipient_type":{"additionalProperties":true,"type":"object","title":"Activities By Recipient Type"},"total_emails_sent":{"type":"integer","title":"Total Emails Sent"},"response_rate":{"type":"number","title":"Response Rate"},"most_contacted_organization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Most Contacted Organization"}},"type":"object","required":["total_activities","activities_by_status","activities_by_recipient_type","total_emails_sent","response_rate"],"title":"OutreachStatistics","description":"Statistics for outreach activities."},"OutreachStatus":{"type":"string","enum":["draft","sent","opened","replied","received","follow_up_needed","completed"],"title":"OutreachStatus","description":"Status of outreach activities"},"OutreachThreadResponse":{"properties":{"thread":{"items":{"$ref":"#/components/schemas/OutreachActivityResponse"},"type":"array","title":"Thread"},"root_activity_id":{"type":"string","format":"uuid","title":"Root Activity Id"}},"type":"object","required":["thread","root_activity_id"],"title":"OutreachThreadResponse","description":"Schema for a conversation thread."},"OverrideCreate":{"properties":{"field_name":{"type":"string","maxLength":64,"minLength":1,"title":"Field Name"},"value":{"title":"Value"},"reason":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Reason"}},"type":"object","required":["field_name"],"title":"OverrideCreate","description":"Admin-submitted override request body."},"OverrideOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"resource_type":{"type":"string","title":"Resource Type"},"resource_id":{"type":"string","format":"uuid","title":"Resource Id"},"field_name":{"type":"string","title":"Field Name"},"value":{"title":"Value"},"confidence":{"type":"string","title":"Confidence"},"source":{"type":"string","title":"Source"},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","resource_type","resource_id","field_name","value","confidence","source","created_by","reason","is_active","created_at","updated_at"],"title":"OverrideOut","description":"Serialised AthleticFieldOverride row.\n\nORM attribute is ``value_json``; exposed to clients as ``value``. Parsing\naccepts either name via ``populate_by_name=True`` so tests and clients\ncan use whichever is handier."},"OwnRecordRead":{"properties":{"milestone_key":{"type":"string","title":"Milestone Key"},"label":{"type":"string","title":"Label"},"status":{"type":"string","enum":["done","not_done","not_applicable"],"title":"Status"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"type":"object","required":["milestone_key","label","status","recorded_at"],"title":"OwnRecordRead"},"OwnRecordsRead":{"properties":{"class_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Year"},"fafsa":{"$ref":"#/components/schemas/FafsaSummaryRead"},"records":{"items":{"$ref":"#/components/schemas/OwnRecordRead"},"type":"array","title":"Records"}},"type":"object","required":["class_year","fafsa","records"],"title":"OwnRecordsRead"},"ParentContactCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"categories":{"items":{"type":"string","enum":["milestones","money","deadlines"]},"type":"array","maxItems":3,"minItems":1,"title":"Categories"},"language":{"type":"string","enum":["en","es"],"title":"Language","default":"en"}},"additionalProperties":false,"type":"object","required":["email","categories"],"title":"ParentContactCreate"},"ParentContactOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"email":{"type":"string","title":"Email"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"language":{"type":"string","title":"Language","default":"en"},"status":{"type":"string","title":"Status"},"confirmed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Confirmed At"},"unsubscribed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unsubscribed At"},"can_resend":{"type":"boolean","title":"Can Resend","default":false}},"type":"object","required":["id","email","categories","status"],"title":"ParentContactOut"},"ParentContactUpdate":{"properties":{"categories":{"items":{"type":"string","enum":["milestones","money","deadlines"]},"type":"array","maxItems":3,"minItems":1,"title":"Categories"}},"additionalProperties":false,"type":"object","required":["categories"],"title":"ParentContactUpdate"},"PatternTestRequest":{"properties":{"html_content":{"type":"string","title":"Html Content"},"college_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Name"}},"type":"object","required":["html_content"],"title":"PatternTestRequest"},"PatternTestResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"extracted_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extracted Data"},"scholarships_found":{"type":"integer","title":"Scholarships Found"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["success","scholarships_found"],"title":"PatternTestResponse"},"PellOutlookOut":{"properties":{"outlook":{"type":"string","enum":["likely","possible","unlikely"],"title":"Outlook"},"max_pell":{"type":"integer","title":"Max Pell"},"line":{"type":"integer","title":"Line"},"award_year":{"type":"string","title":"Award Year"},"poverty_guideline_year":{"type":"integer","title":"Poverty Guideline Year"}},"type":"object","required":["outlook","max_pell","line","award_year","poverty_guideline_year"],"title":"PellOutlookOut"},"PendingDeletionResponse":{"properties":{"pending":{"type":"boolean","title":"Pending"},"confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Confirmed"},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled For"},"requested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested At"}},"type":"object","required":["pending"],"title":"PendingDeletionResponse","description":"Status of an account's pending-deletion record."},"PendingHandoverOut":{"properties":{"email":{"type":"string","title":"Email"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["email","expires_at"],"title":"PendingHandoverOut","description":"A handover the parent sent that the child hasn't answered yet (#883).\nOnly what the parent already knows: the address they typed, and when it\nlapses."},"PendingTaskEntry":{"properties":{"task_id":{"type":"string","title":"Task Id"},"task_name":{"type":"string","title":"Task Name"},"queue":{"type":"string","title":"Queue"},"priority":{"type":"integer","title":"Priority"},"position":{"type":"integer","title":"Position"},"root_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Root Id"},"parent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Id"},"is_chained":{"type":"boolean","title":"Is Chained","default":false},"origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin"},"retries":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retries"},"eta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eta"},"expires":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires"},"is_expired":{"type":"boolean","title":"Is Expired","default":false}},"type":"object","required":["task_id","task_name","queue","priority","position"],"title":"PendingTaskEntry","description":"A task message sitting in a broker queue, not yet received by a worker.\n\n``position`` is the honest stand-in for age: celery's protocol-v2 headers\ncarry **no publish timestamp** (and ``delivery_tag`` is a UUID4, not a\ntime-ordered value), so there is nothing to derive a real \"sent at\" from.\nPosition is exact, needs no clock, and answers the operator's actual\nquestion — how deep is this. ``eta``/``expires`` are surfaced because they\n*are* real timestamps when the publisher set them."},"PendingTasksResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/PendingTaskEntry"},"type":"array","title":"Entries"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["entries","meta"],"title":"PendingTasksResponse"},"PerformanceTrend":{"properties":{"sport":{"type":"string","title":"Sport"},"stat_name":{"type":"string","title":"Stat Name"},"stat_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stat Unit"},"entries":{"items":{"$ref":"#/components/schemas/PerformanceTrendPoint"},"type":"array","title":"Entries"},"benchmarks":{"items":{"$ref":"#/components/schemas/AthleticBenchmarkOut"},"type":"array","title":"Benchmarks","default":[]}},"type":"object","required":["sport","stat_name","entries"],"title":"PerformanceTrend"},"PerformanceTrendPoint":{"properties":{"recorded_date":{"type":"string","format":"date","title":"Recorded Date"},"stat_value":{"type":"string","title":"Stat Value"}},"type":"object","required":["recorded_date","stat_value"],"title":"PerformanceTrendPoint"},"ProfileAccessRequestCreate":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"}},"type":"object","required":["student_user_id","organization_id"],"title":"ProfileAccessRequestCreate","description":"A counselor asking a rostered student for profile access (#658)."},"ProfileAccessRequestOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"requester_user_id":{"type":"string","format":"uuid","title":"Requester User Id"},"requester_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester Name"},"requester_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requester Email"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"organization_verified":{"type":"boolean","title":"Organization Verified","default":false},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["id","profile_id","requester_user_id","organization_id","status","created_at","expires_at"],"title":"ProfileAccessRequestOut","description":"A pending request, as shown to whoever may decide it.\n\nCarries the organization because the request's legitimacy rests on it — an\napprover deciding \"should this person see my plan?\" needs to know which\nschool is asking, not just a counselor's name."},"ProfileAthleticsCreate":{"properties":{"primary_sport":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Sport"},"sports_interested":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sports Interested"},"position_played":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position Played"},"secondary_positions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Positions"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"club_team":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Club Team"},"high_school_team":{"type":"boolean","title":"High School Team","default":false},"travel_team":{"type":"boolean","title":"Travel Team","default":false},"athletic_stats":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Stats"},"personal_records":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Records"},"competition_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competition Level"},"awards_honors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Awards Honors"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"all_state":{"type":"boolean","title":"All State","default":false},"all_conference":{"type":"boolean","title":"All Conference","default":false},"captain":{"type":"boolean","title":"Captain","default":false},"preferred_division_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Division Levels"},"preferred_conferences":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Conferences"},"scholarship_required":{"type":"boolean","title":"Scholarship Required","default":false},"min_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Min Scholarship Amount"},"recruiting_profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruiting Profile Url"},"highlight_video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Highlight Video Url"},"contacted_by_coaches":{"type":"boolean","title":"Contacted By Coaches","default":false},"recruited_schools":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruited Schools"},"open_to_coach_contact":{"type":"boolean","title":"Open To Coach Contact","default":true},"preferred_contact_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Contact Method"},"best_contact_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Contact Time"},"injury_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Injury History"},"additional_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Notes"},"profile_completed":{"type":"boolean","title":"Profile Completed","default":false},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"}},"type":"object","required":["profile_id"],"title":"ProfileAthleticsCreate"},"ProfileAthleticsOut":{"properties":{"primary_sport":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Sport"},"sports_interested":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sports Interested"},"position_played":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position Played"},"secondary_positions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Positions"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"club_team":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Club Team"},"high_school_team":{"type":"boolean","title":"High School Team","default":false},"travel_team":{"type":"boolean","title":"Travel Team","default":false},"athletic_stats":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Stats"},"personal_records":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Records"},"competition_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competition Level"},"awards_honors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Awards Honors"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"all_state":{"type":"boolean","title":"All State","default":false},"all_conference":{"type":"boolean","title":"All Conference","default":false},"captain":{"type":"boolean","title":"Captain","default":false},"preferred_division_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Division Levels"},"preferred_conferences":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Conferences"},"scholarship_required":{"type":"boolean","title":"Scholarship Required","default":false},"min_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Min Scholarship Amount"},"recruiting_profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruiting Profile Url"},"highlight_video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Highlight Video Url"},"contacted_by_coaches":{"type":"boolean","title":"Contacted By Coaches","default":false},"recruited_schools":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruited Schools"},"open_to_coach_contact":{"type":"boolean","title":"Open To Coach Contact","default":true},"preferred_contact_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Contact Method"},"best_contact_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Contact Time"},"injury_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Injury History"},"additional_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Notes"},"profile_completed":{"type":"boolean","title":"Profile Completed","default":false},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","profile_id","created_at","updated_at"],"title":"ProfileAthleticsOut"},"ProfileAthleticsUpdate":{"properties":{"primary_sport":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Sport"},"sports_interested":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sports Interested"},"position_played":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position Played"},"secondary_positions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Positions"},"years_experience":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Experience"},"club_team":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Club Team"},"high_school_team":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"High School Team"},"travel_team":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Travel Team"},"athletic_stats":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Athletic Stats"},"personal_records":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Records"},"competition_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competition Level"},"awards_honors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Awards Honors"},"championships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships"},"all_state":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"All State"},"all_conference":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"All Conference"},"captain":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Captain"},"preferred_division_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Division Levels"},"preferred_conferences":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Conferences"},"scholarship_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Scholarship Required"},"min_scholarship_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Min Scholarship Amount"},"recruiting_profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruiting Profile Url"},"highlight_video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Highlight Video Url"},"contacted_by_coaches":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Contacted By Coaches"},"recruited_schools":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Recruited Schools"},"open_to_coach_contact":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Open To Coach Contact"},"preferred_contact_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Contact Method"},"best_contact_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Contact Time"},"injury_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Injury History"},"additional_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Notes"},"profile_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Profile Completed"}},"type":"object","title":"ProfileAthleticsUpdate"},"ProfileCompletenessResponse":{"properties":{"overall_percentage":{"type":"number","title":"Overall Percentage"},"profile_completed":{"type":"boolean","title":"Profile Completed"},"required_complete":{"type":"boolean","title":"Required Complete","default":true},"sections":{"additionalProperties":{"$ref":"#/components/schemas/ProfileSectionDetail"},"type":"object","title":"Sections"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["overall_percentage","profile_completed","sections","last_updated"],"title":"ProfileCompletenessResponse","description":"Profile completeness metrics across all sections."},"ProfileCreate":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Phone"},"current_gpa":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"number","maximum":4.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"matching_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matching Preferences"},"for_child":{"type":"boolean","title":"For Child","default":false}},"type":"object","title":"ProfileCreate","description":"Schema for creating a new profile."},"ProfileDocumentList":{"properties":{"documents":{"items":{"$ref":"#/components/schemas/ProfileDocumentResponse"},"type":"array","title":"Documents"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["documents","total","page","page_size"],"title":"ProfileDocumentList","description":"Schema for paginated document list."},"ProfileDocumentResponse":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"document_type":{"$ref":"#/components/schemas/DocumentType"},"category":{"$ref":"#/components/schemas/DocumentCategory"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"file_name":{"type":"string","title":"File Name"},"file_path":{"type":"string","title":"File Path"},"file_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Url"},"file_size":{"type":"integer","title":"File Size"},"mime_type":{"type":"string","title":"Mime Type"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count"},"version":{"type":"integer","title":"Version"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"times_sent":{"type":"integer","title":"Times Sent"},"last_sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Sent At"}},"type":"object","required":["title","document_type","category","id","profile_id","file_name","file_path","file_size","mime_type","version","is_active","created_at","times_sent"],"title":"ProfileDocumentResponse","description":"Schema for document responses."},"ProfileDocumentUpdate":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string","maxLength":200000},{"type":"null"}],"title":"Content"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"document_type":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}]},"category":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"ProfileDocumentUpdate","description":"Schema for updating document metadata (and a text document's content, #769)."},"ProfileHandoverCreate":{"properties":{"child_email":{"type":"string","maxLength":254,"format":"email","title":"Child Email"}},"type":"object","required":["child_email"],"title":"ProfileHandoverCreate","description":"A parent handing a profile they started to their child (#875)."},"ProfileInvitationCreate":{"properties":{"role":{"type":"string","title":"Role","default":"shared"},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"can_view":{"type":"boolean","title":"Can View","default":true},"invitee_email":{"type":"string","title":"Invitee Email"}},"type":"object","required":["invitee_email"],"title":"ProfileInvitationCreate","description":"Schema for creating a profile invitation."},"ProfileInvitationOut":{"properties":{"role":{"type":"string","title":"Role","default":"shared"},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"can_view":{"type":"boolean","title":"Can View","default":true},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"inviter_id":{"type":"string","format":"uuid","title":"Inviter Id"},"invitee_email":{"type":"string","title":"Invitee Email"},"invitee_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Invitee Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"accepted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Accepted At"},"kind":{"type":"string","title":"Kind","default":"grant"},"profile":{"anyOf":[{"$ref":"#/components/schemas/ProfileOut"},{"type":"null"}]},"inviter":{"anyOf":[{"$ref":"#/components/schemas/InviterInfo"},{"type":"null"}]}},"type":"object","required":["id","profile_id","inviter_id","invitee_email","status","created_at","expires_at"],"title":"ProfileInvitationOut","description":"A profile invitation, as its sender sees it.\n\nNo token: it proves the invitee's address at sign-up (#873), so it goes\nonly to their mailbox and their own pending list (#978)."},"ProfileInvitationPending":{"properties":{"role":{"type":"string","title":"Role","default":"shared"},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"can_view":{"type":"boolean","title":"Can View","default":true},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"inviter_id":{"type":"string","format":"uuid","title":"Inviter Id"},"invitee_email":{"type":"string","title":"Invitee Email"},"invitee_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Invitee Id"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"accepted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Accepted At"},"kind":{"type":"string","title":"Kind","default":"grant"},"profile":{"anyOf":[{"$ref":"#/components/schemas/ProfileOut"},{"type":"null"}]},"inviter":{"anyOf":[{"$ref":"#/components/schemas/InviterInfo"},{"type":"null"}]},"token":{"type":"string","title":"Token"}},"type":"object","required":["id","profile_id","inviter_id","invitee_email","status","created_at","expires_at","token"],"title":"ProfileInvitationPending","description":"One of the signed-in user's own pending invitations, with its token.\n\nOnly ``GET /profiles/invitations/pending`` returns it, matched on the\ncaller's email. Never use it in a response to the inviter (#978)."},"ProfileOut":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Phone"},"current_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"matching_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matching Preferences"},"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"profile_completed":{"type":"boolean","title":"Profile Completed"},"profile_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Profile Last Updated"}},"type":"object","required":["id","created_at","profile_completed"],"title":"ProfileOut","description":"Schema for profile output."},"ProfileProgramCreate":{"properties":{"program_id":{"type":"string","format":"uuid","title":"Program Id"},"is_primary":{"type":"boolean","title":"Is Primary","default":false}},"type":"object","required":["program_id"],"title":"ProfileProgramCreate","description":"Schema for adding a program to a profile."},"ProfileProgramOut":{"properties":{"program_id":{"type":"string","format":"uuid","title":"Program Id"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"program":{"$ref":"#/components/schemas/ProgramSummary"}},"type":"object","required":["program_id","id","profile_id","created_at","program"],"title":"ProfileProgramOut","description":"Profile-program association with program details."},"ProfileSectionDetail":{"properties":{"filled":{"type":"integer","title":"Filled"},"total":{"type":"integer","title":"Total"},"percentage":{"type":"number","title":"Percentage"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"},"missing_required":{"items":{"type":"string"},"type":"array","title":"Missing Required","default":[]},"required_complete":{"type":"boolean","title":"Required Complete","default":true}},"type":"object","required":["filled","total","percentage","missing_fields"],"title":"ProfileSectionDetail","description":"Detail for a single profile section's completeness."},"ProfileTextDocumentCreate":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"content":{"type":"string","maxLength":200000,"title":"Content"},"document_type":{"$ref":"#/components/schemas/DocumentType","default":"essay"},"category":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["title","content"],"title":"ProfileTextDocumentCreate","description":"A document written in the app (#769): text, no file."},"ProfileUpdate":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Phone"},"current_gpa":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"number","maximum":4.0,"minimum":0.0},{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"matching_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matching Preferences"}},"type":"object","title":"ProfileUpdate","description":"Schema for updating an existing profile."},"ProfileWithAccess":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Phone"},"current_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"matching_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matching Preferences"},"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"profile_completed":{"type":"boolean","title":"Profile Completed"},"profile_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Profile Last Updated"},"role":{"type":"string","title":"Role"},"can_edit":{"type":"boolean","title":"Can Edit"},"can_view":{"type":"boolean","title":"Can View"},"is_primary":{"type":"boolean","title":"Is Primary"},"managed_by_parent":{"type":"boolean","title":"Managed By Parent","default":false},"pending_handover":{"anyOf":[{"$ref":"#/components/schemas/PendingHandoverOut"},{"type":"null"}]}},"type":"object","required":["id","created_at","profile_completed","role","can_edit","can_view","is_primary"],"title":"ProfileWithAccess","description":"Schema for profile with access information."},"ProfileWithPrograms":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Phone"},"current_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"matching_preferences":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matching Preferences"},"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"profile_completed":{"type":"boolean","title":"Profile Completed"},"profile_last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Profile Last Updated"},"programs":{"items":{"$ref":"#/components/schemas/ProfileProgramOut"},"type":"array","title":"Programs","default":[]}},"type":"object","required":["id","created_at","profile_completed"],"title":"ProfileWithPrograms","description":"Schema for profile with programs included."},"ProgramCategoryOut":{"properties":{"cip_2_digit":{"type":"string","title":"Cip 2 Digit"},"category_name":{"type":"string","title":"Category Name"},"program_count":{"type":"integer","title":"Program Count"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"}},"type":"object","required":["cip_2_digit","category_name","program_count"],"title":"ProgramCategoryOut","description":"Program category summary."},"ProgramComparisonResult":{"properties":{"programs":{"items":{"$ref":"#/components/schemas/ComparisonProgram"},"type":"array","title":"Programs"}},"type":"object","required":["programs"],"title":"ProgramComparisonResult"},"ProgramCurateSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"sport_name":{"type":"string","title":"Sport Name"},"gender":{"type":"string","title":"Gender"},"division_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Division Level"},"conference_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conference Name"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"},"team_wins":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Wins"},"team_losses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Losses"},"last_season_record":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Season Record"},"national_ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"National Ranking"},"conference_titles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Conference Titles"},"championships_won":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Championships Won"},"roster_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Roster Size"},"scholarships_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Scholarships Available"},"number_of_scholarships":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Scholarships"},"avg_scholarship_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Scholarship Amount"},"stadium_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadium Name"},"stadium_capacity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stadium Capacity"},"training_facilities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Training Facilities"},"recruitment_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Email"},"recruitment_contact_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recruitment Contact Phone"},"program_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Description"},"recent_achievements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent Achievements"},"confidence_scores":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Confidence Scores"},"data_sources":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Data Sources"},"last_scraped_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scraped At"}},"type":"object","required":["id","college_id","sport_name","gender","division_level","conference_name","subdivision","team_wins","team_losses","last_season_record","national_ranking","conference_titles","championships_won","roster_size","scholarships_available","number_of_scholarships","avg_scholarship_amount","stadium_name","stadium_capacity","training_facilities","recruitment_contact_email","recruitment_contact_phone","program_description","recent_achievements","confidence_scores","data_sources","last_scraped_at"],"title":"ProgramCurateSummary"},"ProgramOccupationOut":{"properties":{"occupation":{"$ref":"#/components/schemas/OccupationOut"},"relationship_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relationship Type"}},"type":"object","required":["occupation"],"title":"ProgramOccupationOut","description":"Schema for program-occupation relationship output."},"ProgramOut":{"properties":{"cip_code":{"type":"string","title":"Cip Code","description":"6-digit CIP code (e.g., '14.1001')"},"title":{"type":"string","title":"Title","description":"Program title/name"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Broad program category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Program description"},"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug","description":"URL-safe slug (canonical key for /programs/[slug])"},"cip_2_digit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cip 2 Digit","description":"2-digit CIP code for broad category"},"cip_4_digit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cip 4 Digit","description":"4-digit CIP code for program family"},"specializations":{"items":{"type":"string"},"type":"array","title":"Specializations","description":"Titles of the 6-digit programs in this field's CIP family (#1134). Filled on the college-programs and program-detail endpoints."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["cip_code","title","id","slug","created_at","updated_at"],"title":"ProgramOut","description":"Program output schema with all fields."},"ProgramPageTarget":{"properties":{"slug":{"type":"string","title":"Slug","description":"The requested program's own slug"},"cip_code":{"type":"string","title":"Cip Code","description":"The requested program's CIP code"},"page_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Slug","description":"Slug of the program whose page shows this program: its own slug, its 4-digit parent's, or None when a 6-digit program has no parent"},"cip_2_digit":{"type":"string","title":"Cip 2 Digit","description":"2-digit CIP category, the page when page_slug is None"}},"type":"object","required":["slug","cip_code","page_slug","cip_2_digit"],"title":"ProgramPageTarget","description":"Where a program's page lives (#773).\n\nPrograms exist at two CIP grains, and only the 4-digit program (\"11.07\")\nhas a page. A 6-digit program (\"11.0701\") is shown on its 4-digit parent's\npage, or on its category page when no parent row exists. SSR pages, the\n``[major]`` landers and the mobile shell read this to redirect."},"ProgramSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug"},"cip_code":{"type":"string","title":"Cip Code"},"title":{"type":"string","title":"Title"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},"type":"object","required":["id","slug","cip_code","title"],"title":"ProgramSummary","description":"Lightweight program summary for listings."},"ProgramWithOutcomes":{"properties":{"cip_code":{"type":"string","title":"Cip Code","description":"6-digit CIP code (e.g., '14.1001')"},"title":{"type":"string","title":"Title","description":"Program title/name"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Broad program category"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Program description"},"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug","description":"URL-safe slug (canonical key for /programs/[slug])"},"cip_2_digit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cip 2 Digit","description":"2-digit CIP code for broad category"},"cip_4_digit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cip 4 Digit","description":"4-digit CIP code for program family"},"specializations":{"items":{"type":"string"},"type":"array","title":"Specializations","description":"Titles of the 6-digit programs in this field's CIP family (#1134). Filled on the college-programs and program-detail endpoints."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"total_colleges":{"type":"integer","title":"Total Colleges","description":"Number of colleges offering this program as a bachelor's (#1138)","default":0},"total_listed":{"type":"integer","title":"Total Listed","description":"Rows in the program's college list: one per college and credential (#1138)","default":0},"avg_median_earnings":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Median Earnings","description":"Average median earnings across colleges"},"avg_earnings_1yr":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Earnings 1Yr","description":"Average 1-year earnings across colleges"},"total_graduates":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Graduates","description":"Total graduates across all colleges"}},"type":"object","required":["cip_code","title","id","slug","created_at","updated_at"],"title":"ProgramWithOutcomes","description":"Program with aggregated outcome metrics across all colleges."},"ProgrammaticFunnelTrendResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ProgrammaticFunnelTrendRow"},"type":"array","title":"Rows"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"}},"type":"object","required":["rows","since","until"],"title":"ProgrammaticFunnelTrendResponse","description":"Time-series response for the programmatic-funnel trends endpoint."},"ProgrammaticFunnelTrendRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"page_type":{"type":"string","enum":["best_colleges","cheapest_colleges","colleges_under","athletics","college_detail","article","all"],"title":"Page Type"},"page_views":{"type":"integer","title":"Page Views","default":0},"cta_clicks":{"type":"integer","title":"Cta Clicks","default":0},"signup_conversions":{"type":"integer","title":"Signup Conversions","default":0},"ctr":{"type":"number","title":"Ctr","default":0.0},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["metric_date","page_type"],"title":"ProgrammaticFunnelTrendRow","description":"One (date, page_type) row for the programmatic LP funnel time-series (#204)."},"ProgrammaticPage":{"properties":{"page_type":{"type":"string","title":"Page Type","description":"One of PageType.VALID_VALUES"},"canonical_url":{"type":"string","pattern":"^/[A-Za-z0-9/_-]+$","title":"Canonical Url","description":"Root-relative canonical path (no scheme/domain)"},"h1":{"type":"string","maxLength":200,"title":"H1"},"meta_title":{"type":"string","maxLength":60,"title":"Meta Title","description":"SERP title, without a brand suffix — the frontend title template appends one. Google truncates beyond ~60 chars."},"meta_description":{"type":"string","maxLength":160,"title":"Meta Description","description":"SERP snippet — Google truncates beyond ~160 chars"},"colleges":{"items":{"$ref":"#/components/schemas/CollegeSummary"},"type":"array","title":"Colleges"},"stats":{"additionalProperties":true,"type":"object","title":"Stats","description":"Template-specific summary stats; shape varies by page_type"},"related_pages":{"items":{"$ref":"#/components/schemas/RelatedPage"},"type":"array","title":"Related Pages"},"last_data_update":{"type":"string","format":"date-time","title":"Last Data Update","description":"Freshest ingest timestamp across the listed colleges"}},"type":"object","required":["page_type","canonical_url","h1","meta_title","meta_description","last_data_update"],"title":"ProgrammaticPage","description":"Single envelope consumed by every programmatic page template."},"PublicAdmissionsEventRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"timezone_inferred":{"type":"boolean","title":"Timezone Inferred","default":false},"all_day":{"type":"boolean","title":"All Day","default":false},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"is_virtual":{"type":"boolean","title":"Is Virtual","default":false},"registration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Url"},"source_url":{"type":"string","title":"Source Url"},"series_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series Key"},"instance_count":{"type":"integer","title":"Instance Count","default":1},"next_dates":{"items":{"type":"string","format":"date-time"},"type":"array","title":"Next Dates"},"instances":{"items":{"$ref":"#/components/schemas/AdmissionsEventInstance"},"type":"array","title":"Instances"},"recurrence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recurrence Text"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"license":{"type":"string","title":"License"}},"type":"object","required":["id","event_type","title","starts_at","source_url","license"],"title":"PublicAdmissionsEventRow","description":"One upcoming event (the first future instance of its series)."},"PublicAdmissionsEventsResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"canonical_events_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Events Url"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"rows":{"items":{"$ref":"#/components/schemas/PublicAdmissionsEventRow"},"type":"array","title":"Rows"},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Window End"},"latest_posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Posted At"},"later_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Later Count"},"in_window_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"In Window Count"}},"type":"object","required":["college_id","generated_at","rows"],"title":"PublicAdmissionsEventsResponse"},"PublicMediaResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"rows":{"items":{"$ref":"#/components/schemas/PublicMediaRow"},"type":"array","title":"Rows"}},"type":"object","required":["college_id","rows"],"title":"PublicMediaResponse","description":"Response envelope for the public media endpoint."},"PublicMediaRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"media_type":{"type":"string","title":"Media Type"},"url":{"type":"string","title":"Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"credit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credit"},"license":{"type":"string","title":"License"},"ordering":{"type":"integer","title":"Ordering"}},"type":"object","required":["id","media_type","url","thumbnail_url","caption","credit","license","ordering"],"title":"PublicMediaRow","description":"One media row as exposed to anonymous public consumers.\n\nAttribution-render contract: ``credit`` + ``license`` are MANDATORY\non every render — the frontend must surface these alongside the\nimage to satisfy Wikimedia CC attribution requirements (and good-\nfaith attribution on any future republishable source). Both fields\nare nullable in the schema only because some operator-curated\nrows may legitimately have no credit (operator's own attribution\ncaptured in the audit log)."},"PublicProfileShareOut":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"saved_colleges":{"items":{"$ref":"#/components/schemas/PublicSharedCollegeOut"},"type":"array","title":"Saved Colleges","default":[]}},"type":"object","title":"PublicProfileShareOut","description":"Public allowlist projection for /p/<token>.\n\nFields not listed here are NOT exposed to anonymous readers. Adding a\nProfile column requires explicit edit + privacy review."},"PublicReviewOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"rating":{"type":"integer","title":"Rating"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","college_id","rating","title","text","status","created_at","updated_at"],"title":"PublicReviewOut","description":"A review as anyone can read it (#990, threat model VR-019).\n\nNothing here names the author or links two reviews to the same student:\nevery reader sees \"Student\". The author's own reads add ``profile_id``."},"PublicSharedCollegeOut":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"status":{"type":"string","title":"Status"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"college":{"$ref":"#/components/schemas/CollegeOut"}},"type":"object","required":["college_id","status","college"],"title":"PublicSharedCollegeOut","description":"Saved-college projection for the public share page.\n\n`notes` is intentionally excluded — free-text personal commentary."},"RankingUpdate":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"ranking":{"type":"integer","title":"Ranking"}},"type":"object","required":["id","ranking"],"title":"RankingUpdate"},"RecentTaskExecution":{"properties":{"task_id":{"type":"string","title":"Task Id"},"task_name":{"type":"string","title":"Task Name"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["task_id","task_name","description","status","timestamp","duration_ms","error_message","metadata"],"title":"RecentTaskExecution","description":"Recent task execution from audit logs."},"RecommendationBreakdown":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"dimensions":{"items":{"$ref":"#/components/schemas/RecommendationDimension"},"type":"array","title":"Dimensions"},"overall":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall","description":"Composite content score, 0-1, when the ranking supplied one"}},"type":"object","required":["college_id","dimensions"],"title":"RecommendationBreakdown","description":"Why a college was recommended — the deterministic dimensions behind the score.\n\nServed on demand rather than on every list row: the breakdown renders on tap,\nand computing it per page would cost a profile load on the recommendations\ncache-hit path, which is the hot path that whole service is built around.\n\nThis is a **computed fact**, not a prediction — every dimension is arithmetic\nover the student's stated profile and published college data, with no model\ncomponent (ARCHITECTURE.md §\"Inline predictions\"). Behavioural fit is\ndeliberately excluded: it explains click history, not content fit, and a\nstudent cannot check it against anything."},"RecommendationDimension":{"properties":{"key":{"type":"string","title":"Key","description":"Stable dimension key, e.g. 'academic'"},"label":{"type":"string","title":"Label","description":"Display label, e.g. 'Academic fit'"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score","description":"This dimension's fit, 0-1"},"weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Weight","description":"Its share of the content score"}},"type":"object","required":["key","label","score","weight"],"title":"RecommendationDimension","description":"One dimension behind a college's recommendation score."},"RecommendedCollege":{"properties":{"college":{"$ref":"#/components/schemas/CollegeOut"},"recommendation_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recommendation Score"},"admission_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admission Tier"}},"type":"object","required":["college"],"title":"RecommendedCollege","description":"Single college recommendation with score and admission tier."},"RecommendedCollegesResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/RecommendedCollege"},"type":"array","title":"Recommendations"},"count":{"type":"integer","title":"Count"},"total":{"type":"integer","title":"Total","default":0}},"type":"object","required":["recommendations","count"],"title":"RecommendedCollegesResponse","description":"Personalized college recommendations for a student profile."},"RecruitingEventCreate":{"properties":{"athletic_program_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Athletic Program Id"},"event_type":{"type":"string","enum":["camp","showcase","visit","deadline","tryout","signing_day","other"],"title":"Event Type"},"title":{"type":"string","maxLength":255,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_date":{"type":"string","format":"date-time","title":"Event Date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location"},"reminder_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reminder Date"},"is_completed":{"type":"boolean","title":"Is Completed","default":false}},"type":"object","required":["event_type","title","event_date"],"title":"RecruitingEventCreate"},"RecruitingEventOut":{"properties":{"athletic_program_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Athletic Program Id"},"event_type":{"type":"string","enum":["camp","showcase","visit","deadline","tryout","signing_day","other"],"title":"Event Type"},"title":{"type":"string","maxLength":255,"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_date":{"type":"string","format":"date-time","title":"Event Date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location"},"reminder_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reminder Date"},"is_completed":{"type":"boolean","title":"Is Completed","default":false},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["event_type","title","event_date","id","profile_id","created_at","updated_at"],"title":"RecruitingEventOut"},"RecruitingEventUpdate":{"properties":{"athletic_program_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Athletic Program Id"},"event_type":{"anyOf":[{"type":"string","enum":["camp","showcase","visit","deadline","tryout","signing_day","other"]},{"type":"null"}],"title":"Event Type"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"end_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"},"location":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Location"},"reminder_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reminder Date"},"is_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Completed"}},"type":"object","title":"RecruitingEventUpdate"},"RegisterResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"type":"string","title":"Message","default":"Check your email to confirm your account."},"email_masked":{"type":"string","title":"Email Masked"},"verified":{"type":"boolean","title":"Verified","default":false},"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"},"registrant_proof":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registrant Proof"}},"type":"object","required":["email_masked"],"title":"RegisterResponse","description":"Response to ``POST /auth/register`` after the email-verification gate\n(#364). No JWT, no UUID — the caller must NOT auto-login — except when an\nemail invitation proved the address (#873, ``verified``/``access_token``). Frontend\nflips to a \"Check your inbox\" state. ``email_masked`` is the obscured\naddress (e.g. ``j***@gmail.com``) for the success copy."},"RelatedPage":{"properties":{"title":{"type":"string","maxLength":120,"title":"Title"},"url":{"type":"string","pattern":"^/[A-Za-z0-9/_-]+$","title":"Url"}},"type":"object","required":["title","url"],"title":"RelatedPage","description":"One entry in the ``related_pages`` internal-linking block."},"ResendVerificationRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"return_to":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Return To"}},"type":"object","required":["email"],"title":"ResendVerificationRequest"},"ResendVerificationResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"type":"string","title":"Message","default":"If that account exists and isn't verified, a new link has been sent."}},"type":"object","title":"ResendVerificationResponse"},"ReservedMessage":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"queue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Queue"}},"type":"object","title":"ReservedMessage","description":"One message a worker has prefetched but not started."},"ResetPasswordWithTokenRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordWithTokenRequest"},"ResolvedAlumnus":{"properties":{"text":{"type":"string","title":"Text"},"extra":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra"},"source_docs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Docs"}},"type":"object","required":["text","source_docs"],"title":"ResolvedAlumnus","description":"One entry from a JSONB list (notable_alumni / top_researchers /\nresearch_areas) with its source docs joined for URL/title resolution."},"ResolvedCitation":{"properties":{"claim_text":{"type":"string","title":"Claim Text"},"field":{"type":"string","title":"Field"},"source_docs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Docs"}},"type":"object","required":["claim_text","field","source_docs"],"title":"ResolvedCitation","description":"A citation from the JSONB blob, joined to the source doc for\nURL/title resolution. The synthesis row stores claim_text +\nsource_doc_ids; this view joins those IDs back to the underlying\ndocs so the admin UI can render clickable source links."},"RevalidateFrontendRequest":{"properties":{"college_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"College Id"}},"type":"object","title":"RevalidateFrontendRequest","description":"Optional revalidation scope. Omit ``college_id`` (or send ``null``) to\nrefresh EVERY college's live pages (broad ``colleges`` tag); supply one to\nrefresh just that college's pages (``college:{uuid}`` tag).\n\nTyped as ``UUID`` so a malformed id is rejected with 422 rather than\nbuilding a bogus ``college:<garbage>`` tag the frontend would reject."},"ReviewCreate":{"properties":{"rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Rating"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Text"}},"type":"object","required":["rating"],"title":"ReviewCreate"},"ReviewFlagRequest":{"properties":{"reason":{"type":"string","maxLength":200,"minLength":1,"title":"Reason"}},"type":"object","required":["reason"],"title":"ReviewFlagRequest"},"ReviewFlagResponse":{"properties":{"detail":{"type":"string","title":"Detail"}},"type":"object","required":["detail"],"title":"ReviewFlagResponse","description":"Acknowledgement returned after flagging a review for moderation."},"ReviewOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"rating":{"type":"integer","title":"Rating"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"}},"type":"object","required":["id","college_id","rating","title","text","status","created_at","updated_at","profile_id"],"title":"ReviewOut","description":"The author's own review, returned only on their authenticated reads.\n\n``profile_id`` is the caller's own, kept because installed app versions\nmatch their review on it."},"ReviewSummaryOut":{"properties":{"average_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Rating"},"review_count":{"type":"integer","title":"Review Count"},"reviews":{"items":{"$ref":"#/components/schemas/PublicReviewOut"},"type":"array","title":"Reviews"}},"type":"object","required":["average_rating","review_count","reviews"],"title":"ReviewSummaryOut"},"ReviewUpdate":{"properties":{"rating":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Rating"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Text"}},"type":"object","title":"ReviewUpdate"},"RevokeTaskResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"revoke_requested":{"type":"boolean","title":"Revoke Requested"},"terminate":{"type":"boolean","title":"Terminate"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["task_id","revoke_requested","terminate","detail"],"title":"RevokeTaskResponse","description":"Deliberately says *requested*, never \"revoked\".\n\n``control.revoke`` is a fire-and-forget broadcast with no return value: it\ntells workers to add the id to an in-memory set, the message stays in the\nbroker until a worker pops it, and the set is lost on worker restart (the\nworker commands in render.yaml carry no ``--statedb``). Claiming success\nhere would be a lie the UI would then repeat."},"RoadmapOut":{"properties":{"family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"stage":{"type":"string","title":"Stage"},"needs_grade":{"type":"boolean","title":"Needs Grade"},"next_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Step"},"steps":{"items":{"$ref":"#/components/schemas/RoadmapStepOut"},"type":"array","title":"Steps"}},"type":"object","required":["family","graduation_year","stage","needs_grade","next_step","steps"],"title":"RoadmapOut"},"RoadmapPreviewOut":{"properties":{"family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"stage":{"type":"string","title":"Stage"},"next_step":{"anyOf":[{"$ref":"#/components/schemas/RoadmapStepOut"},{"type":"null"}]},"then":{"items":{"$ref":"#/components/schemas/RoadmapStepOut"},"type":"array","title":"Then"}},"type":"object","required":["family","graduation_year","stage","next_step","then"],"title":"RoadmapPreviewOut"},"RoadmapPreviewRequest":{"properties":{"grade":{"anyOf":[{"type":"string","enum":["9","10","11","12","not_in_high_school"]},{"type":"null"}],"title":"Grade"},"done_keys":{"items":{"type":"string","maxLength":40},"type":"array","maxItems":20,"title":"Done Keys"}},"additionalProperties":false,"type":"object","title":"RoadmapPreviewRequest","description":"The anonymous intake's answers. No PII by construction: extra fields\nare rejected, so a name or an email can't ride along (ARCHITECTURE\n§\"Persona Pathways\" 2 and 6)."},"RoadmapStepOut":{"properties":{"key":{"type":"string","title":"Key"},"title":{"type":"string","title":"Title"},"why":{"type":"string","title":"Why"},"source":{"type":"string","title":"Source"},"status":{"type":"string","enum":["done","not_done"],"title":"Status"},"state":{"type":"string","enum":["done","now","upcoming","past"],"title":"State"},"start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start"},"due":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Due"},"start_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Label"},"help_href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help Href"}},"type":"object","required":["key","title","why","source","status","state"],"title":"RoadmapStepOut"},"RosterAttentionRead":{"properties":{"scope":{"type":"string","enum":["caseload","organization"],"title":"Scope"},"truncated":{"type":"boolean","title":"Truncated"},"students":{"items":{"$ref":"#/components/schemas/AttentionStudent"},"type":"array","title":"Students"},"by_counselor":{"anyOf":[{"items":{"$ref":"#/components/schemas/AttentionRollup"},"type":"array"},{"type":"null"}],"title":"By Counselor"}},"type":"object","required":["scope","truncated","students","by_counselor"],"title":"RosterAttentionRead"},"RouteLeg":{"properties":{"stop_id":{"type":"string","format":"uuid","title":"Stop Id"},"leg_distance_miles":{"anyOf":[{"type":"number","maximum":25000.0,"minimum":0.0},{"type":"null"}],"title":"Leg Distance Miles"},"leg_drive_minutes":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Leg Drive Minutes"},"day_index":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Day Index"}},"type":"object","required":["stop_id"],"title":"RouteLeg"},"RouteUpdateRequest":{"properties":{"total_distance_miles":{"anyOf":[{"type":"number","maximum":25000.0,"minimum":0.0},{"type":"null"}],"title":"Total Distance Miles"},"total_drive_minutes":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Total Drive Minutes"},"legs":{"items":{"$ref":"#/components/schemas/RouteLeg"},"type":"array","title":"Legs"}},"type":"object","title":"RouteUpdateRequest","description":"Client-computed route cache (see Itinerary model docstring)."},"SAIBreakdown":{"properties":{"parent_income_contribution":{"type":"integer","title":"Parent Income Contribution"},"parent_asset_contribution":{"type":"integer","title":"Parent Asset Contribution"},"student_income_contribution":{"type":"integer","title":"Student Income Contribution"},"student_asset_contribution":{"type":"integer","title":"Student Asset Contribution"},"total_allowances":{"type":"integer","title":"Total Allowances"},"available_income":{"type":"integer","title":"Available Income"}},"type":"object","required":["parent_income_contribution","parent_asset_contribution","student_income_contribution","student_asset_contribution","total_allowances","available_income"],"title":"SAIBreakdown"},"SAICalculationRequest":{"properties":{"parent_income":{"type":"number","minimum":0.0,"title":"Parent Income","description":"Parents' adjusted gross income"},"parent_assets":{"type":"number","minimum":0.0,"title":"Parent Assets","description":"Parents' assets (cash, savings, investments)","default":0},"student_income":{"type":"number","minimum":0.0,"title":"Student Income","description":"Student's income","default":0},"student_assets":{"type":"number","minimum":0.0,"title":"Student Assets","description":"Student's assets","default":0},"family_size":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Family Size","description":"Number in parents' household","default":4},"num_in_college":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Num In College","description":"Number in college at same time","default":1},"state_tax_rate":{"type":"number","maximum":0.15,"minimum":0.0,"title":"State Tax Rate","description":"State income tax rate","default":0.05}},"type":"object","required":["parent_income"],"title":"SAICalculationRequest","description":"Request body for SAI calculation."},"SAICalculationResponse":{"properties":{"sai":{"type":"integer","title":"Sai"},"parent_contribution":{"type":"integer","title":"Parent Contribution"},"student_contribution":{"type":"integer","title":"Student Contribution"},"breakdown":{"$ref":"#/components/schemas/SAIBreakdown"},"pell_eligible":{"type":"boolean","title":"Pell Eligible"},"estimated_pell_grant":{"type":"integer","title":"Estimated Pell Grant"},"disclaimer":{"type":"string","title":"Disclaimer"}},"type":"object","required":["sai","parent_contribution","student_contribution","breakdown","pell_eligible","estimated_pell_grant","disclaimer"],"title":"SAICalculationResponse"},"SampleRecipient":{"properties":{"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["email"],"title":"SampleRecipient","description":"A sample recipient shown in preview."},"SaveCollegeRequest":{"properties":{"college_id":{"type":"string","title":"College Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"type":"string","enum":["interested","applying","applied","waitlisted","deferred","accepted","rejected","enrolled","not_interested"],"title":"Status","default":"interested"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"}},"type":"object","required":["college_id"],"title":"SaveCollegeRequest"},"SavedAthleticProgramCreate":{"properties":{"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["athletic_program_id"],"title":"SavedAthleticProgramCreate"},"SavedAthleticProgramOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"athletic_program_id":{"type":"string","format":"uuid","title":"Athletic Program Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"college_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Name"},"sport_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sport Name"},"program_gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Program Gender"}},"type":"object","required":["id","profile_id","athletic_program_id","created_at"],"title":"SavedAthleticProgramOut"},"SavedCollegeAdmissionsEventRow":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"timezone_inferred":{"type":"boolean","title":"Timezone Inferred","default":false},"all_day":{"type":"boolean","title":"All Day","default":false},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"is_virtual":{"type":"boolean","title":"Is Virtual","default":false},"registration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Url"},"source_url":{"type":"string","title":"Source Url"},"series_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series Key"},"instance_count":{"type":"integer","title":"Instance Count","default":1},"next_dates":{"items":{"type":"string","format":"date-time"},"type":"array","title":"Next Dates"},"instances":{"items":{"$ref":"#/components/schemas/AdmissionsEventInstance"},"type":"array","title":"Instances"},"recurrence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recurrence Text"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"license":{"type":"string","title":"License"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"}},"type":"object","required":["id","event_type","title","starts_at","source_url","license","college_id","college_name"],"title":"SavedCollegeAdmissionsEventRow","description":"The same event, plus which of the student's saved colleges runs it (#696).\n\n``/visits`` lists events across schools, so the college is the part the\nstudent is scanning for — it cannot be implicit the way it is on\n``/colleges/[id]``. ``college_slug`` is the canonical link target (#246);\n``college_id`` is the fallback when a college has no slug yet.\n\n``timezone`` here is **resolved**: the row's own zone when the listing\npublished one, otherwise the zone inferred from the campus state — and\n``timezone_inferred`` is set in that case, which is what keeps the \"local\ntime\" wording honest. Rendering in the viewer's browser zone would be the\none genuinely wrong answer for a campus visit."},"SavedCollegeEventsSummary":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"latest_posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Posted At"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"events_in_window":{"type":"integer","title":"Events In Window","default":0},"later_count":{"type":"integer","title":"Later Count","default":0}},"type":"object","required":["college_id","college_name"],"title":"SavedCollegeEventsSummary","description":"One saved college's place in a windowed ``/visits`` read (#806).\n\nLets the page say \"Northwood has posted through Oct 29\" and \"Denison hasn't\nposted any dates yet\", which the rows alone can't: a college with nothing in\nthe window has no rows."},"SavedCollegeOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"college_id":{"type":"string","format":"uuid","title":"College Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"type":"string","title":"Status"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"college":{"$ref":"#/components/schemas/CollegeOut"}},"type":"object","required":["id","college_id","status","created_at","college"],"title":"SavedCollegeOut"},"SavedCollegesAdmissionsEventsResponse":{"properties":{"saved_college_count":{"type":"integer","title":"Saved College Count"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"rows":{"items":{"$ref":"#/components/schemas/SavedCollegeAdmissionsEventRow"},"type":"array","title":"Rows"},"window_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Window End"},"colleges":{"anyOf":[{"items":{"$ref":"#/components/schemas/SavedCollegeEventsSummary"},"type":"array"},{"type":"null"}],"title":"Colleges"}},"type":"object","required":["saved_college_count","generated_at","rows"],"title":"SavedCollegesAdmissionsEventsResponse"},"SavedScholarshipCreate":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"type":"string","enum":["saved","in_progress","submitted","awarded","rejected","withdrawn","not_interested"],"title":"Status","default":"saved"}},"type":"object","required":["scholarship_id"],"title":"SavedScholarshipCreate"},"SavedScholarshipOut":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"type":"string","title":"Status"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["scholarship_id","status","id","profile_id","created_at","updated_at"],"title":"SavedScholarshipOut"},"SavedScholarshipUpdate":{"properties":{"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"anyOf":[{"type":"string","enum":["saved","in_progress","submitted","awarded","rejected","withdrawn","not_interested"]},{"type":"null"}],"title":"Status"}},"type":"object","title":"SavedScholarshipUpdate"},"SavedScholarshipWithDetails":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"type":"string","title":"Status"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"scholarship":{"$ref":"#/components/schemas/ScholarshipOut"}},"type":"object","required":["scholarship_id","status","id","profile_id","created_at","updated_at","scholarship"],"title":"SavedScholarshipWithDetails","description":"Saved scholarship with full scholarship details."},"SavedSearchCreate":{"properties":{"surface":{"type":"string","enum":["colleges","scholarships","merit_scholarships","athletics"],"title":"Surface"},"name":{"type":"string","maxLength":80,"title":"Name"},"query_string":{"type":"string","maxLength":2000,"title":"Query String"}},"type":"object","required":["surface","name","query_string"],"title":"SavedSearchCreate"},"SavedSearchOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"surface":{"type":"string","enum":["colleges","scholarships","merit_scholarships","athletics"],"title":"Surface"},"name":{"type":"string","title":"Name"},"query_string":{"type":"string","title":"Query String"},"filter_count":{"type":"integer","title":"Filter Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","surface","name","query_string","filter_count","created_at"],"title":"SavedSearchOut"},"SavedSearchRename":{"properties":{"name":{"type":"string","maxLength":80,"title":"Name"}},"type":"object","required":["name"],"title":"SavedSearchRename"},"ScholarshipApplicationCreate":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"status":{"type":"string","title":"Status","default":"saved"},"priority":{"type":"integer","title":"Priority","default":3},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"application_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Link"}},"type":"object","required":["scholarship_id"],"title":"ScholarshipApplicationCreate"},"ScholarshipApplicationOut":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"status":{"type":"string","title":"Status","default":"saved"},"priority":{"type":"integer","title":"Priority","default":3},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"application_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Link"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"progress_percentage":{"type":"integer","title":"Progress Percentage"},"submitted_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Submitted Date"},"result_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Result Date"},"award_amount_received":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Award Amount Received"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["scholarship_id","id","profile_id","progress_percentage","submitted_date","result_date","award_amount_received","created_at","updated_at"],"title":"ScholarshipApplicationOut"},"ScholarshipApplicationUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority"},"progress_percentage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Progress Percentage"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"application_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Link"},"submitted_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Submitted Date"},"result_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Result Date"},"award_amount_received":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Award Amount Received"}},"type":"object","title":"ScholarshipApplicationUpdate"},"ScholarshipApplicationWithDetails":{"properties":{"scholarship_id":{"type":"string","format":"uuid","title":"Scholarship Id"},"status":{"type":"string","title":"Status","default":"saved"},"priority":{"type":"integer","title":"Priority","default":3},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"application_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Link"},"id":{"type":"string","format":"uuid","title":"Id"},"profile_id":{"type":"string","format":"uuid","title":"Profile Id"},"progress_percentage":{"type":"integer","title":"Progress Percentage"},"submitted_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Submitted Date"},"result_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Result Date"},"award_amount_received":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Award Amount Received"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"scholarship":{"$ref":"#/components/schemas/ScholarshipOut"}},"type":"object","required":["scholarship_id","id","profile_id","progress_percentage","submitted_date","result_date","award_amount_received","created_at","updated_at","scholarship"],"title":"ScholarshipApplicationWithDetails","description":"Application with full scholarship details."},"ScholarshipBrowseItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"}},"type":"object","required":["id","name"],"title":"ScholarshipBrowseItem"},"ScholarshipBrowsePage":{"properties":{"page":{"type":"integer","title":"Page"},"page_count":{"type":"integer","title":"Page Count"},"page_size":{"type":"integer","title":"Page Size"},"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ScholarshipBrowseItem"},"type":"array","title":"Items"},"pages":{"items":{"$ref":"#/components/schemas/ScholarshipBrowsePageRange"},"type":"array","title":"Pages"}},"type":"object","required":["page","page_count","page_size","total","items","pages"],"title":"ScholarshipBrowsePage","description":"`GET /scholarships/browse` (#885): one page of the A–Z index.\n\n`pages` labels every page by its name range, for the page strip."},"ScholarshipBrowsePageRange":{"properties":{"page":{"type":"integer","title":"Page"},"first_name":{"type":"string","title":"First Name"},"last_name":{"type":"string","title":"Last Name"}},"type":"object","required":["page","first_name","last_name"],"title":"ScholarshipBrowsePageRange","description":"One page of the A–Z browse index and the names it runs between."},"ScholarshipCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"provider":{"type":"string","title":"Provider"},"provider_type":{"type":"string","title":"Provider Type"},"award_amount_min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Award Amount Min"},"award_amount_max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Award Amount Max"},"award_type":{"type":"string","title":"Award Type"},"number_of_awards":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Awards"},"renewable":{"type":"boolean","title":"Renewable","default":false},"renewable_years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Renewable Years"},"application_deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Application Deadline"},"award_notification_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Award Notification Date"},"recurring_annually":{"type":"boolean","title":"Recurring Annually","default":true},"min_gpa":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Min Gpa"},"min_sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat"},"min_act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act"},"grade_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Grade Levels"},"majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Majors"},"states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"States"},"citizenship_required":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Required"},"qualifications":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qualifications"},"demographic_criteria":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Demographic Criteria"},"extracurricular_focus":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurricular Focus"},"financial_need_based":{"type":"boolean","title":"Financial Need Based","default":false},"merit_based":{"type":"boolean","title":"Merit Based","default":false},"essay_required":{"type":"boolean","title":"Essay Required","default":false},"essay_topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Essay Topics"},"transcript_required":{"type":"boolean","title":"Transcript Required","default":false},"recommendation_letters_count":{"type":"integer","title":"Recommendation Letters Count","default":0},"additional_requirements":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Requirements"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"information_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Information Url"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"source":{"type":"string","title":"Source"},"verified":{"type":"boolean","title":"Verified","default":false},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["name","provider","provider_type","award_type","source"],"title":"ScholarshipCreate"},"ScholarshipMatch":{"properties":{"scholarship":{"$ref":"#/components/schemas/ScholarshipOut"},"match_score":{"type":"number","title":"Match Score"},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons"},"score_components":{"items":{"$ref":"#/components/schemas/MatchScoreComponent"},"type":"array","title":"Score Components"}},"type":"object","required":["scholarship","match_score","match_reasons"],"title":"ScholarshipMatch","description":"Scholarship with match score and reasons."},"ScholarshipMatchAnswers":{"properties":{"grade_level":{"type":"string","enum":["9","10","11","12","undergraduate","graduate"],"title":"Grade Level"},"gpa_range":{"type":"string","enum":["under-2.5","2.5-3.0","3.0-3.5","3.5-3.8","3.8-plus"],"title":"Gpa Range"},"state":{"type":"string","maxLength":2,"minLength":2,"title":"State","description":"Two-letter US state code"},"intended_major":{"type":"string","maxLength":120,"minLength":1,"title":"Intended Major"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"extracurriculars":{"items":{"type":"string","enum":["sports","arts","leadership","community_service","stem","student_government","religious","academic_clubs"]},"type":"array","maxItems":8,"title":"Extracurriculars"},"citizenship":{"anyOf":[{"type":"string","enum":["us_citizen","permanent_resident","daca","refugee","international","other"]},{"type":"null"}],"title":"Citizenship"},"financial_need":{"anyOf":[{"type":"string","enum":["yes","no","unsure"]},{"type":"null"}],"title":"Financial Need"}},"type":"object","required":["grade_level","gpa_range","state","intended_major"],"title":"ScholarshipMatchAnswers","description":"Raw quiz inputs collected by the frontend form.\n\nField shapes mirror :class:`frontend/.../ScholarshipMatchQuiz.tsx`. All\nnine questions are present; ``sat_score``, ``act_score``, ``citizenship``,\nand ``financial_need`` are nullable because the quiz lets students skip\nthem without penalty."},"ScholarshipMatchEnvelope":{"properties":{"matches":{"items":{"$ref":"#/components/schemas/ScholarshipMatchResult"},"type":"array","maxItems":10,"title":"Matches"},"total_matches":{"type":"integer","minimum":0.0,"title":"Total Matches"},"has_more":{"type":"boolean","title":"Has More"},"total_award_amount_cents":{"type":"integer","minimum":0.0,"title":"Total Award Amount Cents","description":"Sum of amount_max_cents across the returned matches; used for the OG headline."},"disclaimer":{"type":"string","title":"Disclaimer"}},"type":"object","required":["matches","total_matches","has_more","total_award_amount_cents","disclaimer"],"title":"ScholarshipMatchEnvelope"},"ScholarshipMatchResult":{"properties":{"scholarship_id":{"type":"string","title":"Scholarship Id"},"name":{"type":"string","title":"Name"},"amount":{"type":"string","title":"Amount","description":"Pre-formatted display string, e.g. '$2,500' or '$1,000 – $5,000'"},"amount_max_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Max Cents","description":"Numeric ceiling in cents; used for the OG headline sum. None when amount is unknown."},"deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Deadline"},"one_line_eligibility":{"type":"string","maxLength":120,"title":"One Line Eligibility"},"detail_url":{"type":"string","title":"Detail Url","description":"Internal path: /scholarships/{id}"},"match_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Match Score"},"score_components":{"items":{"$ref":"#/components/schemas/MatchScoreComponent"},"type":"array","title":"Score Components"}},"type":"object","required":["scholarship_id","name","amount","deadline","one_line_eligibility","detail_url","match_score"],"title":"ScholarshipMatchResult"},"ScholarshipMatchRunRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"answers":{"$ref":"#/components/schemas/ScholarshipMatchAnswers"}},"type":"object","required":["session_id","answers"],"title":"ScholarshipMatchRunRequest"},"ScholarshipMatchRunResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"result":{"$ref":"#/components/schemas/ScholarshipMatchEnvelope"}},"type":"object","required":["session_id","result"],"title":"ScholarshipMatchRunResponse"},"ScholarshipOut":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"provider":{"type":"string","title":"Provider"},"provider_type":{"type":"string","title":"Provider Type"},"award_amount_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Award Amount Min"},"award_amount_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Award Amount Max"},"award_type":{"type":"string","title":"Award Type"},"number_of_awards":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Number Of Awards"},"renewable":{"type":"boolean","title":"Renewable","default":false},"renewable_years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Renewable Years"},"application_deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Application Deadline"},"award_notification_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Award Notification Date"},"recurring_annually":{"type":"boolean","title":"Recurring Annually","default":true},"min_gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Gpa"},"min_sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Sat"},"min_act":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Act"},"grade_levels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Grade Levels"},"majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Majors"},"states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"States"},"citizenship_required":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Required"},"qualifications":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qualifications"},"demographic_criteria":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Demographic Criteria"},"extracurricular_focus":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurricular Focus"},"financial_need_based":{"type":"boolean","title":"Financial Need Based","default":false},"merit_based":{"type":"boolean","title":"Merit Based","default":false},"essay_required":{"type":"boolean","title":"Essay Required","default":false},"essay_topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Essay Topics"},"transcript_required":{"type":"boolean","title":"Transcript Required","default":false},"recommendation_letters_count":{"type":"integer","title":"Recommendation Letters Count","default":0},"additional_requirements":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Requirements"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"information_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Information Url"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"source":{"type":"string","title":"Source"},"verified":{"type":"boolean","title":"Verified","default":false},"is_active":{"type":"boolean","title":"Is Active","default":true},"id":{"type":"string","format":"uuid","title":"Id"},"last_verified_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified Date"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"canonical_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Canonical Id"},"name_is_shared":{"type":"boolean","title":"Name Is Shared","default":false}},"type":"object","required":["name","provider","provider_type","award_type","source","id","last_verified_date","created_at","updated_at"],"title":"ScholarshipOut"},"ScholarshipSavedStatus":{"properties":{"is_saved":{"type":"boolean","title":"Is Saved"},"saved_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Saved Id"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["is_saved"],"title":"ScholarshipSavedStatus","description":"Whether the current profile has saved a given scholarship."},"ScholarshipSearchResponse":{"properties":{"scholarships":{"items":{"$ref":"#/components/schemas/ScholarshipOut"},"type":"array","title":"Scholarships"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["scholarships","total"],"title":"ScholarshipSearchResponse","description":"Paginated scholarship search results."},"ScholarshipUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"provider_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Type"},"award_amount_min":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Award Amount Min"},"award_amount_max":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Award Amount Max"},"award_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Award Type"},"application_deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Application Deadline"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"ScholarshipUpdate"},"SchoolOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"ncessch":{"type":"string","title":"Ncessch"},"school_name":{"type":"string","title":"School Name"},"lea_name":{"type":"string","title":"Lea Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"type":"string","title":"State"},"school_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School Level"},"grade_low":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Low"},"grade_high":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade High"},"is_charter":{"type":"boolean","title":"Is Charter"}},"type":"object","required":["id","ncessch","school_name","lea_name","city","state","school_level","grade_low","grade_high","is_charter"],"title":"SchoolOut","description":"School information for autocomplete/selection."},"ScopesResponse":{"properties":{"public":{"items":{"type":"string"},"type":"array","title":"Public"},"all":{"items":{"type":"string"},"type":"array","title":"All"}},"type":"object","required":["public","all"],"title":"ScopesResponse","description":"Lists the scopes a developer may request for a new key.\n\n``public`` is the self-service set; ``all`` is the admin-grantable\nsuperset (equal to ``public`` for non-admin callers)."},"ScoreBand":{"properties":{"label":{"type":"string","title":"Label"},"lo":{"type":"number","title":"Lo"},"hi":{"type":"number","title":"Hi"},"fraction":{"type":"number","title":"Fraction"},"tied":{"type":"boolean","title":"Tied","default":false}},"type":"object","required":["label","lo","hi","fraction"],"title":"ScoreBand","description":"One band of a CDS C9/C11 distribution (#525).\n\n``fraction`` is the share of ENROLLED first-time freshmen in\n[``lo``, ``hi``] — CDS never reports admitted/denied distributions.\nLists are ordered low → high. ``tied`` marks a band that merges a single\npoint with a range (GPA ``3.75+``, #1044): a value inside it is ranked no\nhigher than the band's middle."},"SectionOut":{"properties":{"key":{"type":"string","enum":["could_it_be_zero","scholarships","fafsa_your_part","award_letters"],"title":"Key"},"opens_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Opens On"}},"type":"object","required":["key","opens_on"],"title":"SectionOut"},"SeriesChange":{"properties":{"from_year":{"type":"integer","title":"From Year"},"from_value":{"type":"number","title":"From Value"},"to_year":{"type":"integer","title":"To Year"},"to_value":{"type":"number","title":"To Value"}},"type":"object","required":["from_year","from_value","to_year","to_value"],"title":"SeriesChange","description":"First-vs-last summary over the rendered window (for headline copy)."},"ServiceToken":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["access_token","expires_in"],"title":"ServiceToken"},"ShareConsentUpdate":{"properties":{"share":{"type":"boolean","title":"Share"}},"type":"object","required":["share"],"title":"ShareConsentUpdate"},"ShareLinkRequest":{"properties":{"rotate":{"type":"boolean","title":"Rotate","default":false}},"type":"object","title":"ShareLinkRequest","description":"Body for POST /profiles/{id}/share."},"ShareLinkResponse":{"properties":{"share_url":{"type":"string","title":"Share Url"},"token":{"type":"string","title":"Token"},"enabled":{"type":"boolean","title":"Enabled"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["share_url","token","enabled"],"title":"ShareLinkResponse","description":"Owner-side view of the share link state."},"SharedAccessOut":{"properties":{"account_id":{"type":"string","format":"uuid","title":"Account Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"can_edit":{"type":"boolean","title":"Can Edit"},"can_view":{"type":"boolean","title":"Can View"},"is_primary":{"type":"boolean","title":"Is Primary"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["account_id","email","role","can_edit","can_view","is_primary","created_at"],"title":"SharedAccessOut","description":"Schema for showing who has access to a profile."},"SharedAthleticsHost":{"properties":{"host":{"type":"string","title":"Host"},"colleges":{"items":{"type":"string"},"type":"array","title":"Colleges"}},"type":"object","required":["host","colleges"],"title":"SharedAthleticsHost","description":"An athletics site more than one college's ``athletics_url`` names (#811)."},"SignupRegionCount":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["country","region","count"],"title":"SignupRegionCount","description":"Signups from one country/state in the window (#907); nulls are unknown."},"SignupRegionsResponse":{"properties":{"days":{"type":"integer","title":"Days"},"total":{"type":"integer","title":"Total"},"regions":{"items":{"$ref":"#/components/schemas/SignupRegionCount"},"type":"array","title":"Regions"}},"type":"object","required":["days","total","regions"],"title":"SignupRegionsResponse"},"SimilarCollege":{"properties":{"college":{"$ref":"#/components/schemas/CollegeOut"},"similarity_score":{"type":"number","title":"Similarity Score"},"score_breakdown":{"$ref":"#/components/schemas/SimilarityScoreBreakdown"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["college","similarity_score","score_breakdown","reasons"],"title":"SimilarCollege","description":"A college similar to a target college, with score breakdown and reasons."},"SimilarCollegesResponse":{"properties":{"similar_colleges":{"items":{"$ref":"#/components/schemas/SimilarCollege"},"type":"array","title":"Similar Colleges"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["similar_colleges","count"],"title":"SimilarCollegesResponse","description":"Result of `/colleges/{id}/similar`."},"SimilarityScoreBreakdown":{"properties":{"size":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Size"},"tuition":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tuition"},"location":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Location"},"selectivity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Selectivity"},"programs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Programs"}},"type":"object","title":"SimilarityScoreBreakdown","description":"Per-dimension similarity sub-scores between two colleges."},"SliderRequest":{"properties":{"session_id":{"type":"string","maxLength":128,"minLength":16,"title":"Session Id"},"dimension":{"type":"string","enum":["sat_composite","gpa_unweighted"],"title":"Dimension"},"value":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"string"}],"title":"Value"}},"additionalProperties":false,"type":"object","required":["session_id","dimension","value"],"title":"SliderRequest","description":"Body for ``POST /api/v1/tools/admissions-chance/slider``.\n\nReplays the prior estimate with one input dimension overridden. The\nprior profile is read from the session's ``step_state`` — the\nfrontend never resends the full form.\n\n``value`` is typed ``int | Decimal`` so JSON ``1500`` parses as int\n(for SAT) and JSON ``3.5`` parses as Decimal (for GPA). The\ncross-field validator below enforces the type-by-dimension rule."},"SourceDiagnostic":{"properties":{"source_type":{"type":"string","title":"Source Type"},"weight":{"type":"number","title":"Weight"},"present":{"type":"boolean","title":"Present"},"doc_count":{"type":"integer","title":"Doc Count"},"refresh_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Status"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"last_refreshed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Refreshed At"},"next_due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Due At"}},"type":"object","required":["source_type","weight","present","doc_count","refresh_status","error_message","last_refreshed_at","next_due_at"],"title":"SourceDiagnostic","description":"Per-scoring-slot ingestion diagnostics for one college.\n\nMirrors a single weight slot in\n``data_depth_score.SOURCE_TYPE_WEIGHTS`` (the reddit thread/comment\npair is merged into one ``reddit`` slot so weights sum to 1.0). Lets\nan operator see at a glance which sources are ingested, which failed,\nand when the next ingestion attempt is due."},"SportSlugRedirect":{"properties":{"slug":{"type":"string","title":"Slug","description":"The canonical sport slug to redirect to"}},"type":"object","required":["slug"],"title":"SportSlugRedirect","description":"Where an athletics lander's sport slug now lives (#760).\n\nThe #760 cleanup renamed decorated and alias spellings to one canonical\nname per sport, so a slug built from an old spelling (``track-and-field``,\n``mens-basketball``) no longer resolves. The lander permanently redirects\nit to ``slug``, the canonical sport's slug."},"StateCollegeLink":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},"type":"object","required":["id","name"],"title":"StateCollegeLink","description":"One college in a state hub's A–Z browse list (#885)."},"StateCollegeStats":{"properties":{"state":{"type":"string","title":"State"},"state_name":{"type":"string","title":"State Name"},"total_colleges":{"type":"integer","title":"Total Colleges"},"public_colleges":{"type":"integer","title":"Public Colleges"},"private_colleges":{"type":"integer","title":"Private Colleges"},"avg_tuition_in_state":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Tuition In State"},"avg_tuition_out_state":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Tuition Out State"},"avg_net_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Net Price"},"median_sat":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Sat"},"avg_admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Admission Rate"},"avg_completion_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Completion Rate"},"avg_median_earnings":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Median Earnings"},"total_enrollment":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Enrollment"},"top_colleges":{"items":{},"type":"array","title":"Top Colleges"},"all_colleges":{"items":{"$ref":"#/components/schemas/StateCollegeLink"},"type":"array","title":"All Colleges","default":[]}},"type":"object","required":["state","state_name","total_colleges","public_colleges","private_colleges","top_colleges"],"title":"StateCollegeStats","description":"Full state statistics for individual state endpoint."},"StopCollegeOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"operating_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operating Status"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"street_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Street Address"},"general_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"General Phone"},"admissions_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admissions Url"},"application_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Url"},"financial_aid_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Aid Url"},"admissions_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admissions Phone"},"admissions_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admissions Email"},"visit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visit Url"},"undergraduate_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Undergraduate Size"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"},"sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Avg"},"act_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Avg"},"tuition_in_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition In State"},"tuition_out_state":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tuition Out State"},"avg_net_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Avg Net Price"},"application_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Application Deadline"},"early_action_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Action Deadline"},"early_decision_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Early Decision Deadline"}},"type":"object","required":["id","name"],"title":"StopCollegeOut","description":"Compact college projection for itinerary stop cards."},"StopCreateRequest":{"properties":{"college_id":{"type":"string","maxLength":120,"minLength":1,"title":"College Id"},"notes":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Notes"},"position":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Position"}},"type":"object","required":["college_id"],"title":"StopCreateRequest"},"StopPositionUpdate":{"properties":{"stop_id":{"type":"string","format":"uuid","title":"Stop Id"},"position":{"type":"integer","maximum":1000.0,"minimum":0.0,"title":"Position"}},"type":"object","required":["stop_id","position"],"title":"StopPositionUpdate"},"StopUpdateRequest":{"properties":{"notes":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Notes"}},"type":"object","title":"StopUpdateRequest"},"StopsReorderRequest":{"properties":{"positions":{"items":{"$ref":"#/components/schemas/StopPositionUpdate"},"type":"array","title":"Positions"}},"type":"object","required":["positions"],"title":"StopsReorderRequest"},"StudentActivityRead":{"properties":{"access":{"type":"string","enum":["granted","none"],"title":"Access"},"can_request":{"type":"boolean","title":"Can Request"},"last_viewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Viewed At"},"colleges":{"anyOf":[{"items":{"$ref":"#/components/schemas/ActivityCollege"},"type":"array"},{"type":"null"}],"title":"Colleges"},"colleges_added_30d":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Colleges Added 30D"},"scholarships":{"anyOf":[{"items":{"$ref":"#/components/schemas/ActivityScholarship"},"type":"array"},{"type":"null"}],"title":"Scholarships"},"deadlines":{"anyOf":[{"items":{"$ref":"#/components/schemas/ActivityDeadline"},"type":"array"},{"type":"null"}],"title":"Deadlines"},"milestones":{"anyOf":[{"$ref":"#/components/schemas/ActivityMilestones"},{"type":"null"}]},"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/ActivityEvent"},"type":"array"},{"type":"null"}],"title":"Events"},"readiness":{"anyOf":[{"$ref":"#/components/schemas/ActivityReadiness"},{"type":"null"}]},"engagement":{"anyOf":[{"$ref":"#/components/schemas/ActivityEngagement"},{"type":"null"}]},"engagement_unavailable":{"type":"boolean","title":"Engagement Unavailable"},"conversations":{"anyOf":[{"$ref":"#/components/schemas/ActivityConversations"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["access","can_request","last_viewed_at","colleges","colleges_added_30d","scholarships","deadlines","milestones","events","readiness","engagement","engagement_unavailable","conversations"],"title":"StudentActivityRead"},"StudentFixtureContactIn":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"organization":{"type":"string","maxLength":255,"minLength":1,"title":"Organization"},"type":{"$ref":"#/components/schemas/OutreachRecipientType","default":"other"}},"additionalProperties":false,"type":"object","required":["name","email","organization"],"title":"StudentFixtureContactIn","description":"An outreach contact for the seeded student (#1106)."},"StudentFixtureDraftIn":{"properties":{"to":{"type":"string","format":"email","title":"To"},"subject":{"type":"string","maxLength":200,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":5000,"minLength":1,"title":"Body"}},"additionalProperties":false,"type":"object","required":["to","subject","body"],"title":"StudentFixtureDraftIn","description":"A draft to one of the fixture's contacts, named by email (#1106)."},"StudentFixtureIn":{"properties":{"profile":{"$ref":"#/components/schemas/StudentFixtureProfileIn","default":{}},"saved_colleges":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Saved Colleges","default":[]},"saved_scholarships":{"items":{"$ref":"#/components/schemas/StudentFixtureScholarshipIn"},"type":"array","maxItems":10,"title":"Saved Scholarships","default":[]},"itineraries":{"items":{"$ref":"#/components/schemas/StudentFixtureTripIn"},"type":"array","maxItems":5,"title":"Itineraries","default":[]},"milestones":{"additionalProperties":{"type":"string","enum":["done","not_done"]},"type":"object","title":"Milestones","default":{}},"saved_searches":{"items":{"$ref":"#/components/schemas/StudentFixtureSavedSearchIn"},"type":"array","maxItems":5,"title":"Saved Searches","default":[]},"outreach":{"anyOf":[{"$ref":"#/components/schemas/StudentFixtureOutreachIn"},{"type":"null"}]},"viewer":{"anyOf":[{"$ref":"#/components/schemas/StudentFixtureViewerIn"},{"type":"null"}]}},"type":"object","title":"StudentFixtureIn","description":"A seeded student for the case (#971): profile columns plus saved\ncolleges, and tracked scholarships (#1103), by exact name. The runner\nseeds and removes them per run."},"StudentFixtureOutreachIn":{"properties":{"contacts":{"items":{"$ref":"#/components/schemas/StudentFixtureContactIn"},"type":"array","maxItems":5,"title":"Contacts","default":[]},"drafts":{"items":{"$ref":"#/components/schemas/StudentFixtureDraftIn"},"type":"array","maxItems":5,"title":"Drafts","default":[]}},"additionalProperties":false,"type":"object","title":"StudentFixtureOutreachIn","description":"Contacts and drafts for the seeded student (#1106)."},"StudentFixtureProfileIn":{"properties":{"grade_level":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":2000.0},{"type":"null"}],"title":"Graduation Year"},"current_gpa":{"anyOf":[{"type":"number","maximum":9.99,"minimum":0.0},{"type":"null"}],"title":"Current Gpa"},"unweighted_gpa":{"anyOf":[{"type":"number","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"Unweighted Gpa"},"sat_score":{"anyOf":[{"type":"integer","maximum":1600.0,"minimum":400.0},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer","maximum":36.0,"minimum":1.0},{"type":"null"}],"title":"Act Score"},"intended_major":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"state_of_residence":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"City"},"class_rank":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Class Size"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Career Goals"},"financial_need_level":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Financial Need Level"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"}},"additionalProperties":false,"type":"object","title":"StudentFixtureProfileIn","description":"The profile columns a fixture may set, typed, so a bad value is a 422 at\nentry rather than a failed insert mid-run. Mirrors\n``corpus.STUDENT_FIXTURE_PROFILE_FIELDS`` (a test pins the two together)."},"StudentFixtureSavedSearchIn":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"page":{"type":"string","enum":["colleges","scholarships","merit_scholarships","athletics"],"title":"Page","default":"colleges"},"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"}},"additionalProperties":false,"type":"object","required":["name","query"],"title":"StudentFixtureSavedSearchIn","description":"A saved search for the seeded student (#1105): a name, its page, and the\npage's query string (rebuilt by ``normalize_query`` when seeded)."},"StudentFixtureScholarshipIn":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"status":{"type":"string","enum":["saved","in_progress","submitted","awarded","rejected","withdrawn","not_interested"],"title":"Status","default":"saved"},"requirements":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Requirements","default":[]}},"additionalProperties":false,"type":"object","required":["name"],"title":"StudentFixtureScholarshipIn","description":"A tracked scholarship for the seeded student (#1103), by exact catalog name."},"StudentFixtureTripIn":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"colleges":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Colleges","default":[]}},"additionalProperties":false,"type":"object","required":["name"],"title":"StudentFixtureTripIn","description":"A trip for the seeded student (#1104): a name and colleges by exact name, in visit order."},"StudentFixtureViewerIn":{"properties":{"role":{"type":"string","enum":["owner","parent","counselor","shared"],"title":"Role","default":"owner"},"can_edit":{"type":"boolean","title":"Can Edit","default":true}},"additionalProperties":false,"type":"object","title":"StudentFixtureViewerIn"},"StudentInvitationSkipped":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"reason":{"type":"string","enum":["member","on_roster","already_joined"],"title":"Reason"}},"type":"object","required":["email","reason"],"title":"StudentInvitationSkipped"},"StudentProfile":{"properties":{"gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gpa"},"current_gpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Gpa"},"sat_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sat Score"},"act_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Act Score"},"grade_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade Level"},"graduation_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Graduation Year"},"intended_major":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intended Major"},"intended_majors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Intended Majors"},"class_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Rank"},"class_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Size"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"state_of_residence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Of Residence"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":"US"},"high_school_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"High School Name"},"school_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"School District"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"ethnicity":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ethnicity"},"citizenship_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citizenship Status"},"first_generation_college":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Generation College"},"military_affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Military Affiliation"},"financial_need":{"type":"boolean","title":"Financial Need","default":false},"financial_need_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Financial Need Level"},"household_income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Household Income Range"},"extracurriculars":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Extracurriculars"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"career_goals":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Career Goals"},"special_circumstances":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Special Circumstances"},"preferences":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Preferences"},"search_keywords":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Keywords"},"include_collaborative":{"type":"boolean","title":"Include Collaborative","default":true}},"type":"object","title":"StudentProfile","description":"Student profile information for scholarship matching."},"SyncTaskResponse":{"properties":{"message":{"type":"string","title":"Message"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"updated":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Updated"},"skipped":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Skipped"},"errors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Errors"},"total_colleges":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Colleges"},"median_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Rate"}},"type":"object","required":["message"],"title":"SyncTaskResponse","description":"Response for the admin sync routes (HTTP 202).\n\nEvery `/colleges/sync*` route is admin-only and queues its Celery task\n(#723), answering with a `message` that names the task id; the job's counts\nland on the task's audit row. The counter fields stay optional for schema\ncompatibility, and those routes no longer set them."},"SynthesisDailyResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/SynthesisDailyRow"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"SynthesisDailyResponse"},"SynthesisDailyRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"colleges_synthesized":{"type":"integer","title":"Colleges Synthesized"},"colleges_short_circuited":{"type":"integer","title":"Colleges Short Circuited"},"colleges_failed":{"type":"integer","title":"Colleges Failed"},"colleges_retried_narrative":{"type":"integer","title":"Colleges Retried Narrative","default":0},"colleges_coerced_empty":{"type":"integer","title":"Colleges Coerced Empty","default":0},"tokens_in_total":{"type":"integer","title":"Tokens In Total"},"tokens_out_total":{"type":"integer","title":"Tokens Out Total"},"cost_usd_total":{"type":"string","title":"Cost Usd Total"},"avg_cost_per_college":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avg Cost Per College"},"expected_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Cost Usd"}},"type":"object","required":["metric_date","colleges_synthesized","colleges_short_circuited","colleges_failed","tokens_in_total","tokens_out_total","cost_usd_total","avg_cost_per_college"],"title":"SynthesisDailyRow","description":"One row from metrics_synthesis_daily."},"SynthesisDiagnostics":{"properties":{"data_depth_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Depth Score"},"synthesis_threshold":{"type":"number","title":"Synthesis Threshold"},"meets_threshold":{"type":"boolean","title":"Meets Threshold"},"synthesized_empty":{"type":"boolean","title":"Synthesized Empty","default":false},"missing_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Missing Reason"},"sources":{"items":{"$ref":"#/components/schemas/SourceDiagnostic"},"type":"array","title":"Sources"}},"type":"object","required":["data_depth_score","synthesis_threshold","meets_threshold","missing_reason","sources"],"title":"SynthesisDiagnostics","description":"Why a college is (or isn't) synthesized — depth score + per-source\nbreakdown. Returned for every detail response, including\nmissing-profile colleges (the ones an operator most wants to inspect)."},"SynthesisProfileDetail":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"synthesis_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthesis Status"},"data_depth_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Depth Score"},"profile_exists":{"type":"boolean","title":"Profile Exists"},"diagnostics":{"$ref":"#/components/schemas/SynthesisDiagnostics"},"vibe_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vibe Summary"},"academic_character":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Academic Character"},"social_character":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Social Character"},"who_thrives_here":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Who Thrives Here"},"who_might_not":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Who Might Not"},"recent_news_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recent News Summary"},"strengths":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Strengths"},"weaknesses":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Weaknesses"},"traditions":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Traditions"},"resolved_citations":{"items":{"$ref":"#/components/schemas/ResolvedCitation"},"type":"array","title":"Resolved Citations","default":[]},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"prompt_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prompt Version"},"input_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Hash"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"token_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Cost Usd"},"synthesized_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Synthesized At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["college_id","college_name","synthesis_status","data_depth_score","profile_exists","diagnostics","vibe_summary","academic_character","social_character","who_thrives_here","who_might_not","recent_news_summary","strengths","weaknesses","traditions","model_version","prompt_version","input_hash","license","token_cost_usd","synthesized_at","created_at","updated_at"],"title":"SynthesisProfileDetail"},"SynthesisProfileListResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/SynthesisProfileRow"},"type":"array","title":"Rows"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["rows","total","page","page_size","total_pages"],"title":"SynthesisProfileListResponse"},"SynthesisProfileRow":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_name":{"type":"string","title":"College Name"},"synthesis_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthesis Status"},"data_depth_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Depth Score"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"prompt_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prompt Version"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"token_cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Cost Usd"},"synthesized_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Synthesized At"},"vibe_summary_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vibe Summary Preview"}},"type":"object","required":["college_id","college_name","synthesis_status","data_depth_score","model_version","prompt_version","license","token_cost_usd","synthesized_at"],"title":"SynthesisProfileRow","description":"One row in the synthesis colleges list."},"SynthesisResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"synthesis_status":{"anyOf":[{"type":"string","enum":["fresh","stale","missing","blocked"]},{"type":"null"}],"title":"Synthesis Status"},"license":{"anyOf":[{"type":"string","enum":["cc0","cc_by_4","cc_by_sa_4","wikimedia","official_pr","fair_use_excerpt","reddit_api_tos","youtube_tos","unknown"]},{"type":"null"}],"title":"License"},"requires_auth":{"type":"boolean","title":"Requires Auth"},"sections":{"anyOf":[{"$ref":"#/components/schemas/SynthesizedProfileSchema"},{"type":"null"}]},"citations":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/HydratedCitation"},"propertyNames":{"format":"uuid"},"type":"object"},{"type":"null"}],"title":"Citations"},"fetched_at":{"type":"string","format":"date-time","title":"Fetched At"},"provenance":{"anyOf":[{"$ref":"#/components/schemas/ContentProvenanceOut"},{"type":"null"}],"description":"Machine-readable marking of model-generated text (EU AI Act Art. 50(2)). Verify at POST /api/v1/provenance/verify."}},"type":"object","required":["college_id","synthesis_status","license","requires_auth","sections","citations","fetched_at"],"title":"SynthesisResponse","description":"Top-level response for ``GET /colleges/{college_id}/synthesis``.\n\n``sections`` and ``citations`` are populated only when the gating\nmatrix admits content (see router). For\n``synthesis_status in {None, \"missing\"}``, no saved profile,\n``license=\"unknown\"`` or anonymous access to a ``fair_use_excerpt`` row,\nboth are ``None``. A ``blocked`` college shows its saved profile, the last\none that passed validation (#1046).\n``requires_auth`` is ``True`` only on the\n``fair_use_excerpt`` + anonymous branch — the frontend uses it to\nrender the gated-CTA variant."},"SynthesizedProfileSchema":{"properties":{"vibe_summary":{"type":"string","maxLength":2000,"title":"Vibe Summary","default":""},"academic_character":{"type":"string","maxLength":2000,"title":"Academic Character","default":""},"social_character":{"type":"string","maxLength":2000,"title":"Social Character","default":""},"who_thrives_here":{"type":"string","maxLength":2000,"title":"Who Thrives Here","default":""},"who_might_not":{"type":"string","maxLength":2000,"title":"Who Might Not","default":""},"recent_news_summary":{"type":"string","maxLength":2000,"title":"Recent News Summary","default":""},"strengths":{"items":{"$ref":"#/components/schemas/CitedClaim"},"type":"array","maxItems":7,"title":"Strengths"},"weaknesses":{"items":{"$ref":"#/components/schemas/CitedClaim"},"type":"array","maxItems":7,"title":"Weaknesses"},"traditions":{"items":{"$ref":"#/components/schemas/CitedClaim"},"type":"array","maxItems":7,"title":"Traditions"}},"type":"object","title":"SynthesizedProfileSchema","description":"Wire + storage schema for one synthesized college profile.\n\nUsed in two places:\n  1. As the response_model for ``GET /api/v1/colleges/{id}/synthesis``\n     — rehydrates a persisted DB row into a wire payload. Must accept\n     legacy rows (including pre-#403 rows with narrative + empty\n     claims) so the reads-side never 500s on existing data.\n  2. As the base class for ``SynthesizedProfileOutput`` (below),\n     which adds the LLM-output schema floor.\n\nThin-source rule (enforced by prompt): when source docs are thin on\na topic, the corresponding narrative field is left empty (``\"\"``).\nThe frontend omits empty sections from the Insights tab — emptiness\nis the correct signal, not a deficiency note. Empty claim lists are\nalso acceptable, but only when no source material supports a claim;\nthe prompt prefers one well-supported claim over no claims (#401).\nThe narrative-quality sanitizer in ``narrative_quality.py`` is a\nbelt-and-suspenders defense that strips any deficiency text Claude\noccasionally emits despite this instruction.\n\nPer ARCHITECTURE.md §\"Synthesis → Citation enforcement\", every entry\nin the claim lists must carry at least one source_doc_id (enforced by\nPydantic's ``min_length=1`` on ``CitedClaim.source_doc_ids``)."},"TaskLimitConfig":{"properties":{"task_name":{"type":"string","title":"Task Name"},"display_name":{"type":"string","title":"Display Name"},"default_soft_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Default Soft Time Limit"},"default_hard_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Default Hard Time Limit"},"override_soft_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Override Soft Time Limit"},"override_hard_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Override Hard Time Limit"},"effective_soft_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Effective Soft Time Limit"},"effective_hard_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Effective Hard Time Limit"}},"type":"object","required":["task_name","display_name"],"title":"TaskLimitConfig","description":"Coded default, admin override, and effective time limits for one task (s)."},"TaskLimitUpdate":{"properties":{"soft_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Soft Time Limit"},"hard_time_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hard Time Limit"}},"type":"object","title":"TaskLimitUpdate","description":"Set both to override, or both null to clear the override (revert to default)."},"TaskLimitsResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/TaskLimitConfig"},"type":"array","title":"Tasks"},"min_time_limit":{"type":"integer","title":"Min Time Limit"},"max_time_limit":{"type":"integer","title":"Max Time Limit"}},"type":"object","required":["tasks","min_time_limit","max_time_limit"],"title":"TaskLimitsResponse","description":"Per-task time-limit config for every task in the registry."},"TaskStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"task_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Name"},"status":{"type":"string","title":"Status"},"result":{"anyOf":[{},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"traceback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Traceback"}},"type":"object","required":["task_id","status"],"title":"TaskStatusResponse","description":"Response with task execution status."},"TemplateRenderRequest":{"properties":{"template_id":{"type":"string","format":"uuid","title":"Template Id"},"placeholder_values":{"additionalProperties":true,"type":"object","title":"Placeholder Values","description":"Values to replace placeholders"}},"type":"object","required":["template_id","placeholder_values"],"title":"TemplateRenderRequest","description":"Schema for rendering a template with placeholders."},"TemplateRenderResponse":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"unfilled_placeholders":{"items":{"$ref":"#/components/schemas/UnfilledPlaceholder"},"type":"array","title":"Unfilled Placeholders","default":[]}},"type":"object","required":["subject","body"],"title":"TemplateRenderResponse","description":"Schema for rendered template response."},"TestScoreContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"test_type":{"type":"string","enum":["sat","act"],"title":"Test Type"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff at least one of ``test_avg``, ``test_25``, ``test_75`` is set. Drives sitemap inclusion + noindex."},"test_25":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test 25"},"test_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test Avg"},"test_75":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test 75"},"national_percentile":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"National Percentile","description":"0-100; 0 = lowest scores, 100 = highest scores among all colleges with this test_type populated. None when test_avg is None."},"admission_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Admission Rate"},"peer_schools":{"items":{"$ref":"#/components/schemas/TestScorePeerSchool"},"type":"array","title":"Peer Schools","description":"Up to 3 same-control schools with similar test-score bands, ordered by ascending |peer.test_avg - college.test_avg|."},"score_bands":{"anyOf":[{"items":{"$ref":"#/components/schemas/ScoreBand"},"type":"array"},{"type":"null"}],"title":"Score Bands","description":"CDS C9 composite band histogram for this test_type (#525), ordered low → high, fractions of ENROLLED freshmen summing to ~1.0. None when the college has no published band distribution."},"band_source":{"anyOf":[{"type":"string","enum":["scorecard","cds","ipeds"]},{"type":"null"}],"title":"Band Source","description":"Who supplied the band: College Scorecard, the school's Common Data Set, or the IPEDS admissions figures (#718). None when nothing recorded the writer; the page then names no single source."},"data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Year","description":"Fall year of the academic year the band is from (2024 = 2024–25): the year Scorecard's sync recorded, or the CDS or IPEDS year, whichever ``band_source`` names. A band synthesised from the average carries the average's year. None when no source or year is recorded (#722, #718)."},"average_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Average Year","description":"Recorded year of ``test_avg``, and so of ``national_percentile``. Older than ``data_year`` for ACT, whose midpoint Scorecard stopped reporting after 2021 (#722)."},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","test_type","has_any_data","test_25","test_avg","test_75","last_retrieved_at"],"title":"TestScoreContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/{sat,act}-context``.\n\nSame shape for SAT and ACT — the ``test_type`` field differentiates.\nBoth endpoints back detail-page SEO sub-routes per ARCHITECTURE.md\n§\"Detail-page SEO sub-routes\"."},"TestScorePeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"test_25":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test 25"},"test_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test Avg"},"test_75":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Test 75"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"}},"type":"object","required":["id","slug","name","state","test_25","test_avg","test_75","admission_rate"],"title":"TestScorePeerSchool","description":"One peer school's test-score band data."},"TierExplanation":{"properties":{"student_sat_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Student Sat Used"},"student_act_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Student Act Used"},"student_gpa_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Student Gpa Used"},"sat_converted_from_act":{"type":"boolean","title":"Sat Converted From Act","default":false},"college_admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"College Admission Rate"},"college_sat_avg":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"College Sat Avg"},"college_sat_25th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"College Sat 25Th"},"college_sat_75th":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"College Sat 75Th"},"percentile_among_enrolled":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentile Among Enrolled"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"out_of_model_factors":{"items":{"type":"string"},"type":"array","title":"Out Of Model Factors"},"data_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data Updated At"},"missing":{"items":{"type":"string"},"type":"array","title":"Missing"}},"type":"object","title":"TierExplanation","description":"Everything the explainer sheet renders. No client-side derivation.\n\nPer the architecture rule, a chip is a compliant summary only if its band\nis one tap away — this is what that tap shows."},"TierOverrideRequest":{"properties":{"new_tier":{"type":"string","enum":["free","basic","pro","unlimited"],"title":"New Tier"},"reason":{"type":"string","maxLength":500,"minLength":1,"title":"Reason"}},"type":"object","required":["new_tier","reason"],"title":"TierOverrideRequest"},"Token":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"}},"type":"object","required":["access_token"],"title":"Token"},"TokenIn":{"properties":{"token":{"type":"string","maxLength":128,"minLength":1,"title":"Token"}},"additionalProperties":false,"type":"object","required":["token"],"title":"TokenIn"},"TokenResultOut":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"TokenResultOut"},"TokenValidationResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["valid"],"title":"TokenValidationResponse","description":"Result of validating a one-time token (e.g., password reset)."},"ToolCallExpectationIn":{"properties":{"name":{"type":"string","title":"Name"},"args_contains":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Args Contains"},"max_calls":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Calls"}},"type":"object","required":["name"],"title":"ToolCallExpectationIn"},"ToolEntryResponse":{"properties":{"tool":{"$ref":"#/components/schemas/ToolMetaOut"}},"type":"object","required":["tool"],"title":"ToolEntryResponse","description":"``GET /tools/{tool_id}`` payload — single tool metadata."},"ToolFunnelTrendResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ToolFunnelTrendRow"},"type":"array","title":"Rows"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"}},"type":"object","required":["rows","since","until"],"title":"ToolFunnelTrendResponse","description":"Time-series response for the tool-funnel trends endpoint."},"ToolFunnelTrendRow":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"tool_id":{"type":"string","title":"Tool Id"},"tool_views":{"type":"integer","title":"Tool Views","default":0},"tool_starts":{"type":"integer","title":"Tool Starts","default":0},"tool_completes":{"type":"integer","title":"Tool Completes","default":0},"email_captures":{"type":"integer","title":"Email Captures","default":0},"signup_conversions":{"type":"integer","title":"Signup Conversions","default":0},"ctr":{"type":"number","title":"Ctr","default":0.0},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["metric_date","tool_id"],"title":"ToolFunnelTrendRow","description":"One (date, tool_id) row for the tool funnel time-series (#209).\n\n``tool_id`` is typed as ``str`` rather than a Literal because the\n``TOOL_REGISTRY`` is the runtime source of truth; pinning a Literal here\nwould mean a schema change every time a tool ships. The ``'all'``\naggregate row uses the same column. Validation happens upstream in the\nregistry; the admin dashboard already knows the values."},"ToolMetaOut":{"properties":{"slug":{"type":"string","title":"Slug"},"display_name":{"type":"string","title":"Display Name"},"short_description":{"type":"string","title":"Short Description"},"status":{"type":"string","title":"Status","description":"One of 'coming_soon' | 'live'"},"icon":{"type":"string","title":"Icon","description":"lucide-react icon name"}},"type":"object","required":["slug","display_name","short_description","status","icon"],"title":"ToolMetaOut","description":"Public-facing tool metadata surfaced by the hub + entry endpoints."},"ToolSessionOut":{"properties":{"session_id":{"type":"string","title":"Session Id"},"tool_id":{"type":"string","title":"Tool Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_event_at":{"type":"string","format":"date-time","title":"Last Event At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"linked_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Linked User Id"},"step_state":{"additionalProperties":true,"type":"object","title":"Step State"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"}},"type":"object","required":["session_id","tool_id","created_at","last_event_at"],"title":"ToolSessionOut","description":"Public view of a tool session."},"TrackerClassYearUpdate":{"properties":{"student_user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200,"minItems":1,"title":"Student User Ids"},"class_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Year"}},"additionalProperties":false,"type":"object","required":["student_user_ids","class_year"],"title":"TrackerClassYearUpdate"},"TrackerRecordKeyRead":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"}},"type":"object","required":["key","label"],"title":"TrackerRecordKeyRead"},"TrackerRecordUpdate":{"properties":{"student_user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":200,"minItems":1,"title":"Student User Ids"},"milestone_key":{"type":"string","enum":["fafsa_fsa_id","fafsa_contributor","fafsa_submitted","fafsa_processed","verification_selected","verification_complete","applications_submitted","deposit_paid"],"title":"Milestone Key"},"status":{"anyOf":[{"type":"string","enum":["done","not_done","not_applicable"]},{"type":"null"}],"title":"Status"}},"additionalProperties":false,"type":"object","required":["student_user_ids","milestone_key","status"],"title":"TrackerRecordUpdate"},"TrackerResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TrackerRowRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"truncated":{"type":"boolean","title":"Truncated"},"keys":{"items":{"$ref":"#/components/schemas/TrackerRecordKeyRead"},"type":"array","title":"Keys"},"fafsa_ladder":{"items":{"type":"string"},"type":"array","title":"Fafsa Ladder"},"class_year_min":{"type":"integer","title":"Class Year Min"},"class_year_max":{"type":"integer","title":"Class Year Max"},"can_record":{"type":"boolean","title":"Can Record"}},"type":"object","required":["items","total","truncated","keys","fafsa_ladder","class_year_min","class_year_max","can_record"],"title":"TrackerResponse"},"TrackerRowRead":{"properties":{"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"type":"string","title":"Email"},"counselor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Counselor Id"},"counselor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counselor Name"},"class_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Class Year"},"class_year_source":{"anyOf":[{"type":"string","enum":["org","student"]},{"type":"null"}],"title":"Class Year Source"},"shares":{"type":"boolean","title":"Shares"},"records":{"additionalProperties":{"type":"string","enum":["done","not_done","not_applicable"]},"type":"object","title":"Records"},"student_answers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Student Answers"},"fafsa":{"$ref":"#/components/schemas/FafsaSummaryRead"},"list_flag":{"anyOf":[{"type":"string","enum":["all_reach","undermatched","not_enough_to_tell","no_list","balanced"]},{"type":"null"}],"title":"List Flag"}},"type":"object","required":["student_user_id","name","email","counselor_id","counselor_name","class_year","class_year_source","shares","records","student_answers","fafsa","list_flag"],"title":"TrackerRowRead"},"TrackerUpdateResult":{"properties":{"updated":{"type":"integer","title":"Updated"}},"type":"object","required":["updated"],"title":"TrackerUpdateResult"},"TrajectoryBand":{"properties":{"year":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Year"},"mid":{"type":"integer","title":"Mid"},"lo":{"type":"integer","title":"Lo"},"hi":{"type":"integer","title":"Hi"}},"type":"object","required":["year","mid","lo","hi"],"title":"TrajectoryBand","description":"One year's earnings band on the per-row trajectory sparkline.\n\n10 of these per row, indexed 1..10 (Y1 is freshman year, Y5 is post-grad\nY1, Y10 is post-grad Y6). Source: :func:`life_path.predict`'s\n``yearly_projections[i].earnings.{lo,midpoint,hi}``. In-school years\n(Y1..Y4) have zero-earnings projections and render as a flat baseline."},"TreeCounts":{"properties":{"staff":{"type":"integer","title":"Staff"},"students":{"type":"integer","title":"Students"},"unassigned_students":{"type":"integer","title":"Unassigned Students"},"counselors_without_students":{"type":"integer","title":"Counselors Without Students"},"students_without_parent":{"type":"integer","title":"Students Without Parent"}},"type":"object","required":["staff","students","unassigned_students","counselors_without_students","students_without_parent"],"title":"TreeCounts"},"TreeOrg":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"}},"type":"object","required":["id","name","slug","type","status"],"title":"TreeOrg"},"TreeParentAccount":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["user_id"],"title":"TreeParentAccount"},"TreeSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"type":{"type":"string","enum":["school","district","counseling_practice","community_organization"],"title":"Type"},"status":{"type":"string","enum":["active","suspended","pending"],"title":"Status"},"counts":{"$ref":"#/components/schemas/TreeCounts"}},"type":"object","required":["id","name","slug","type","status","counts"],"title":"TreeSchool","description":"A child school, as a summary: the client fetches its own tree on expand."},"TreeStaff":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"role":{"type":"string","enum":["owner","admin","counselor"],"title":"Role"},"display_name":{"type":"string","title":"Display Name"},"student_count":{"type":"integer","title":"Student Count"},"students":{"items":{"$ref":"#/components/schemas/TreeStudent"},"type":"array","title":"Students"}},"type":"object","required":["user_id","role","display_name","student_count","students"],"title":"TreeStaff"},"TreeStudent":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"student_user_id":{"type":"string","format":"uuid","title":"Student User Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"email":{"type":"string","title":"Email"},"share_consent":{"type":"boolean","title":"Share Consent"},"unassigned_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unassigned Reason"},"parent_accounts":{"items":{"$ref":"#/components/schemas/TreeParentAccount"},"type":"array","title":"Parent Accounts"},"parent_connected":{"type":"boolean","title":"Parent Connected"}},"type":"object","required":["id","student_user_id","email","share_consent","parent_accounts","parent_connected"],"title":"TreeStudent"},"TrendBandSeries":{"properties":{"metric":{"type":"string","enum":["sat_mid50","act_mid50"],"title":"Metric"},"label":{"type":"string","title":"Label"},"source":{"type":"string","enum":["ipeds","scorecard","cds"],"title":"Source"},"points":{"items":{"$ref":"#/components/schemas/BandPoint"},"type":"array","title":"Points","description":"Ascending by year; ≥2 points"},"year_min":{"type":"integer","title":"Year Min"},"year_max":{"type":"integer","title":"Year Max"},"annotations":{"items":{"type":"string","enum":["enrolled_freshmen","sat_rescale_2016","test_optional_era"]},"type":"array","title":"Annotations"}},"type":"object","required":["metric","label","source","points","year_min","year_max"],"title":"TrendBandSeries","description":"One score metric's single-source, windowed mid-50% band series."},"TrendPeerSchool":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"type":"string","title":"Name"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"admission_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Admission Rate"},"has_trends":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Trends"}},"type":"object","required":["id","slug","name","state","admission_rate"],"title":"TrendPeerSchool","description":"One peer school for the 'similar schools' widget."},"TrendPoint":{"properties":{"year":{"type":"integer","title":"Year","description":"Fall year of the academic year"},"value":{"type":"number","title":"Value"}},"type":"object","required":["year","value"],"title":"TrendPoint","description":"One year's value for a line metric."},"TrendSeries":{"properties":{"metric":{"type":"string","enum":["admission_rate","applicants","admits","enrollment","tuition_in_state","tuition_out_state","avg_net_price"],"title":"Metric"},"label":{"type":"string","title":"Label","description":"Display label, e.g. 'Undergraduate enrollment'"},"source":{"type":"string","enum":["ipeds","scorecard","cds"],"title":"Source"},"unit":{"type":"string","enum":["percent","count","usd"],"title":"Unit"},"points":{"items":{"$ref":"#/components/schemas/TrendPoint"},"type":"array","title":"Points","description":"Ascending by year; ≥2 points"},"year_min":{"type":"integer","title":"Year Min"},"year_max":{"type":"integer","title":"Year Max"},"annotations":{"items":{"type":"string","enum":["enrolled_freshmen","sat_rescale_2016","test_optional_era"]},"type":"array","title":"Annotations"},"change":{"anyOf":[{"$ref":"#/components/schemas/SeriesChange"},{"type":"null"}]}},"type":"object","required":["metric","label","source","unit","points","year_min","year_max"],"title":"TrendSeries","description":"One line metric's single-source, windowed year series."},"TrendsContextResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"college_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"College Slug"},"college_name":{"type":"string","title":"College Name"},"has_any_data":{"type":"boolean","title":"Has Any Data","description":"True iff a headline metric (admission_rate, enrollment, sat_mid50, act_mid50) has ≥2 distinct years. Drives sitemap inclusion + noindex."},"series":{"items":{"$ref":"#/components/schemas/TrendSeries"},"type":"array","title":"Series"},"bands":{"items":{"$ref":"#/components/schemas/TrendBandSeries"},"type":"array","title":"Bands"},"last_data_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Data Year","description":"Max year across all included series"},"peer_schools":{"items":{"$ref":"#/components/schemas/TrendPeerSchool"},"type":"array","title":"Peer Schools"},"last_retrieved_at":{"type":"string","format":"date-time","title":"Last Retrieved At"}},"type":"object","required":["college_id","college_slug","college_name","has_any_data","last_retrieved_at"],"title":"TrendsContextResponse","description":"Response envelope for ``GET /api/v1/colleges/{id}/trends-context``."},"TriggerRunResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status","default":"queued"}},"type":"object","required":["task_id"],"title":"TriggerRunResponse"},"TriggerTaskRequest":{"properties":{"task_name":{"type":"string","title":"Task Name"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"}},"type":"object","required":["task_name"],"title":"TriggerTaskRequest","description":"Request to trigger a Celery task."},"TriggerTaskResponse":{"properties":{"message":{"type":"string","title":"Message"},"task_id":{"type":"string","title":"Task Id"},"task_name":{"type":"string","title":"Task Name"},"status":{"type":"string","title":"Status"}},"type":"object","required":["message","task_id","task_name","status"],"title":"TriggerTaskResponse","description":"Response for triggering a Celery task."},"UnfilledPlaceholder":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"source":{"type":"string","title":"Source"}},"type":"object","required":["key","label","source"],"title":"UnfilledPlaceholder","description":"A placeholder that was not filled during template rendering."},"UnsubscribeIn":{"properties":{"token":{"type":"string","maxLength":1024,"title":"Token","default":""}},"additionalProperties":false,"type":"object","title":"UnsubscribeIn"},"UnsubscribeOut":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"UnsubscribeOut"},"UpdateSavedCollegeRequest":{"properties":{"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"status":{"anyOf":[{"type":"string","enum":["interested","applying","applied","waitlisted","deferred","accepted","rejected","enrolled","not_interested"]},{"type":"null"}],"title":"Status"},"ranking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ranking"}},"type":"object","title":"UpdateSavedCollegeRequest"},"UpdateSessionStateRequest":{"properties":{"step_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Step State"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"}},"type":"object","title":"UpdateSessionStateRequest","description":"Partial update — either ``step_state`` (merged) or ``result`` (replaced)."},"UpdateUserRoleRequest":{"properties":{"user_email":{"type":"string","format":"email","title":"User Email"},"new_role":{"type":"string","title":"New Role"}},"type":"object","required":["user_email","new_role"],"title":"UpdateUserRoleRequest","description":"Request to update a user's role."},"UpdateUserRoleResponse":{"properties":{"message":{"type":"string","title":"Message"},"user":{"$ref":"#/components/schemas/UserRoleResponse"}},"type":"object","required":["message","user"],"title":"UpdateUserRoleResponse","description":"Response for user role update."},"UsageResponse":{"properties":{"rate_limit_tier":{"type":"string","title":"Rate Limit Tier"},"requests_today":{"type":"integer","title":"Requests Today","default":0},"requests_this_week":{"type":"integer","title":"Requests This Week","default":0},"requests_this_month":{"type":"integer","title":"Requests This Month","default":0},"rate_limit_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rate Limit Remaining"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["rate_limit_tier"],"title":"UsageResponse","description":"Aggregate usage stats for a developer's API key(s)."},"UserCreate":{"properties":{"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"password":{"type":"string","maxLength":1024,"title":"Password"},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"role":{"type":"string","maxLength":20,"title":"Role","default":"student"},"age_attested":{"type":"boolean","title":"Age Attested","default":false},"account_type":{"anyOf":[{"type":"string","enum":["student","parent","counselor"]},{"type":"null"}],"title":"Account Type"},"invitation_token":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Invitation Token"},"return_to":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Return To"},"company_website":{"type":"string","maxLength":500,"title":"Company Website","default":""},"form_mounted_at_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Form Mounted At Ms"},"turnstile_token":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email","password"],"title":"UserCreate"},"UserOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"email":{"type":"string","title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"role":{"type":"string","title":"Role"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"age_attested_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Age Attested At"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"}},"type":"object","required":["id","email","role","created_at"],"title":"UserOut"},"UserRoleResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"is_active":{"type":"boolean","title":"Is Active","default":true},"deactivated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deactivated At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"last_login_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Login At"},"last_active_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Active At"},"signup_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Country"},"signup_region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Region"}},"type":"object","required":["id","email","role","display_name"],"title":"UserRoleResponse","description":"Response with user role information."},"UtmAttributionResponse":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/UtmAttributionRow"},"type":"array","title":"Rows"},"since":{"type":"string","format":"date","title":"Since"},"until":{"type":"string","format":"date","title":"Until"},"total_signups_with_utm":{"type":"integer","title":"Total Signups With Utm"}},"type":"object","required":["rows","since","until","total_signups_with_utm"],"title":"UtmAttributionResponse","description":"Aggregate response for the admin Signups-by-UTM-source widget (#196)."},"UtmAttributionRow":{"properties":{"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"signups":{"type":"integer","title":"Signups"}},"type":"object","required":["utm_source","utm_medium","utm_campaign","signups"],"title":"UtmAttributionRow","description":"One (utm_source, utm_medium, utm_campaign) row of attributed signups (#196).\n\nRead-time aggregation from ``user_events.properties`` JSON; rows where\n``utm_source`` is null are excluded server-side. ``signups`` is the count\nof ``signup_completed`` events in the window with a non-null source."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyEmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["success","message"],"title":"VerifyEmailResponse","description":"Response to ``GET /auth/verify-email?token=...``."},"VerifyEmailSessionRequest":{"properties":{"token":{"type":"string","maxLength":255,"minLength":1,"title":"Token"},"registrant_proof":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Registrant Proof"},"new_password":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"New Password"}},"type":"object","required":["token"],"title":"VerifyEmailSessionRequest","description":"Body of ``POST /auth/verify-email`` (#871): the token from the link.\n\n#1035: ``registrant_proof`` is what ``POST /auth/register`` gave the\nregistering browser. Without it, an account that holds a password confirms\nonly with ``new_password``, which replaces the registrant's."},"VerifyEmailSessionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"access_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["success","message"],"title":"VerifyEmailSessionResponse","description":"``POST /auth/verify-email`` (#871): a confirmed address signs the user\nin. ``access_token`` is set only when this redemption verified the account\n(not for an already-verified one, nor an account with a second step)."},"VerifyRequest":{"properties":{"manifest":{"additionalProperties":true,"type":"object","title":"Manifest","description":"A provenance manifest as served."},"fields":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"items":{},"type":"array"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Fields","description":"Optionally, the unit's text by field name; verification then also checks the manifest covers exactly this text."}},"type":"object","required":["manifest"],"title":"VerifyRequest"},"VerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"kid_known":{"type":"boolean","title":"Kid Known"}},"type":"object","required":["valid","kid_known"],"title":"VerifyResponse"},"VirtualTourCreate":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"caption":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Caption"},"credit":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Credit"},"license":{"type":"string","title":"License","description":"Required. Use cc0/cc_by_4/wikimedia/official_pr for public render eligibility, or fair_use_excerpt for admin-only."},"ordering":{"type":"integer","title":"Ordering","default":0}},"type":"object","required":["college_id","url","license"],"title":"VirtualTourCreate","description":"Admin payload for adding a virtual-tour row to a college.\n\nLicense must be set to a non-`unknown` value at create time —\notherwise the public-render gate (Step 6) blocks the row from\nrendering, defeating the purpose of curation."},"VirtualTourUpdate":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Url"},"caption":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Caption"},"credit":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Credit"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"ordering":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordering"}},"type":"object","title":"VirtualTourUpdate","description":"All fields optional — partial update."},"WageImportResponse":{"properties":{"updated":{"type":"integer","title":"Updated"},"not_found":{"type":"integer","title":"Not Found"},"vintage":{"type":"integer","title":"Vintage"}},"type":"object","required":["updated","not_found","vintage"],"title":"WageImportResponse","description":"Result of an OEWS workbook upload+ingest."},"WageStatusResponse":{"properties":{"current_vintage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Vintage"},"latest_expected_vintage":{"type":"integer","title":"Latest Expected Vintage"},"update_available":{"type":"boolean","title":"Update Available"},"download_url":{"type":"string","title":"Download Url"},"total_occupations":{"type":"integer","title":"Total Occupations"},"with_wage":{"type":"integer","title":"With Wage"}},"type":"object","required":["current_vintage","latest_expected_vintage","update_available","download_url","total_occupations","with_wage"],"title":"WageStatusResponse","description":"Current wage-data state + calendar-heuristic update signal (no BLS fetch)."},"WorkerState":{"properties":{"name":{"type":"string","title":"Name"},"prefetch_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prefetch Count"},"max_concurrency":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Concurrency"},"uptime_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Uptime Seconds"},"reserved":{"anyOf":[{"items":{"$ref":"#/components/schemas/ReservedMessage"},"type":"array"},{"type":"null"}],"title":"Reserved"}},"type":"object","required":["name"],"title":"WorkerState"},"WorkerStateResponse":{"properties":{"reachable":{"type":"boolean","title":"Reachable"},"degraded_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Degraded Reason"},"workers":{"items":{"$ref":"#/components/schemas/WorkerState"},"type":"array","title":"Workers"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["reachable","workers","meta"],"title":"WorkerStateResponse","description":"Worker inspection result.\n\n**`reachable` is the load-bearing field.** ``reachable=True`` with an empty\n``workers`` list is not a state this endpoint can return: if we could ask,\nat least one worker answered. A worker holding nothing is\n``reachable=True`` with ``reserved=[]``; a broker we could not reach is\n``reachable=False`` with ``degraded_reason`` set.\n\nCollapsing those two into \"no reserved messages\" is the failure this\ncodebase has paid for three times (#606, #568, and #607's entire reason for\nexisting): an absence that reads as an all-clear. Callers must branch on\n``reachable`` before drawing any conclusion from ``workers``."},"YearProjection":{"properties":{"year":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Year"},"in_school":{"type":"boolean","title":"In School"},"post_grad":{"type":"boolean","title":"Post Grad"},"cost_of_attendance":{"$ref":"#/components/schemas/MetricBand"},"grant_aid":{"$ref":"#/components/schemas/MetricBand"},"net_price":{"$ref":"#/components/schemas/MetricBand"},"originated_loan_principal":{"$ref":"#/components/schemas/MetricBand"},"loan_balance":{"$ref":"#/components/schemas/MetricBand"},"annual_loan_payment":{"$ref":"#/components/schemas/MetricBand"},"earnings":{"$ref":"#/components/schemas/MetricBand"},"debt_to_income":{"anyOf":[{"$ref":"#/components/schemas/MetricBand"},{"type":"null"}]},"cumulative_net":{"$ref":"#/components/schemas/MetricBand"}},"additionalProperties":false,"type":"object","required":["year","in_school","post_grad","cost_of_attendance","grant_aid","net_price","originated_loan_principal","loan_balance","annual_loan_payment","earnings","debt_to_income","cumulative_net"],"title":"YearProjection","description":"One year of one college's trajectory.\n\n``year`` is 1-indexed (Y1 = freshman year, Y4 = senior year, Y5 = first\npost-grad year, Y10 = sixth post-grad year). All bands are annual\nflows except ``loan_balance`` (a stock at end-of-year) and\n``cumulative_net`` (a cumulative stock).\n\n``in_school`` and ``post_grad`` are not mutually exclusive in case a\nfuture v2 models summer-bridge programs that overlap; v1 sets\nexactly one to ``True`` per year."},"_AttachSchoolRequest":{"properties":{"school_id":{"type":"string","format":"uuid","title":"School Id"}},"type":"object","required":["school_id"],"title":"_AttachSchoolRequest"},"app__schemas__admin_media__RegenerateResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"rows_created":{"type":"integer","title":"Rows Created"},"rows_skipped":{"type":"integer","title":"Rows Skipped"},"rows_updated":{"type":"integer","title":"Rows Updated"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["college_id","rows_created","rows_skipped","rows_updated"],"title":"RegenerateResponse","description":"Result of admin-triggered force-regenerate for one college."},"app__schemas__admin_outcomes__RegenerateResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"status":{"type":"string","title":"Status"},"short_circuited":{"type":"boolean","title":"Short Circuited","description":"True if the regen short-circuited because input_hash matched. Force=True bypasses this — always False on regenerate calls."},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"sample_size":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sample Size"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["college_id","status","short_circuited","license","sample_size"],"title":"RegenerateResponse","description":"Result of a force-regenerate (admin Re-run button)."},"app__schemas__admin_synthesis__RegenerateResponse":{"properties":{"college_id":{"type":"string","format":"uuid","title":"College Id"},"status":{"type":"string","title":"Status"},"short_circuited":{"type":"boolean","title":"Short Circuited","description":"True if the regen short-circuited because input_hash matched. Force=True bypasses this — always False on regenerate calls."},"tokens_in":{"type":"integer","title":"Tokens In"},"tokens_out":{"type":"integer","title":"Tokens Out"},"cost_usd":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Usd"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["college_id","status","short_circuited","tokens_in","tokens_out","cost_usd","license"],"title":"RegenerateResponse","description":"Result of a force-regenerate. Returns the new profile detail\nso the admin UI can refresh its drawer view in one round-trip."},"app__schemas__admissions_chance__CalibrationReadResponse":{"properties":{"model_version":{"type":"string","title":"Model Version","default":""},"refit_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Refit Run At"},"status":{"type":"string","enum":["succeeded","failed",""],"title":"Status","default":""},"brier_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Brier Score"},"calibration_plot":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Calibration Plot"},"sample_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sample Size"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"stale":{"type":"boolean","title":"Stale","default":false}},"type":"object","title":"CalibrationReadResponse","description":"Latest ``PredictionCalibration`` row for the methodology page.\n\nThe page renders the v1 back-fit-consistency claim verbatim from\n``notes`` (the backend persists ``V1_CALIBRATION_DISCLAIMER`` on every\nsucceeded row). Stale + cold-start states surface in the response so\nthe page doesn't need its own clock or null-handling logic."},"app__schemas__admissions_chance__UncertaintyComponent":{"properties":{"lo":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Lo"},"hi":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Hi"},"description":{"type":"string","minLength":1,"title":"Description"}},"type":"object","required":["lo","hi","description"],"title":"UncertaintyComponent","description":"One half of the band decomposition: statistical or out-of-model.\n\n``lo`` and ``hi`` are raw probabilities in [0, 1]. ``description`` is\na human-readable explanation that the methodology page renders."},"app__schemas__college_stats__StateSummary":{"properties":{"state":{"type":"string","title":"State"},"state_name":{"type":"string","title":"State Name"},"total_colleges":{"type":"integer","title":"Total Colleges"},"avg_tuition_in_state":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Tuition In State"},"avg_tuition_out_state":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Tuition Out State"}},"type":"object","required":["state","state_name","total_colleges"],"title":"StateSummary","description":"Lightweight state summary for all-states endpoint."},"app__schemas__life_path__CalibrationReadResponse":{"properties":{"model_version":{"type":"string","title":"Model Version","default":""},"refit_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Refit Run At"},"status":{"type":"string","enum":["succeeded","failed",""],"title":"Status","default":""},"brier_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Brier Score"},"calibration_plot":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Calibration Plot"},"sample_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sample Size"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"stale":{"type":"boolean","title":"Stale","default":false}},"additionalProperties":false,"type":"object","title":"CalibrationReadResponse","description":"Latest ``PredictionCalibration`` row for the methodology page.\n\nMirror of :class:`app.schemas.admissions_chance.CalibrationReadResponse`\nwith a different unit semantic: ``brier_score`` carries MAE in USD\nfor life-path rows (see #384 plan, commit 3 — column re-use, not\nsemantic forking). The methodology page formats with its own\nhelper so the \"Brier\" label never reaches the visitor.\n\nCold-start (no rows yet) returns the default sentinel fields so the\npage can render a \"calibration data is being computed\" state\nwithout conditional 404 handling."},"app__schemas__life_path__UncertaintyComponent":{"properties":{"description":{"type":"string","minLength":1,"title":"Description"}},"additionalProperties":false,"type":"object","required":["description"],"title":"UncertaintyComponent","description":"One half of the band decomposition: statistical or out-of-model.\n\nSame shape as :class:`app.schemas.admissions_chance.UncertaintyComponent`\nbut applied at the per-prediction level (one ``statistical`` and one\n``out_of_model`` component per :class:`LifePathPrediction`, describing\nthe composition methodology that produced the per-metric per-year\nbands). The methodology page renders ``description`` verbatim."},"app__schemas__school__StateSummary":{"properties":{"state":{"type":"string","title":"State"},"school_count":{"type":"integer","title":"School Count"}},"type":"object","required":["state","school_count"],"title":"StateSummary","description":"State with school count."}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Developer API key issued via POST /api/developer/keys. Required scope is enforced per router; see the `x-required-scope` extension on each operation."}}},"tags":[{"name":"auth","description":"User registration, login, password reset, OAuth, and account management"},{"name":"chat","description":"AI-powered college counseling conversations and streaming"},{"name":"colleges","description":"College search, details, statistics, and comparisons"},{"name":"saved-colleges","description":"Save, rank, and manage college lists"},{"name":"programs","description":"Academic programs and occupation/career data"},{"name":"scholarships","description":"Scholarship search, management, and administration"},{"name":"merit-scholarships","description":"Public merit scholarship browsing and search"},{"name":"financial-aid","description":"SAI calculator and financial aid package comparison"},{"name":"athletics","description":"College athletics data, team search, and sport filters"},{"name":"athletics-recruitment","description":"Recruitment tracking, coach communications, performance logging, and videos"},{"name":"profiles","description":"User profile management, completeness tracking, and auto-fill"},{"name":"profile","description":"Profile completeness and auto-fill utilities"},{"name":"reviews","description":"Student-submitted college reviews and ratings"},{"name":"resources","description":"Blog articles and college guidance content"},{"name":"documents","description":"File upload and document management"},{"name":"email-templates","description":"Outreach email template management"},{"name":"outreach-recipients","description":"Contact and recipient management for outreach"},{"name":"outreach-activities","description":"Outreach activity tracking and logging"},{"name":"admin","description":"User administration, role management, and system controls"},{"name":"audit-logs","description":"Audit log retrieval and filtering"},{"name":"events","description":"Custom event ingestion for analytics"},{"name":"developer","description":"Developer self-service: registration, API key management, usage stats"},{"name":"leads","description":"Landing page lead capture"},{"name":"feedback","description":"In-app feedback and suggestions"},{"name":"locations","description":"Location and address lookup"},{"name":"schools","description":"K-12 school search (public)"},{"name":"inbound-email","description":"Mailjet webhook for inbound email processing"},{"name":"tools","description":"Anonymous tool landers (net-price calculator, scholarship matcher, etc.)"},{"name":"devices","description":"Push notification device registration and notification preferences"}]}