{"openapi":"3.1.0","info":{"title":"Zicron API","description":"\nMedical claims extraction and inference API.\n\n## Quick Start\n1. Get API key: https://app.zicron.ai/settings/api-keys\n2. Make your first request:\n```bash\ncurl -X POST https://api.claims.zicron.ai/v1/extract \\\n -H \"Authorization: Bearer zk_live_YOUR_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\":\"Patient has chronic back pain...\",\"claim_type\":\"ssdi\"}'\n```\n\n## Authentication\nUse API keys in the `Authorization` header:\n```\nAuthorization: Bearer zk_live_...\n```\n\n## Pricing\n- Extraction: $0.25/page (vision), $0.10/page (text)\n- Inference: $5 per claim scored\n- Forms: $2 per government form\n- Free tier: 1,000 pages/month\n\n## Rate Limits\n- Free tier: 30 requests/minute, 100 requests/hour\n- Paid tier: Custom limits available\n- Cost limits: $50/day (extract), $25/day (inference)\n\n## Support\n- Documentation: https://api.claims.zicron.ai/docs\n- Email: developers@zicron.ai\n- GitHub: https://github.com/zicron-ai/api-examples\n ","contact":{"name":"Zicron Developer Support","email":"developers@zicron.ai"},"version":"1.0.0"},"servers":[{"url":"https://api.claims.zicron.ai","description":"Production"},{"url":"http://localhost:8000","description":"Local Development"}],"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Top Level Health","description":"Top-level health check for Railway/load-balancer probes (no DB needed).","operationId":"top_level_health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/auth/register":{"post":{"tags":["auth"],"summary":"Register","description":"Register a new org + admin user.","operationId":"register_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","description":"Login with email + password. Sets session cookie.","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/magic-login":{"post":{"tags":["auth"],"summary":"Magic Login","description":"Verify magic link token and issue session cookie.\n\nMagic links are one-time use tokens sent via email. After verification,\nthe magic link session is invalidated and replaced with a long-lived session.","operationId":"magic_login_v1_auth_magic_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"Logout — invalidate session.","operationId":"logout_v1_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/auth/verify-email":{"post":{"tags":["auth"],"summary":"Verify Email","description":"Verify email address with token from verification email.","operationId":"verify_email_v1_auth_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/resend-verification":{"post":{"tags":["auth"],"summary":"Resend Verification","description":"Resend verification email.","operationId":"resend_verification_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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/forgot-password":{"post":{"tags":["auth"],"summary":"Forgot Password","description":"Request a password reset email.","operationId":"forgot_password_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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/reset-password":{"post":{"tags":["auth"],"summary":"Reset Password","description":"Reset password using token from reset email.","operationId":"reset_password_v1_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/change-password":{"post":{"tags":["auth"],"summary":"Change Password","description":"Change password for authenticated user (requires current password).","operationId":"change_password_v1_auth_change_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/me":{"patch":{"tags":["auth"],"summary":"Update Me","description":"Update the current user's mutable profile fields (e.g. persona).","operationId":"update_me_v1_auth_me_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/api-keys/{key_id}/rotate":{"post":{"tags":["auth"],"summary":"Rotate Api Key","description":"Rotate an API key. Creates a new key and puts the old one into a grace period.\n\n# legacy: api_keys.manage@1 (action rotate) does the same (web-caps slice 14).","operationId":"rotate_api_key_v1_auth_api_keys__key_id__rotate_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateApiKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/setup":{"post":{"tags":["auth"],"summary":"Mfa Setup","description":"Generate a new TOTP secret for the current user.\n\nReturns the secret and a provisioning URI for QR code display.\nThe user must call /mfa/verify with a valid code to actually enable MFA.","operationId":"mfa_setup_v1_auth_mfa_setup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaSetupResponse"}}}}}}},"/v1/auth/mfa/verify":{"post":{"tags":["auth"],"summary":"Mfa Verify","description":"Verify a TOTP code and enable MFA if valid.\n\nUsed during both setup (to confirm the user configured their app) and\nlogin (to complete 2FA).","operationId":"mfa_verify_v1_auth_mfa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/login":{"post":{"tags":["auth"],"summary":"Mfa Login","description":"Complete MFA login — verify TOTP code and issue session.","operationId":"mfa_login_v1_auth_mfa_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__auth_routes__MfaLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/setup/sms":{"post":{"tags":["auth"],"summary":"Mfa Setup Sms","description":"Request SMS MFA setup — sends a verification code to the phone number.","operationId":"mfa_setup_sms_v1_auth_mfa_setup_sms_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaSmsSetupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/verify/sms":{"post":{"tags":["auth"],"summary":"Mfa Verify Sms","description":"Verify SMS code and enable SMS MFA.","operationId":"mfa_verify_sms_v1_auth_mfa_verify_sms_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaSmsVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/login/sms":{"post":{"tags":["auth"],"summary":"Mfa Login Sms","description":"Complete MFA login with SMS code.","operationId":"mfa_login_sms_v1_auth_mfa_login_sms_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__mfa_extended__MfaLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/setup/email":{"post":{"tags":["auth"],"summary":"Mfa Setup Email","description":"Request Email MFA setup — sends a verification code to the email address.","operationId":"mfa_setup_email_v1_auth_mfa_setup_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEmailSetupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/verify/email":{"post":{"tags":["auth"],"summary":"Mfa Verify Email","description":"Verify Email code and enable Email MFA.","operationId":"mfa_verify_email_v1_auth_mfa_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEmailVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/mfa/login/email":{"post":{"tags":["auth"],"summary":"Mfa Login Email","description":"Complete MFA login with Email code.","operationId":"mfa_login_email_v1_auth_mfa_login_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__mfa_extended__MfaLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webhooks/twilio/sms-status":{"post":{"tags":["auth"],"summary":"Twilio Sms Status Webhook","description":"Receive SMS delivery status from Twilio.\n\nConfigure in Twilio console under Phone Numbers > Configure > Messaging:\n- Status Callback URL: https://claims.zicron.ai/v1/auth/webhooks/twilio/sms-status\n- Method: POST\n\nTwilio sends status updates: queued, sent, delivered, failed, undelivered.","operationId":"twilio_sms_status_webhook_v1_auth_webhooks_twilio_sms_status_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/branding/effective":{"get":{"tags":["branding"],"summary":"Get Effective Brand","description":"Return merged brand for auth user's active org.\n\nMerges brands.yaml preset + Organization.settings.brand overrides.\nUsed by PDF renderers, email templates, and share links.\n\nServer-rendered on every page (``BrandingProvider``, ``app/icon.tsx``; row 277, kept as a plain read).\nThe settings page reads ``org.branding.get@1`` (web-caps slice 14): the same answer\n(``orgadmin/branding.effective_brand``), both with ``logo_url``/``favicon_url`` signed links.","operationId":"get_effective_brand_v1_branding_effective_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/branding":{"patch":{"tags":["branding"],"summary":"Update Brand","description":"Update org brand settings.\n\n# legacy: web moved to org.branding.update@1 on 2026-09-28 (web-caps slice 14). Same validation\n# (``orgadmin/branding.validated_updates``: colors must be hex; the route stored any string).\n\nRequires admin/owner role. Updates are stored in Organization.settings.brand\nand override the preset from brands.yaml.\n\nNote: This endpoint does NOT require the white_label feature flag.\nAll orgs can customize branding for documents/share links (Phase 2 scope).\nPortal UI branding (Phase 5) will be gated by feature flag.","operationId":"update_brand_v1_branding_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/branding/tenant":{"get":{"tags":["branding"],"summary":"Get Tenant Branding","description":"Get tenant branding configuration for the authenticated org.\n\nReturns B2B white-label settings for:\n- Visual identity (logo, colors, fonts)\n- Agent behavior (voice tone, name)\n- Contact information (support email/phone)\n- White-label settings (hide Zicron branding, powered-by footer)\n\nIf no tenant branding exists, returns defaults (Zicron branding).","operationId":"get_tenant_branding_v1_branding_tenant_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantBrandingResponse"}}}}}},"put":{"tags":["branding"],"summary":"Update Tenant Branding","description":"Update tenant branding configuration.\n\nRequires admin/owner role. Creates or updates the TenantBranding record\nfor the authenticated org.\n\nUsed by B2B partners (e.g., Claimify) to customize:\n- Conversation agent appearance and tone\n- Frontend theme (colors, fonts, logo)\n- White-label settings\n\nExample:\n PUT /api/v1/branding/tenant\n {\n \"company_name\": \"Claimify\",\n \"primary_color\": \"#2563eb\",\n \"agent_name\": \"Claimify Assistant\",\n \"agent_voice_tone\": \"professional\",\n \"hide_zicron_branding\": true\n }","operationId":"update_tenant_branding_v1_branding_tenant_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantBrandingUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantBrandingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims":{"post":{"tags":["claims"],"summary":"Create Claim","description":"Create a new claim.\n\nStrangler shim over ``cases.create@1`` (capabilities/MIGRATION.md): the\ncapability runs the workflow, write gates, usage limits and intake triage.","operationId":"create_claim_v1_claims_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClaimRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["claims"],"summary":"List Claims","description":"List claims with optional status, tier, and triage filters.\n\nDefault status filter is 'active' to preserve the long-standing /claims\npage behavior. The intake list page passes status='intake' explicitly.","operationId":"list_claims_v1_claims_get","parameters":[{"name":"lifecycle_stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by lifecycle stage","title":"Lifecycle Stage"},"description":"Filter by lifecycle stage"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by claim status: 'active' (default for the active claims view), 'intake' (intake triage view), or 'closed'. Pass 'all' to disable filtering.","title":"Status"},"description":"Filter by claim status: 'active' (default for the active claims view), 'intake' (intake triage view), or 'closed'. Pass 'all' to disable filtering."},{"name":"intake_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by intake tier: promising | needs_info | weak | unknown","title":"Intake Tier"},"description":"Filter by intake tier: promising | needs_info | weak | unknown"},{"name":"has_inference","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"When true, only claims with an inference_result. When false, only claims without one.","title":"Has Inference"},"description":"When true, only claims with an inference_result. When false, only claims without one."},{"name":"flagged","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter to flagged claims only","title":"Flagged"},"description":"Filter to flagged claims only"},{"name":"include_closed","in":"query","required":false,"schema":{"type":"boolean","description":"When true and status='intake', also include status='closed' rows (the 'show closed' toggle).","default":false,"title":"Include Closed"},"description":"When true and status='intake', also include status='closed' rows (the 'show closed' toggle)."},{"name":"include_empty","in":"query","required":false,"schema":{"type":"boolean","description":"When true, include intake claims with zero documents (orphans). Default hides them.","default":false,"title":"Include Empty"},"description":"When true, include intake claims with zero documents (orphans). Default hides them."},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","description":"Sort order: updated | score_asc | score_desc | gaps_desc | risk_desc","default":"updated","title":"Sort By"},"description":"Sort order: updated | score_asc | score_desc | gaps_desc | risk_desc"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedClaimsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/seed":{"post":{"tags":["claims"],"summary":"Seed Claim","description":"Seed a claim with pre-built extraction/inference data (for e2e tests).","operationId":"seed_claim_v1_claims__claim_id__seed_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedClaimRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}":{"get":{"tags":["claims"],"summary":"Get Claim","description":"Get full claim detail.","operationId":"get_claim_v1_claims__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/fields/{field_path}/history":{"get":{"tags":["claims"],"summary":"Get Field History","description":"Get the changelog history for a specific field.","operationId":"get_field_history_v1_claims__claim_id__fields__field_path__history_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"field_path","in":"path","required":true,"schema":{"type":"string","title":"Field Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FieldHistoryEntry"},"title":"Response Get Field History V1 Claims Claim Id Fields Field Path History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/provenance/fields/{field_path}":{"get":{"tags":["claims"],"summary":"Get Field Provenance","description":"Get provenance for a specific field.","operationId":"get_field_provenance_v1_claims__claim_id__provenance_fields__field_path__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"field_path","in":"path","required":true,"schema":{"type":"string","title":"Field Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldProvenanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/provenance/conflicts":{"get":{"tags":["claims"],"summary":"Get Claim Conflicts","description":"Get all conflicts for a claim.","operationId":"get_claim_conflicts_v1_claims__claim_id__provenance_conflicts_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConflictsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/snapshot":{"get":{"tags":["claims"],"summary":"Get Snapshot","description":"Reconstruct field values at a point in time from the changelog.","operationId":"get_snapshot_v1_claims__claim_id__snapshot_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"at","in":"query","required":true,"schema":{"type":"string","description":"ISO 8601 timestamp for point-in-time reconstruction","title":"At"},"description":"ISO 8601 timestamp for point-in-time reconstruction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/documents":{"post":{"tags":["claims"],"summary":"Upload Document","description":"Upload a document — enqueues extraction pipeline as a background task (persistent mode)\nor runs synchronously (in-memory mode).\n\nPersistent mode returns 202 Accepted with a task_id.\nIn-memory mode returns 200 with synchronous extraction results.\n\nIf document_type is not provided, PDF documents will be auto-classified.","operationId":"upload_document_v1_claims__claim_id__documents_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"title":"Document Type"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_document_v1_claims__claim_id__documents_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/infer/{target_type}":{"post":{"tags":["claims"],"summary":"Run Vertical Inference","description":"Run a specific vertical's inference engine on this claim.\n\nThis allows running multiple inference engines on the same extraction\ndata — e.g., running both SSDI and VA engines on a veteran's records.\nResults are stored in `inference_results[target_type]` without\noverwriting the primary inference.\n\nPass ``?enrich=true`` to inject cross-reference data from sibling\nengine outputs into the input dict before scoring.","operationId":"run_vertical_inference_v1_claims__claim_id__infer__target_type__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"target_type","in":"path","required":true,"schema":{"type":"string","title":"Target Type"}},{"name":"enrich","in":"query","required":false,"schema":{"type":"boolean","description":"When true, enriches engine input with cross-reference data from already-completed inference results on this claim.","default":false,"title":"Enrich"},"description":"When true, enriches engine input with cross-reference data from already-completed inference results on this claim."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/reinfer":{"post":{"tags":["claims"],"summary":"Reinfer Claim","description":"Re-run the primary inference engine on this claim.\n\nUses the claim's own type to re-score against the current merged\nextraction data with any active overrides applied. Useful after\nengine updates without needing to re-extract.","operationId":"reinfer_claim_v1_claims__claim_id__reinfer_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/inference/{target_type}":{"get":{"tags":["claims"],"summary":"Get Vertical Inference","description":"Get inference results for a specific vertical on this claim.","operationId":"get_vertical_inference_v1_claims__claim_id__inference__target_type__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"target_type","in":"path","required":true,"schema":{"type":"string","title":"Target Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/inference":{"get":{"tags":["claims"],"summary":"List Vertical Inferences","description":"List all vertical inference results available for this claim.","operationId":"list_vertical_inferences_v1_claims__claim_id__inference_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-projection":{"get":{"tags":["claims"],"summary":"Get Msa Projection","description":"Get MSA cost projection for an MSA claim.","operationId":"get_msa_projection_v1_claims__claim_id__msa_projection_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/reports/{report_type}":{"get":{"tags":["claims"],"summary":"Get Report","description":"Generate a report.\n\n``audience`` controls PHI redaction:\n * ``\"attorney\"`` (default) — full report, no redaction.\n * ``\"client\"`` — PHI scrubbed (SSN, DOB, MRN, addresses, phone,\n email, Bates numbers, block-quoted record citations).","operationId":"get_report_v1_claims__claim_id__reports__report_type__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"report_type","in":"path","required":true,"schema":{"type":"string","title":"Report Type"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}},{"name":"audience","in":"query","required":false,"schema":{"type":"string","default":"attorney","title":"Audience"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/reports/{report_type}/pdf":{"get":{"tags":["claims"],"summary":"Get Report Pdf","description":"Generate a report and return it as a PDF.\n\nSee ``GET /claims/{id}/reports/{type}`` for the ``audience`` parameter\n(controls PHI redaction).\n\n``include_source_pages`` (attorney audience only) appends a \"Source Pages\"\nappendix reproducing each cited page as an image, making the PDF a\nself-contained evidence bundle (Portable Citations, \"Mode B\").","operationId":"get_report_pdf_v1_claims__claim_id__reports__report_type__pdf_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"report_type","in":"path","required":true,"schema":{"type":"string","title":"Report Type"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}},{"name":"audience","in":"query","required":false,"schema":{"type":"string","default":"attorney","title":"Audience"}},{"name":"include_source_pages","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Source Pages"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/reports":{"get":{"tags":["claims"],"summary":"List Available Reports","description":"Discover which reports are available for a claim.\n\nReturns builtin, vertical-specific, and cross-vertical report types\nbased on the claim's type and which verticals have been scored.","operationId":"list_available_reports_v1_claims__claim_id__reports_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/workflow":{"get":{"tags":["claims"],"summary":"Get Workflow","description":"Get workflow state.","operationId":"get_workflow_v1_claims__claim_id__workflow_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/export/{format}":{"post":{"tags":["claims"],"summary":"Export Claim","description":"Export claim data.","operationId":"export_claim_v1_claims__claim_id__export__format__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"format","in":"path","required":true,"schema":{"type":"string","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/track":{"post":{"tags":["claims"],"summary":"Track Event","description":"Track consumer funnel events (consumer_assessment_viewed, referral_clicked).","operationId":"track_event_v1_claims__claim_id__track_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackEventRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/documents/batch":{"post":{"tags":["claims"],"summary":"Create Batch Upload","description":"Create batch upload task with all files in 'queued' state.\n\nReturns immediately with batch_task_id; client uses SSE to watch progress.\nAll files shown in 'queued' state upfront, then processed asynchronously.","operationId":"create_batch_upload_v1_claims__claim_id__documents_batch_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_batch_upload_v1_claims__claim_id__documents_batch_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/notes":{"get":{"tags":["claims"],"summary":"List Notes","description":"List notes for a claim.","operationId":"list_notes_v1_claims__claim_id__notes_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteResponse"},"title":"Response List Notes V1 Claims Claim Id Notes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/notifications/hospice/upload-confirmation":{"post":{"tags":["Notifications"],"summary":"Send Hospice Upload Confirmation","description":"Send upload confirmation email for hospice LCD analysis.","operationId":"send_hospice_upload_confirmation_v1_notifications_hospice_upload_confirmation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadConfirmationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Send Hospice Upload Confirmation V1 Notifications Hospice Upload Confirmation Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/notifications/hospice/analysis-complete":{"post":{"tags":["Notifications"],"summary":"Send Hospice Analysis Complete","description":"Send analysis complete email for hospice LCD analysis.","operationId":"send_hospice_analysis_complete_v1_notifications_hospice_analysis_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Send Hospice Analysis Complete V1 Notifications Hospice Analysis Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/extract":{"post":{"summary":"Extract from text","description":"Extract structured medical data from text content.\n\n**Use this endpoint for**:\n- Plain text medical records\n- OCR'ed documents that are already converted to text\n- Structured text formats (HL7, FHIR, etc. - use /ingest/structured instead)\n\n**Cost**: $0.10 per page (~2000 characters)\n\n**Rate Limits**: 30 requests/minute, 100 requests/hour per API key\n\n**Required Scope**: `extract:write`","operationId":"extract_text_v1_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractionRequest"}}},"required":true},"responses":{"200":{"description":"Extraction successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractionResponse"},"example":{"success":true,"data":{"diagnoses":[{"condition":"Chronic lower back pain","icd10_code":"M54.5","onset_date":"2023-01-01","severity":"moderate"},{"condition":"L4-L5 disc herniation","icd10_code":"M51.26","onset_date":"2023-01-01"}],"functional_limitations":["Cannot lift >10 lbs","Cannot sit >30 minutes"],"medications":[{"name":"Ibuprofen","dosage":"800mg","frequency":"TID"}]},"warnings":[],"metadata":{"model":"claude-sonnet-4","claim_type":"ssdi","duration_seconds":1.8,"content_length":150,"record_id":"rec_abc123","has_delta":false}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"400":{"description":"Invalid request","content":{"application/json":{"example":{"error":{"code":"invalid_request","message":"content must be at least 50 characters","param":"content","type":"invalid_request_error"},"request_id":"req_abc123"}}}},"403":{"description":"Missing required scope","content":{"application/json":{"example":{"error":{"code":"permission_denied","message":"Insufficient permissions. Missing scopes: extract:write","param":"scopes","type":"authorization_error"},"request_id":"req_abc123"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"error":{"code":"rate_limit_exceeded","message":"Rate limit exceeded. Try again in 42 seconds.","type":"rate_limit_error"},"request_id":"req_abc123"}}}}},"x-codeSamples":[{"lang":"curl","label":"cURL","source":"curl -X POST https://api.claims.zicron.ai/v1/extract \\\n -H \"Authorization: Bearer zk_live_YOUR_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"content\": \"Patient presents with chronic lower back pain since 2023. MRI shows L4-L5 disc herniation. Referred to neurosurgery.\",\n \"claim_type\": \"ssdi\"\n }'\n"},{"lang":"python","label":"Python","source":"import requests\n\nresponse = requests.post(\n \"https://api.claims.zicron.ai/v1/extract\",\n headers={\"Authorization\": \"Bearer zk_live_YOUR_KEY\"},\n json={\n \"content\": \"Patient presents with chronic lower back pain...\",\n \"claim_type\": \"ssdi\"\n }\n)\n\ndata = response.json()\nif data[\"success\"]:\n print(f\"Extracted {len(data['data'].get('diagnoses', []))} diagnoses\")\n print(f\"Duration: {data['metadata']['duration_seconds']}s\")\n"},{"lang":"typescript","label":"TypeScript","source":"const response = await fetch(\"https://api.claims.zicron.ai/v1/extract\", {\n method: \"POST\",\n headers: {\n \"Authorization\": \"Bearer zk_live_YOUR_KEY\",\n \"Content-Type\": \"application/json\"\n },\n body: JSON.stringify({\n content: \"Patient presents with chronic lower back pain...\",\n claim_type: \"ssdi\"\n })\n});\n\nconst data = await response.json();\nif (data.success) {\n console.log(`Extracted ${data.data.diagnoses?.length || 0} diagnoses`);\n console.log(`Duration: ${data.metadata.duration_seconds}s`);\n}\n"}]}},"/v1/extract/file":{"post":{"summary":"Extract File","description":"Extract structured data from an uploaded file.","operationId":"extract_file_v1_extract_file_post","parameters":[{"name":"claim_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ClaimType"},{"type":"null"}],"title":"Claim Type"}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"title":"Document Type"}},{"name":"mechanism","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}],"title":"Mechanism"}},{"name":"password","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional password for encrypted PDFs","title":"Password"},"description":"Optional password for encrypted PDFs"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_file_v1_extract_file_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/recent":{"get":{"tags":["history"],"summary":"List Recent","description":"List the most recent extraction records across all claim types.","operationId":"list_recent_v1_history_recent_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecordSummary"},"title":"Response List Recent V1 History Recent Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/record/{record_id}":{"get":{"tags":["history"],"summary":"Get Record","description":"Retrieve a specific extraction record by its ID.\n\nReturns the full ExtractionRecord including extraction_output.","operationId":"get_record_v1_history_record__record_id__get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/delta":{"get":{"tags":["history"],"summary":"Compare Records","description":"Compare two extraction records and return a structured delta.\n\nPass record IDs as query parameters, e.g.\n``/history/delta?record_a=wc/2026-03-26_abc123&record_b=wc/2026-03-25_abc123``","operationId":"compare_records_v1_history_delta_get","parameters":[{"name":"record_a","in":"query","required":true,"schema":{"type":"string","description":"Record ID of the first (current) extraction","title":"Record A"},"description":"Record ID of the first (current) extraction"},{"name":"record_b","in":"query","required":true,"schema":{"type":"string","description":"Record ID of the second (prior) extraction","title":"Record B"},"description":"Record ID of the second (prior) extraction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeltaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["history"],"summary":"Compare Upload Against Prior","description":"Upload a file, find its prior extraction by content hash, and return the delta.\n\nThis does NOT run a new extraction — it compares the most recent stored\nextraction for this content against the one before it.","operationId":"compare_upload_against_prior_v1_history_delta_post","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_compare_upload_against_prior_v1_history_delta_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeltaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/{claim_type}":{"get":{"tags":["history"],"summary":"List By Claim Type","description":"List the most recent extraction records for a specific claim type.","operationId":"list_by_claim_type_v1_history__claim_type__get","parameters":[{"name":"claim_type","in":"path","required":true,"schema":{"type":"string","title":"Claim Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecordSummary"},"title":"Response List By Claim Type V1 History Claim Type Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ingest/bulk":{"post":{"tags":["ingress"],"summary":"Ingest Bulk","description":"Extract structured data from an archive (ZIP, RAR, or 7z) containing multiple documents.\n\nSupports PDFs, text files, FHIR JSON, CCDA XML, HL7 v2, and X12 EDI within the archive.\nEach document is extracted independently with the same claim context.","operationId":"ingest_bulk_v1_ingest_bulk_post","parameters":[{"name":"claim_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ClaimType"},{"type":"null"}],"title":"Claim Type"}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"title":"Document Type"}},{"name":"mechanism","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}],"title":"Mechanism"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ingest_bulk_v1_ingest_bulk_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkExtractionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ingest/structured":{"post":{"tags":["ingress"],"summary":"Ingest Structured","description":"Ingest structured medical data (FHIR JSON, CCDA XML, HL7 v2, or X12 EDI).\n\nParses coded medical data directly — no LLM extraction needed for\ncoded fields. Returns structured data that can supplement extraction.","operationId":"ingest_structured_v1_ingest_structured_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ingest_structured_v1_ingest_structured_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StructuredDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ingest/email":{"post":{"tags":["ingress"],"summary":"Ingest Email","description":"Extract structured data from a forwarded email (.eml) with attachments.\n\nParses MIME email, extracts all supported attachments (PDF, text, FHIR, CCDA, HL7v2, X12),\nand runs extraction on each. Email body text is preserved as context.","operationId":"ingest_email_v1_ingest_email_post","parameters":[{"name":"claim_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ClaimType"},{"type":"null"}],"title":"Claim Type"}},{"name":"document_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"title":"Document Type"}},{"name":"mechanism","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}],"title":"Mechanism"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ingest_email_v1_ingest_email_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailExtractionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events/claims/{claim_id}/stream":{"get":{"tags":["events"],"summary":"Stream Claim Events","description":"SSE stream for realtime pipeline events on a claim.\n\nConnect after starting an upload to watch progress in real time.\nSupports reconnection via `last_sequence` query param.","operationId":"stream_claim_events_v1_events_claims__claim_id__stream_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"last_sequence","in":"query","required":false,"schema":{"type":"integer","description":"Resume from this sequence number","default":0,"title":"Last Sequence"},"description":"Resume from this sequence number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events/claims/{claim_id}/field-stream":{"get":{"tags":["events"],"summary":"Stream Claim Field Updates","description":"SSE stream for real-time claim field updates.\n\nUnlike the pipeline stream (/stream) which auto-closes on pipeline_complete,\nthis stream stays open indefinitely and only delivers field-level events\nrelevant to intake and multi-actor collaboration (e.g. intake_field_updated,\nconversation_completed, claim_status_changed).","operationId":"stream_claim_field_updates_v1_events_claims__claim_id__field_stream_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"last_sequence","in":"query","required":false,"schema":{"type":"integer","description":"Resume from this sequence number","default":0,"title":"Last Sequence"},"description":"Resume from this sequence number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketing/leads":{"get":{"tags":["marketing"],"summary":"List Leads","description":"List leads. Requires admin key header or authenticated session.","operationId":"list_leads_v1_marketing_leads_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["marketing"],"summary":"Create Lead","description":"Store a lead in the database.","operationId":"create_lead_v1_marketing_leads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLeadRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketing/leads/summary":{"get":{"tags":["marketing"],"summary":"Leads Summary","description":"Lead counts by channel over the last ``days`` days (admin only).\n\n``ai_sourced`` = ai_referral + agent_api + agent_mcp. This is the number\nthe weekly check reads. Rows created before migration 079 are classified\non read with the same rules.","operationId":"leads_summary_v1_marketing_leads_summary_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketing/leads/{lead_id}":{"patch":{"tags":["marketing"],"summary":"Update Lead","description":"Update lead status or notes. Requires admin key or authenticated session.","operationId":"update_lead_v1_marketing_leads__lead_id__patch","parameters":[{"name":"lead_id","in":"path","required":true,"schema":{"type":"string","title":"Lead Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLeadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketing/events":{"get":{"tags":["marketing"],"summary":"List Analytics Events","description":"List analytics events. Requires admin key header.","operationId":"list_analytics_events_v1_marketing_events_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["marketing"],"summary":"Create Analytics Event","description":"Store an analytics event in the database.","operationId":"create_analytics_event_v1_marketing_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAnalyticsEventRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/profile":{"post":{"tags":["profiles"],"summary":"Create Profile","description":"Create a person record for a claim (or return existing).","operationId":"create_profile_v1_claims__claim_id__profile_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["profiles"],"summary":"Get Profile","description":"Get person profile for a claim.","operationId":"get_profile_v1_claims__claim_id__profile_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["profiles"],"summary":"Update Profile","description":"Update person profile for a claim.","operationId":"update_profile_v1_claims__claim_id__profile_patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/intake":{"post":{"tags":["profiles"],"summary":"Update Intake","description":"Update intake fields for a claim, trigger derivation, and return completeness.\n\nThis is the primary endpoint for the intake wizard and conversation tools.\nIt validates fields against the intake registry, runs the derivation engine,\nupdates the person, and returns the current completeness score.","operationId":"update_intake_v1_claims__claim_id__intake_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeCompletenessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/intake/completeness":{"get":{"tags":["profiles"],"summary":"Get Intake Completeness","description":"Get current intake completeness score for a claim.","operationId":"get_intake_completeness_v1_claims__claim_id__intake_completeness_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"claim_type","in":"query","required":true,"schema":{"type":"string","title":"Claim Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeCompletenessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/deadlines":{"post":{"tags":["deadlines"],"summary":"Create Deadline","description":"Create a deadline for a claim.","operationId":"create_deadline_v1_claims__claim_id__deadlines_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeadlineRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeadlineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/notifications":{"get":{"tags":["deadlines"],"summary":"List Notifications","description":"List user notifications.","operationId":"list_notifications_v1_notifications_get","parameters":[{"name":"unread_only","in":"query","required":false,"schema":{"type":"boolean","description":"Filter to unread notifications only","default":false,"title":"Unread Only"},"description":"Filter to unread notifications only"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NotificationResponse"},"title":"Response List Notifications V1 Notifications Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/notifications/{notification_id}/read":{"patch":{"tags":["deadlines"],"summary":"Mark Notification Read","description":"Mark a notification as read.","operationId":"mark_notification_read_v1_notifications__notification_id__read_patch","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/notifications/read-all":{"post":{"tags":["deadlines"],"summary":"Mark All Notifications Read","description":"Mark all notifications as read for the current user.","operationId":"mark_all_notifications_read_v1_notifications_read_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/invite/{token}":{"get":{"tags":["demo-auth"],"summary":"Get Invite Info","description":"Public endpoint — return invite metadata for the landing page.","operationId":"get_invite_info_v1_demo_invite__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/DemoInviteInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/auth":{"post":{"tags":["demo-auth"],"summary":"Demo Auth","description":"Passwordless demo auth — validate invite token + email/phone, create session.","operationId":"demo_auth_v1_demo_auth_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/bootstrap":{"post":{"tags":["demo-seed"],"summary":"Bootstrap Superadmin","description":"Create superadmin user + Zicron Internal org. Requires ADMIN_KEY header.","operationId":"bootstrap_superadmin_v1_demo_bootstrap_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/seed":{"post":{"tags":["demo-seed"],"summary":"Seed Demo","description":"Seed demo org with golden set records + real inference. Superadmin only.","operationId":"seed_demo_v1_demo_seed_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/reset":{"post":{"tags":["demo-seed"],"summary":"Reset Demo","description":"Wipe all demo claims/documents and re-seed them. Users are preserved. Superadmin only.","operationId":"reset_demo_v1_demo_reset_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/reseed-scripts":{"post":{"tags":["demo-seed"],"summary":"Reseed Demo Scripts","description":"Re-provision conversation scripts from the markdown files. Superadmin only.\n\nClaims, documents, and users are PRESERVED. Use this to pick up edits to\n``conversations/scripts/*.md`` without wiping demo data. Scripts are cached\nin the DB as ``ConversationScript.parsed_steps`` and loaded from there at\nruntime, so a reseed is required for any ``.md`` change to take effect.","operationId":"reseed_demo_scripts_v1_demo_reseed_scripts_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/reset/{claim_id}":{"post":{"tags":["demo-seed"],"summary":"Reset Demo Claim","description":"Wipe and re-seed a single demo claim. Superadmin only.\n\nAccepts either 'demo-ssdi-003' or 'ssdi-003' format.\nRuns inference during re-seed (~1-2s).","operationId":"reset_demo_claim_v1_demo_reset__claim_id__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/reset-users":{"post":{"tags":["demo-seed"],"summary":"Reset Demo Users","description":"Wipe and re-seed demo users. Claims are preserved. Superadmin only.","operationId":"reset_demo_users_v1_demo_reset_users_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/reset-all":{"post":{"tags":["demo-seed"],"summary":"Reset Demo All","description":"Wipe all demo data (claims + users) and re-seed everything. Superadmin only.","operationId":"reset_demo_all_v1_demo_reset_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/bucket-check":{"get":{"tags":["demo-seed"],"summary":"Bucket Check","description":"Diagnostic: check bucket connectivity and list objects. Superadmin only.","operationId":"bucket_check_v1_demo_bucket_check_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/demo/events":{"post":{"tags":["demo-admin"],"summary":"Ingest Demo Event","description":"Receive demo telemetry events from the frontend track proxy.","operationId":"ingest_demo_event_v1_demo_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoEventRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/invites":{"get":{"tags":["demo-admin"],"summary":"List Invites","description":"List all demo invites.","operationId":"list_invites_v1_demo_invites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/InviteResponse"},"type":"array","title":"Response List Invites V1 Demo Invites Get"}}}}}},"post":{"tags":["demo-admin"],"summary":"Create Invite","description":"Create a new demo invite link.","operationId":"create_invite_v1_demo_invites_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInviteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/invites/{invite_id}":{"patch":{"tags":["demo-admin"],"summary":"Update Invite","description":"Update a demo invite.","operationId":"update_invite_v1_demo_invites__invite_id__patch","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInviteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["demo-admin"],"summary":"Delete Invite","description":"Revoke/delete a demo invite.","operationId":"delete_invite_v1_demo_invites__invite_id__delete","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/users":{"get":{"tags":["demo-admin"],"summary":"List Demo Users","description":"List all demo users with last activity.","operationId":"list_demo_users_v1_demo_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DemoUserResponse"},"type":"array","title":"Response List Demo Users V1 Demo Users Get"}}}}}}},"/v1/demo/users/{user_id}":{"delete":{"tags":["demo-admin"],"summary":"Delete Demo User","description":"Remove a demo user and their sessions.","operationId":"delete_demo_user_v1_demo_users__user_id__delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/analytics":{"get":{"tags":["demo-admin"],"summary":"Demo Analytics","description":"Aggregated demo telemetry.","operationId":"demo_analytics_v1_demo_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoAnalyticsResponse"}}}}}}},"/v1/demo/analytics/user/{user_id}":{"get":{"tags":["demo-admin"],"summary":"User Timeline","description":"Per-user event timeline.","operationId":"user_timeline_v1_demo_analytics_user__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserTimelineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demos/video/{slug}":{"get":{"tags":["demos"],"summary":"Demo Video","description":"Redirect to a presigned bucket URL for the demo video.","operationId":"demo_video_v1_demos_video__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims":{"get":{"tags":["portal"],"summary":"List Portal Claims","description":"List claims assigned to the current claimant.","operationId":"list_portal_claims_v1_portal_claims_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PortalClaimSummary"},"type":"array","title":"Response List Portal Claims V1 Portal Claims Get"}}}}}}},"/v1/portal/claims/{claim_id}/documents":{"post":{"tags":["portal"],"summary":"Upload Portal Document","description":"Upload a document as a claimant.","operationId":"upload_portal_document_v1_portal_claims__claim_id__documents_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_portal_document_v1_portal_claims__claim_id__documents_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalDocumentUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}/status":{"get":{"tags":["portal"],"summary":"Get Portal Claim Status","description":"The claimant's view of their own case: stage and progress (minimum necessary; see the model).\n\nBefore 2026-09-28 this answered ``current_stage`` from ``workflow_state``\n(a ``{id, name, completeness}`` dict there, so validating the response\nfailed with a 500) plus ``stage_description``/``next_steps``/``documents_needed``,\nkeys ``workflow_state`` never had; the portal page read ``lifecycle_stage``\nand ``document_count``, which it never returned. Both fixed, additively.","operationId":"get_portal_claim_status_v1_portal_claims__claim_id__status_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}/documents/{doc_id}/file":{"head":{"tags":["portal"],"summary":"Get Portal Document File","description":"Serve a source document to an assigned guest (converted PDF by default).","operationId":"get_portal_document_file_v1_portal_claims__claim_id__documents__doc_id__file_head","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}},{"name":"original","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Original"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["portal"],"summary":"Get Portal Document File","description":"Serve a source document to an assigned guest (converted PDF by default).","operationId":"get_portal_document_file_v1_portal_claims__claim_id__documents__doc_id__file_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}},{"name":"original","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Original"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}/documents/{doc_id}/preview":{"get":{"tags":["portal"],"summary":"Get Portal Document Preview","description":"Serve an image/DICOM preview to an assigned guest.","operationId":"get_portal_document_preview_v1_portal_claims__claim_id__documents__doc_id__preview_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}},{"name":"frame","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Frame"}},{"name":"thumbnail","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Thumbnail"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}/documents/{doc_id}/word-positions":{"get":{"tags":["portal"],"summary":"Get Portal Word Positions","description":"Return word bounding boxes so the guest viewer can render bbox highlights.","operationId":"get_portal_word_positions_v1_portal_claims__claim_id__documents__doc_id__word_positions_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}/documents/{doc_id}/structured":{"get":{"tags":["portal"],"summary":"Get Portal Structured Data","description":"Return parsed structured data (XLSX tables / PPTX slides / transcripts) to a guest.\n\nMirrors the authenticated /claims/.../structured endpoint so a guest resolving a\nspreadsheet-cell citation gets the same table payload the internal viewer renders.","operationId":"get_portal_structured_data_v1_portal_claims__claim_id__documents__doc_id__structured_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/claims/{claim_id}":{"get":{"tags":["portal"],"summary":"Get Portal Claim","description":"Serve the full claim-detail report to an assigned guest (Portable Citations).\n\nReuses the exact same builder as the authenticated GET /claims/{id}, so the\ninvited attorney sees a byte-identical report (merged extraction, inference\nsteps, documents, citations) — just scoped by ClaimAssignment instead of org\nmembership. Every hit is PHI-audit-logged with IP by the middleware.","operationId":"get_portal_claim_v1_portal_claims__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/contracts":{"post":{"tags":["contracts"],"summary":"Create Contract","description":"Create a contract from a template for a claim.","operationId":"create_contract_v1_claims__claim_id__contracts_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["contracts"],"summary":"List Contracts","description":"List contracts for a claim, newest first.","operationId":"list_contracts_v1_claims__claim_id__contracts_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ContractResponse"},"title":"Response List Contracts V1 Claims Claim Id Contracts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}":{"get":{"tags":["contracts"],"summary":"Get Contract","description":"Get contract detail.","operationId":"get_contract_v1_contracts__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}/send":{"post":{"tags":["contracts"],"summary":"Send Contract","description":"Send a draft contract to the claimant to sign (it shows in their portal; no email is sent).","operationId":"send_contract_v1_contracts__contract_id__send_post","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contracts/{contract_id}/sign":{"post":{"tags":["contracts"],"summary":"Sign Contract","description":"Click-to-sign a contract; the signature (name, role, time, address) is recorded on it.","operationId":"sign_contract_v1_contracts__contract_id__sign_post","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ContractSignRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/users/me/conversion-options":{"get":{"tags":["conversion"],"summary":"Get Conversion Options","description":"Get user's trial-to-production conversion options.\n\nReturns information about the user's trial org and available conversion paths:\n- Keep data: Convert trial org to production, keeping all claims\n- Start fresh: Create new production org, archive trial data","operationId":"get_conversion_options_v1_users_me_conversion_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionOptionsResponse"}}}}}}},"/v1/users/me/convert-to-production":{"post":{"tags":["conversion"],"summary":"Convert To Production","description":"Convert trial user to production.\n\nTwo conversion options:\n1. keep_data: Convert trial org to production, optionally rename\n2. start_fresh: Create new production org, soft-delete trial org","operationId":"convert_to_production_v1_users_me_convert_to_production_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/{form_type}":{"post":{"tags":["forms"],"summary":"Generate Form","description":"Generate an SSA form with auto-populated fields from claim data (a preview: nothing is stored).\n\nlegacy: web moved to forms.generate@1 on 2026-09-28 (web-caps slice 17); both share\nextraction/forms/ssa_preview.preview (the SSN masked; in memory the case's own records).","operationId":"generate_form_v1_claims__claim_id__forms__form_type__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormGenerateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/{form_type}/pdf":{"get":{"tags":["forms"],"summary":"Export Form Html","description":"Export form as printable HTML (use browser Print → PDF).\n\nReturns a self-contained HTML page styled for A4 printing. The SSN is masked unless ``include_full_ssn``\nand the caller passes the full-SSN gate (forms/ssn_export.py: a person, owner/admin or superadmin, MFA on),\nwhich writes an ``ssn_form_export`` access-log row first. Same page as forms.export@1.","operationId":"export_form_html_v1_claims__claim_id__forms__form_type__pdf_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Print the whole SSN (owner/admin with MFA; logged).","default":false,"title":"Include Full Ssn"},"description":"Print the whole SSN (owner/admin with MFA; logged)."}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/{form_type}/instances":{"post":{"tags":["forms"],"summary":"Create Form Instance","description":"Create a new form instance (starts in draft state).","operationId":"create_form_instance_v1_claims__claim_id__forms__form_type__instances_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFormInstanceRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormInstanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["forms"],"summary":"List Form Instances","description":"List all form instances for a claim and form type.","operationId":"list_form_instances_v1_claims__claim_id__forms__form_type__instances_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FormInstanceResponse"},"title":"Response List Form Instances V1 Claims Claim Id Forms Form Type Instances Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}":{"get":{"tags":["forms"],"summary":"Get Form Instance","description":"Get a specific form instance.","operationId":"get_form_instance_v1_claims__claim_id__forms_instances__instance_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormInstanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/generate":{"post":{"tags":["forms"],"summary":"Generate Form Snapshot","description":"Generate a form snapshot (preview/download/transmit).","operationId":"generate_form_snapshot_v1_claims__claim_id__forms_instances__instance_id__generate_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateFormRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/lock":{"post":{"tags":["forms"],"summary":"Lock Form Instance","description":"Lock a form instance, freezing it to the latest generation snapshot.","operationId":"lock_form_instance_v1_claims__claim_id__forms_instances__instance_id__lock_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormInstanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/deliver":{"post":{"tags":["forms"],"summary":"Deliver Form Instance","description":"Mark a locked form instance as delivered.","operationId":"deliver_form_instance_v1_claims__claim_id__forms_instances__instance_id__deliver_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliverFormRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormInstanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/amend":{"post":{"tags":["forms"],"summary":"Amend Form Instance","description":"Create an amendment (new draft child) from a locked/delivered form instance.","operationId":"amend_form_instance_v1_claims__claim_id__forms_instances__instance_id__amend_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmendFormRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormInstanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/generations":{"get":{"tags":["forms"],"summary":"List Form Generations","description":"List all generation snapshots for a form instance.","operationId":"list_form_generations_v1_claims__claim_id__forms_instances__instance_id__generations_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FormGenerationResponse"},"title":"Response List Form Generations V1 Claims Claim Id Forms Instances Instance Id Generations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/compare":{"get":{"tags":["forms"],"summary":"Compare Generations","description":"Compare two generation snapshots, returning field-level differences.","operationId":"compare_generations_v1_claims__claim_id__forms_instances__instance_id__compare_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}},{"name":"a","in":"query","required":true,"schema":{"type":"string","description":"Generation ID A","title":"A"},"description":"Generation ID A"},{"name":"b","in":"query","required":true,"schema":{"type":"string","description":"Generation ID B","title":"B"},"description":"Generation ID B"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareGenerationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/instances/{instance_id}/export":{"get":{"tags":["forms"],"summary":"Export Form Instance","description":"Export a form instance as HTML. Uses frozen snapshot if locked/delivered, or live data if draft.\n\nThe SSN is masked unless ``include_full_ssn`` and the caller passes the full-SSN gate\n(forms/ssn_export.py), which writes an ``ssn_form_export`` access-log row first. A locked snapshot stores\nthe SSN masked; the whole number is the person's (when its last four are the snapshot's).","operationId":"export_form_instance_v1_claims__claim_id__forms_instances__instance_id__export_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"instance_id","in":"path","required":true,"schema":{"type":"string","title":"Instance Id"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Print the whole SSN (owner/admin with MFA; logged).","default":false,"title":"Include Full Ssn"},"description":"Print the whole SSN (owner/admin with MFA; logged)."}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/{form_type}/payload":{"post":{"tags":["forms"],"summary":"Export Ssa Form Payload","description":"Export a single SSA form as an AcroForm-aligned payload dict.\n\nDistinct from ``POST /claims/{claim_id}/forms/{form_type}`` which returns\nthe thinner per-field review payload. This endpoint returns the full SSA\nfield-name dict ready for PDF AcroForm filling, with intake validation\nissues attached. The SSN fields (``Claimant_SSN``, ``Claimant_OtherSSNUsed``)\nare masked unless ``include_full_ssn`` passes the full-SSN gate (forms/ssn_export.py).","operationId":"export_ssa_form_payload_v1_claims__claim_id__forms__form_type__payload_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise.","default":false,"title":"Include Full Ssn"},"description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsaFormPayloadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/payload/all":{"post":{"tags":["forms"],"summary":"Export All Ssa Form Payloads","description":"Export all supported SSA forms (SSA-16, SSA-3368, SSA-3373) for a claim (the SSN masked unless\n``include_full_ssn`` passes the full-SSN gate: one access-log row naming every form).","operationId":"export_all_ssa_form_payloads_v1_claims__claim_id__forms_payload_all_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise.","default":false,"title":"Include Full Ssn"},"description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsaFormBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/forms/{form_type}/pdf-fill":{"get":{"tags":["forms"],"summary":"Export Ssa Form Pdf","description":"Fill the blank SSA AcroForm template for a claim and return PDF bytes.\n\nThe SSN is filled masked unless ``include_full_ssn`` passes the full-SSN gate (forms/ssn_export.py), which\nwrites an ``ssn_form_export`` access-log row first. Returns 503 with a hint if the blank template isn't\ncommitted under ``extraction/src/extraction/forms/templates/``.","operationId":"export_ssa_form_pdf_v1_claims__claim_id__forms__form_type__pdf_fill_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise.","default":false,"title":"Include Full Ssn"},"description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orgs/{org_id}/invites":{"post":{"tags":["invites"],"summary":"Create Guest Invite","description":"Create a guest invite for client access.\n\n# legacy: web moved to sharing.invite_guest@1 on 2026-09-28 (web-caps slice 14). Same code\n# (``orgadmin/sharing.py``); stays for API keys until rule 4.\n\n**Auto-upgrade to full membership:** If the invitee email matches an existing\nuser, creates a full OrgMembership instead of token-based guest access.\n\nFor new users: Creates token-based guest invite with claim-scoped access.\n\nAny accepted org member (owner/admin/member) can share; guests cannot.\nExternal-share governance (enable switch + domain allowlist) still applies.\nDemo organizations cannot create invites (read-only).","operationId":"create_guest_invite_v1_orgs__org_id__invites_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGuestInviteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/GuestInviteResponse"},{"type":"object","additionalProperties":true}],"title":"Response Create Guest Invite V1 Orgs Org Id Invites Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/invites/{token}/accept":{"post":{"tags":["invites"],"summary":"Accept Guest Invite","description":"Accept a guest invite.\n\nCreates guest membership + claim assignments for the invitee.\nUser must be logged in (or create account via magic link first).","operationId":"accept_guest_invite_v1_invites__token__accept_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"}}}}}}},"/v1/invites/{token}":{"get":{"tags":["invites"],"summary":"Preview Guest Invite","description":"Public invite preview — no auth (possession of the token is the\ncredential). Lets the login/register page prefill and lock the invitee\nemail and pick login vs. register mode.","operationId":"preview_guest_invite_v1_invites__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/active-org":{"post":{"tags":["sessions"],"summary":"Switch Active Org","description":"Switch active org for current session.\n\nThe user must have a valid, accepted membership in the target org.\nUpdates Session.active_org_id, which is then used by resolve_session()\nto set the auth context and RLS scope.","operationId":"switch_active_org_v1_sessions_active_org_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwitchOrgRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/memberships":{"get":{"tags":["sessions"],"summary":"List User Memberships","description":"List all organizations the current user has access to.\n\nReturns accepted, non-revoked memberships with org details (not in deleted orgs).\nThe org switcher reads them from ``platform.whoami@1`` since web-caps slice 19 (the same builder,\n``orgadmin/session_profile.memberships``); the memberships page still calls this.","operationId":"list_user_memberships_v1_sessions_memberships_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UserMembershipResponse"},"type":"array","title":"Response List User Memberships V1 Sessions Memberships Get"}}}}}}},"/v1/sessions/active":{"get":{"tags":["sessions"],"summary":"Get Active Session","description":"Get current session info including active org.\n\nReturns the currently active organization and user details.","operationId":"get_active_session_v1_sessions_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/memberships/pending":{"get":{"tags":["memberships"],"summary":"List Pending Memberships","description":"List all pending membership invitations for the current user.\n\nReturns invitations where accepted_at IS NULL and revoked_at IS NULL.\nUsers can accept or decline these invitations.","operationId":"list_pending_memberships_v1_memberships_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PendingMembershipResponse"},"type":"array","title":"Response List Pending Memberships V1 Memberships Pending Get"}}}}}}},"/v1/memberships/{membership_id}/accept":{"post":{"tags":["memberships"],"summary":"Accept Membership","description":"Accept a pending membership invitation.\n\nSets accepted_at to NOW(), allowing the user to switch to this org.\nReturns the accepted membership details.","operationId":"accept_membership_v1_memberships__membership_id__accept_post","parameters":[{"name":"membership_id","in":"path","required":true,"schema":{"type":"string","title":"Membership Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembershipResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memberships/{membership_id}/decline":{"post":{"tags":["memberships"],"summary":"Decline Membership","description":"Decline a pending membership invitation.\n\nSets revoked_at to NOW(), hiding the invitation from pending list.\nReturns success status.","operationId":"decline_membership_v1_memberships__membership_id__decline_post","parameters":[{"name":"membership_id","in":"path","required":true,"schema":{"type":"string","title":"Membership Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Decline Membership V1 Memberships Membership Id Decline Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memberships/orgs/{org_id}/invite":{"post":{"tags":["memberships"],"summary":"Invite User To Org","description":"Invite a user to join an organization.\n\nIf the user already exists: Creates a pending OrgMembership.\nIf the user doesn't exist: Delegates to guest invite system.\n\nRequires admin or owner role in the target organization.","operationId":"invite_user_to_org_v1_memberships_orgs__org_id__invite_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memberships/{membership_id}":{"delete":{"tags":["memberships"],"summary":"Leave Membership","description":"Leave an organization (delete your own membership).\n\nBusiness rules:\n- User can only leave their own membership\n- Can only leave accepted memberships (use decline for pending)\n- Cannot leave if you're the only owner AND there are other members\n- Cannot leave if it's your only organization\n- If leaving active org, auto-switches to another available org\n\nReturns success status and org switch info if applicable.","operationId":"leave_membership_v1_memberships__membership_id__delete","parameters":[{"name":"membership_id","in":"path","required":true,"schema":{"type":"string","title":"Membership Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveMembershipResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/analytics/dashboard":{"get":{"tags":["billing"],"summary":"Get Analytics Dashboard","description":"Get analytics dashboard summary.","operationId":"get_analytics_dashboard_v1_analytics_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsDashboardResponse"}}}}}}},"/v1/checkout/create-session":{"post":{"tags":["billing","checkout"],"summary":"Create Checkout Session","description":"Create a Stripe Checkout Session for consumer D2C purchase.\n\nTiers:\n- initial: $695 — initial VA claim package + accredited representation\n- sc_appeal: $995 — supplemental claim appeal\n- hlr_appeal: $1,495 — higher-level review appeal\n- bva_appeal: $2,495 — Board of Veterans Appeals\n- monitoring: $29/mo — rating-increase monitoring subscription","operationId":"create_checkout_session_v1_checkout_create_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/msa/orders":{"post":{"tags":["billing","checkout"],"summary":"Create Msa Order","description":"Public, unauthenticated MSA order intake.\n\nCreates a claim under the self-service org with `payment_status=\"pending\"`,\npersists uploaded documents to the backend's file_store, and returns a\nStripe checkout URL. The webhook flips payment_status to \"paid\" and starts\nthe 48h SLA on `checkout.session.completed`.\n\nOwns file storage: avoids cross-service filesystem split (the Next.js\nproxy used to write files locally and the API couldn't read them in prod).","operationId":"create_msa_order_v1_msa_orders_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_msa_order_v1_msa_orders_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Msa Order V1 Msa Orders Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/msa/orders/{claim_id}/secure-info":{"post":{"tags":["billing","checkout"],"summary":"Submit Secure Info","description":"Receive PHI fields (SSN, MBI, DOB, address) on a self-service MSA claim.\n\nAuth is by HMAC token bound to the claim_id, sent in the post-payment email.\nThe submitter never authenticates with a Zicron account — this is the only\npath for them to deliver the high-PHI fields without us putting them on the\npublic order form.","operationId":"submit_secure_info_v1_msa_orders__claim_id__secure_info_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecureInfoRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Secure Info V1 Msa Orders Claim Id Secure Info Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkout/webhook":{"post":{"tags":["billing","checkout"],"summary":"Checkout Webhook","description":"Handle Stripe webhook events for checkout completion.\n\nListens for checkout.session.completed → marks claim as paid,\ntriggers report generation pipeline.","operationId":"checkout_webhook_v1_checkout_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/billing/status":{"get":{"tags":["billing"],"summary":"Get Billing Status","description":"Check billing status for the current org.","operationId":"get_billing_status_v1_billing_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingStatusResponse"}}}}}}},"/v1/billing/subscribe":{"post":{"tags":["billing"],"summary":"Create Subscription","description":"Create a usage-based subscription for the current org.","operationId":"create_subscription_v1_billing_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/subscription":{"get":{"tags":["billing"],"summary":"Get Subscription","description":"Get the current org's subscription details.","operationId":"get_subscription_v1_billing_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SubscriptionResponse"},{"type":"null"}],"title":"Response Get Subscription V1 Billing Subscription Get"}}}}}},"delete":{"tags":["billing"],"summary":"Cancel Subscription","description":"Cancel the current org's subscription at period end.","operationId":"cancel_subscription_v1_billing_subscription_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/billing/usage":{"get":{"tags":["billing"],"summary":"Get Usage Summary","description":"Get usage summary for the current billing period.","operationId":"get_usage_summary_v1_billing_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSummaryResponse"}}}}}}},"/v1/billing/webhooks/stripe":{"post":{"tags":["billing"],"summary":"Handle Stripe Webhook","description":"Handle Stripe webhook events (subscription updates, invoice events).","operationId":"handle_stripe_webhook_v1_billing_webhooks_stripe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/billing/pricing":{"get":{"tags":["billing"],"summary":"Get Pricing","description":"Get the rate card for the current org's plan.","operationId":"get_pricing_v1_billing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Pricing V1 Billing Pricing Get"}}}}}}},"/v1/billing/claims/{claim_id}/charges":{"get":{"tags":["billing"],"summary":"Get Claim Charges","description":"Get all charges for a specific claim.","operationId":"get_claim_charges_v1_billing_claims__claim_id__charges_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Claim Charges V1 Billing Claims Claim Id Charges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/charges":{"get":{"tags":["billing"],"summary":"Get Org Charges","description":"Get all charges for the current org, grouped by month.","operationId":"get_org_charges_v1_billing_charges_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Org Charges V1 Billing Charges Get"}}}}}}},"/v1/compliance/consent/{claim_id}":{"get":{"tags":["compliance"],"summary":"Get Consent Records","description":"Get consent records for a claim: the ``consent_records`` rows (HIPAA, representation, ...) and the\nclaimant's contact consent per channel (``communication_consents``, the TCPA check's source).\n\nTenancy is enforced by RLS on ``consent_records`` (migration 084): a caller\nonly ever sees rows of its own org, so another org's claim reads as empty.","operationId":"get_consent_records_v1_compliance_consent__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["compliance"],"summary":"Create Consent Record","description":"Create a consent record for a claim.\n\nA contact channel (sms, voice, email) is the claimant's contact consent (``conversations/consent.py``): a\nperson records it and says how it was obtained (``obtained_via``; 422 without), ``granted: false`` records\na withdrawal; refused (409) for texts or calls after the claimant texted STOP. It then counts for outreach.","operationId":"create_consent_record_v1_compliance_consent__claim_id__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compliance/consent/{claim_id}/{consent_id}/revoke":{"post":{"tags":["compliance"],"summary":"Revoke Consent Record","description":"Revoke a consent record: sets ``revoked_at`` and ``granted = false``.\n\nIdempotent: revoking an already-revoked record returns it unchanged. The\nrow is kept (consent history is compliance evidence). Another org's record\nis invisible under RLS and reads as 404.","operationId":"revoke_consent_record_v1_compliance_consent__claim_id___consent_id__revoke_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"consent_id","in":"path","required":true,"schema":{"type":"string","title":"Consent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compliance/retention-policies":{"get":{"tags":["compliance"],"summary":"List Retention Policies","description":"List data retention policies.","operationId":"list_retention_policies_v1_compliance_retention_policies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionPolicyListResponse"}}}}}}},"/v1/admin/stats":{"get":{"tags":["admin"],"summary":"Get Admin Stats","description":"Global platform statistics.","operationId":"get_admin_stats_v1_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminStats"}}}}}}},"/v1/admin/users":{"get":{"tags":["admin"],"summary":"List All Users","description":"List all users across all organizations (for superadmin user selection).","operationId":"list_all_users_v1_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AllUsersResponse"},"type":"array","title":"Response List All Users V1 Admin Users Get"}}}}}}},"/v1/admin/orgs":{"get":{"tags":["admin"],"summary":"List Orgs","description":"List all organizations with user/claim counts.","operationId":"list_orgs_v1_admin_orgs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrgSummary"},"type":"array","title":"Response List Orgs V1 Admin Orgs Get"}}}}}},"post":{"tags":["admin"],"summary":"Create Org","description":"Create a new organization.","operationId":"create_org_v1_admin_orgs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrgRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/orgs/{org_id}":{"get":{"tags":["admin"],"summary":"Get Org","description":"Get organization detail.","operationId":"get_org_v1_admin_orgs__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Org","description":"Update an organization.","operationId":"update_org_v1_admin_orgs__org_id__patch","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrgRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Org","description":"Soft delete an organization by setting deleted_at timestamp.","operationId":"delete_org_v1_admin_orgs__org_id__delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/orgs/{org_id}/usage":{"get":{"tags":["admin"],"summary":"Get Org Usage Stats","description":"Get current usage statistics for an org.","operationId":"get_org_usage_stats_v1_admin_orgs__org_id__usage_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgUsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/orgs/{org_id}/users":{"get":{"tags":["admin"],"summary":"List Org Users","description":"List users in an organization.\n\nReturns users who are members of this org either by:\n1. Their primary org_id matching (original members)\n2. Having an accepted OrgMembership (multi-org members)","operationId":"list_org_users_v1_admin_orgs__org_id__users_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrgUserResponse"},"title":"Response List Org Users V1 Admin Orgs Org Id Users Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create Org User","description":"Create a user in an organization.\n\nIf the email already exists, creates an accepted OrgMembership instead of\nfailing with 409. This allows admins to add existing users to their org.","operationId":"create_org_user_v1_admin_orgs__org_id__users_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrgUserRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/users/{user_id}":{"get":{"tags":["admin"],"summary":"Get User","description":"Get detailed user information.","operationId":"get_user_v1_admin_users__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update User","description":"Update a user (role, is_active, is_superadmin, MFA).","operationId":"update_user_v1_admin_users__user_id__patch","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgUserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/users/{user_id}/reset-password-link":{"post":{"tags":["admin"],"summary":"Generate Password Reset Link","description":"Generate a password reset link for a user (admin/superadmin only).\n\nSuperadmins can generate reset links for any user.\nAdmins can generate reset links for users in their org.","operationId":"generate_password_reset_link_v1_admin_users__user_id__reset_password_link_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/impersonate/{org_id}":{"post":{"tags":["admin"],"summary":"Impersonate","description":"Set impersonating_org_id on the current session.","operationId":"impersonate_v1_admin_impersonate__org_id__post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/stop-impersonation":{"post":{"tags":["admin"],"summary":"Stop Impersonation","description":"Clear impersonating_org_id on the current session.","operationId":"stop_impersonation_v1_admin_stop_impersonation_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/dedup-scripts":{"post":{"tags":["admin"],"summary":"Dedup Scripts","description":"Deduplicate conversation scripts across all orgs.\n\nRemoves underscore-slug duplicates when a hyphen-slug sibling exists for the\nsame org. Also removes true duplicates (same org_id + slug) keeping the\nnewest row. Superadmin only.","operationId":"dedup_scripts_v1_admin_dedup_scripts_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/orgs/{org_id}/convert-trial":{"post":{"tags":["admin"],"summary":"Admin Convert Trial To Production","description":"Admin endpoint to convert trial user to production.\n\nTwo conversion types:\n1. \"promote\" - Promote the trial org to production (keep data)\n2. \"transfer\" - Transfer user to existing production org (like Ptarmigan)\n\nRequires superadmin.","operationId":"admin_convert_trial_to_production_v1_admin_orgs__org_id__convert_trial_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminConvertTrialRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/assistant/message":{"post":{"tags":["assistant"],"summary":"Send Message","description":"Send a message to the assistant and receive a streaming SSE response.\n\nStays a route (keep-legacy, web-caps slice 15): the reply streams token by token, which the capability\ngateway doesn't carry. ``assistant.message@1`` runs the same turn (``assistant/session.py``) and returns\nthe whole reply, for API keys.","operationId":"send_message_v1_claims__claim_id__assistant_message_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantMessageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations":{"post":{"tags":["conversations"],"summary":"Create Conversation","description":"Create a new conversation (schedule outbound or register inbound).","operationId":"create_conversation_v1_conversations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}":{"get":{"tags":["conversations"],"summary":"Get Conversation","description":"Get full conversation detail with messages and actions.","operationId":"get_conversation_v1_conversations__conversation_id__get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["conversations"],"summary":"Update Conversation","description":"Update conversation status, summary, or sentiment.","operationId":"update_conversation_v1_conversations__conversation_id__patch","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["conversations"],"summary":"Delete Conversation","description":"Delete a conversation and its messages/actions.","operationId":"delete_conversation_v1_conversations__conversation_id__delete","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/messages":{"post":{"tags":["conversations"],"summary":"Send Message","description":"Send a manual message (human takeover).","operationId":"send_message_v1_conversations__conversation_id__messages_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageRequest"}}}},"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"}}}}}}},"/v1/conversations/{conversation_id}/actions":{"get":{"tags":["conversations"],"summary":"List Actions","description":"List agent actions for a conversation.","operationId":"list_actions_v1_conversations__conversation_id__actions_get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ActionResponse"},"title":"Response List Actions V1 Conversations Conversation Id Actions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}/stream":{"get":{"tags":["conversations"],"summary":"Stream Conversation","description":"SSE stream for real-time conversation events.\n\nSubscribes to PersistentEventBus events filtered to this conversation_id.\nUseful for live voice monitoring.","operationId":"stream_conversation_v1_conversations__conversation_id__stream_get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/bulk":{"post":{"tags":["conversations"],"summary":"Bulk Create Conversations","description":"Create multiple scheduled conversations from a list of claim_ids.\n\nValidates consent for each claim (the single consent source, through the contact rules: no consent or a\nSTOP skips it); the scheduler re-checks everything when each one comes due.","operationId":"bulk_create_conversations_v1_conversations_bulk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/threads":{"get":{"tags":["threads"],"summary":"List Threads","description":"List threads, grouped by thread_id, ordered by most recent activity.","operationId":"list_threads_v1_threads_get","parameters":[{"name":"person_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"}},{"name":"claim_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ThreadSummary"},"title":"Response List Threads V1 Threads Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/threads/{thread_id}":{"get":{"tags":["threads"],"summary":"Get Thread","description":"Return full thread detail with messages unified across conversations.","operationId":"get_thread_v1_threads__thread_id__get","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/threads/{thread_id}/messages":{"post":{"tags":["threads"],"summary":"Post Thread Message","description":"Send a claimant reply into a thread.\n\nChannel honoring: the reply is routed to the channel of the most recent\nagent message in the thread (sms / email / web_chat). Voice falls back\nto web_chat — we cannot dynamically dial out from a synchronous HTTP\nPOST. The agent's response is then delivered via the corresponding\nchannel adapter (SMS via Twilio, email via Resend, web via the inbox\nrefresh) so the claimant continues in their preferred channel.\n\nAsync dispatch (item #16): the endpoint persists the new Conversation\nrow, then enqueues `process_turn` as a background asyncio task and\nreturns 202 Accepted immediately. The agent reply is delivered to\nthe client via the existing `/threads/{id}/stream` SSE endpoint\nwithin ~1.5s. The previous synchronous code path is gone — keep one\npath, not two. A task crash leaves the user message + Conversation\nrow durable; the orphan janitor in `conversations/background.py`\nsweeps inbound conversations stuck in `scheduled` / `in_progress`\npast `CONVERSATION_ORPHAN_THRESHOLD_SECONDS` (default 5 min) and\nmarks them `status='failed'` with the existing delivery_status\nbadge so the user sees the failure and can retry.\n\nAuth model:\n - Claimants: may only post to their own threads (person_id match).\n - Staff: NOT permitted in v1. Staff impersonation / on-behalf-of\n posting is desirable but out of scope; returns 403. Track as a\n follow-up when staff takeover UX lands for the inbox.","operationId":"post_thread_message_v1_threads__thread_id__messages_post","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMessageRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/threads/{thread_id}/stream":{"get":{"tags":["threads"],"summary":"Stream Thread Messages","description":"Server-Sent Events stream for new ConversationMessage rows on a thread.","operationId":"stream_thread_messages_v1_threads__thread_id__stream_get","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/scripts":{"post":{"tags":["scripts"],"summary":"Create Script","description":"Create a new conversation script.","operationId":"create_script_v1_scripts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateScriptRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/scripts/{script_id}":{"patch":{"tags":["scripts"],"summary":"Update Script","description":"Update script metadata or body (validated as on create; the body runs once published).","operationId":"update_script_v1_scripts__script_id__patch","parameters":[{"name":"script_id","in":"path","required":true,"schema":{"type":"string","title":"Script Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api/referrals":{"post":{"tags":["referrals"],"summary":"Create Referral","description":"Accept a B2B referral with metadata and optional document files.\n\nReturns 202 Accepted with a batch_id for tracking processing status.","operationId":"create_referral_v1_api_referrals_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_referral_v1_api_referrals_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralAcceptedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api/referrals/{referral_id}/status":{"get":{"tags":["referrals"],"summary":"Get Referral Status","description":"Get processing status for a referral.","operationId":"get_referral_status_v1_api_referrals__referral_id__status_get","parameters":[{"name":"referral_id","in":"path","required":true,"schema":{"type":"string","title":"Referral Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__referrals__BatchStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api/referrals/{referral_id}/results":{"get":{"tags":["referrals"],"summary":"Get Referral Results","description":"Get extraction results for a completed referral.","operationId":"get_referral_results_v1_api_referrals__referral_id__results_get","parameters":[{"name":"referral_id","in":"path","required":true,"schema":{"type":"string","title":"Referral Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralResultsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/retell/llm":{"post":{"tags":["webhooks"],"summary":"Retell Llm Webhook","description":"Retell custom LLM webhook — called on every voice turn.","operationId":"retell_llm_webhook_v1_webhooks_retell_llm_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/retell/call-status":{"post":{"tags":["webhooks"],"summary":"Retell Call Status Webhook","description":"Retell call lifecycle events (ringing, in_progress, ended, error).","operationId":"retell_call_status_webhook_v1_webhooks_retell_call_status_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/vapi/turn":{"post":{"tags":["webhooks"],"summary":"Vapi Turn Webhook","description":"Vapi server URL callback — receives server messages (status, conversation-update, etc.).\n\nThese are NOT LLM turn requests — those go to /vapi/turn/chat/completions.\nMost server messages just need an acknowledgment.","operationId":"vapi_turn_webhook_v1_webhooks_vapi_turn_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/vapi/turn/chat/completions":{"post":{"tags":["webhooks"],"summary":"Vapi Chat Completions","description":"Vapi custom LLM endpoint — OpenAI-compatible SSE streaming.\n\nVapi expects a streaming SSE response (Server-Sent Events) so it can\nstart TTS on the first sentence while the rest is still generating.\nWithout streaming, Vapi times out and sends 'hang' after ~5s.","operationId":"vapi_chat_completions_v1_webhooks_vapi_turn_chat_completions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/vapi/status":{"post":{"tags":["webhooks"],"summary":"Vapi Status Webhook","description":"Vapi call lifecycle events.","operationId":"vapi_status_webhook_v1_webhooks_vapi_status_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/twilio/sms":{"post":{"tags":["webhooks"],"summary":"Twilio Sms Webhook","description":"Inbound SMS from Twilio.","operationId":"twilio_sms_webhook_v1_webhooks_twilio_sms_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/twilio/sms-status":{"post":{"tags":["webhooks"],"summary":"Twilio Sms Status Webhook","description":"Twilio SMS delivery receipt.","operationId":"twilio_sms_status_webhook_v1_webhooks_twilio_sms_status_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/webhooks/resend/email":{"post":{"tags":["webhooks"],"summary":"Resend Email Webhook","description":"Inbound email from Resend webhook.","operationId":"resend_email_webhook_v1_webhooks_resend_email_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/tasks/{task_id}":{"get":{"tags":["tasks"],"summary":"Get Task Status","description":"Get the status of a background task.","operationId":"get_task_status_v1_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"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"}}}}}}},"/v1/tasks/{task_id}/batch":{"get":{"tags":["tasks"],"summary":"Get Batch Task Status","description":"Get batch task with child task details and aggregated status.","operationId":"get_batch_task_status_v1_tasks__task_id__batch_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchTaskStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/metrics":{"get":{"tags":["metrics"],"summary":"Get Metrics","description":"Operational metrics — superadmin only.","operationId":"get_metrics_v1_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricsResponse"}}}}}}},"/v1/health":{"get":{"summary":"Health Check","description":"Lightweight health check — no DB round-trip.","operationId":"health_check_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/health/deep":{"get":{"summary":"Deep Health Check","description":"Deep health check — verifies database, storage, and LLM availability.","operationId":"deep_health_check_v1_health_deep_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeepHealthResponse"}}}}}}},"/v1/claims/{claim_id}/tools/comparison":{"get":{"tags":["tools-common"],"summary":"Get Provider Comparison","description":"Compare provider opinions across clinical categories.","operationId":"get_provider_comparison_v1_claims__claim_id__tools_comparison_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"role_a","in":"query","required":false,"schema":{"type":"string","default":"treating","title":"Role A"}},{"name":"role_b","in":"query","required":false,"schema":{"type":"string","default":"ime","title":"Role B"}},{"name":"categories","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Categories"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssa/submit/{form_type}":{"post":{"tags":["ssa"],"summary":"Submit Form To Ssa","description":"Submit a single SSA form electronically.\n\nGenerates the filled PDF, submits via the SSA client, creates a\nsubmission record, and marks the form instance as delivered.","operationId":"submit_form_to_ssa_v1_claims__claim_id__ssa_submit__form_type__post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"form_type","in":"path","required":true,"schema":{"type":"string","title":"Form Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSASubmitRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssa/submit-package":{"post":{"tags":["ssa"],"summary":"Submit Package To Ssa","description":"Submit all available SSA forms for a claim as a package.","operationId":"submit_package_to_ssa_v1_claims__claim_id__ssa_submit_package_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SSASubmitPackageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssa/submissions":{"get":{"tags":["ssa"],"summary":"List Ssa Submissions","description":"List all SSA submissions for a claim.","operationId":"list_ssa_submissions_v1_claims__claim_id__ssa_submissions_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssa/submissions/{submission_id}":{"get":{"tags":["ssa"],"summary":"Get Ssa Submission","description":"Get details of a specific SSA submission.","operationId":"get_ssa_submission_v1_claims__claim_id__ssa_submissions__submission_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssa/submissions/{submission_id}/refresh":{"post":{"tags":["ssa"],"summary":"Refresh Ssa Submission","description":"Poll SSA for an updated status on a submission.","operationId":"refresh_ssa_submission_v1_claims__claim_id__ssa_submissions__submission_id__refresh_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/filing/status":{"get":{"tags":["filing"],"summary":"Get Filing Status","description":"Get current filing status for a claim.\n\nReturns status for each active channel (iClaim, field office) and\nany open escalation tickets.","operationId":"get_filing_status_v1_claims__claim_id__filing_status_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Filing Status V1 Claims Claim Id Filing Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/filing/manifest":{"get":{"tags":["filing"],"summary":"Get Manifest","description":"Get the submission manifest as a human-readable answer sheet.\n\nUseful for QA review before automated filing, or for manual filing\nby a representative. The SSN answers are masked unless ``include_full_ssn``\npasses the full-SSN gate (forms/ssn_export.py).","operationId":"get_manifest_v1_claims__claim_id__filing_manifest_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise.","default":false,"title":"Include Full Ssn"},"description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Manifest V1 Claims Claim Id Filing Manifest Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/filing/ssi-packet":{"get":{"tags":["filing"],"summary":"Get Ssi Packet","description":"Get the SSI filing packet — financial summary, phone script, checklist.\n\nUsed by representatives to file SSI by phone, or by claimants\npreparing for an in-person field office visit. The phone script's SSN\nanswer is masked unless ``include_full_ssn`` passes the full-SSN gate\n(forms/ssn_export.py).","operationId":"get_ssi_packet_v1_claims__claim_id__filing_ssi_packet_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise.","default":false,"title":"Include Full Ssn"},"description":"Include the whole SSN (owner/admin with MFA; logged). Masked otherwise."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Ssi Packet V1 Claims Claim Id Filing Ssi Packet Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/filing/escalation/{ticket_id}/resolve":{"post":{"tags":["filing"],"summary":"Resolve Escalation","description":"Resolve an escalation ticket to resume a paused filing session.","operationId":"resolve_escalation_v1_claims__claim_id__filing_escalation__ticket_id__resolve_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resolve Escalation V1 Claims Claim Id Filing Escalation Ticket Id Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssdi-tools/denial-rebuttal":{"get":{"tags":["ssdi-tools"],"summary":"Get Denial Rebuttal","description":"Generate a denial rebuttal report for an SSDI claim.","operationId":"get_denial_rebuttal_v1_claims__claim_id__ssdi_tools_denial_rebuttal_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RebuttalReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssdi-tools/ce-recommendations":{"get":{"tags":["ssdi-tools"],"summary":"Get Ce Recommendations","description":"Generate consultative examination recommendations for an SSDI claim.","operationId":"get_ce_recommendations_v1_claims__claim_id__ssdi_tools_ce_recommendations_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CERecommendationReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssi-tools/denial-rebuttal":{"get":{"tags":["ssi-tools"],"summary":"Get Denial Rebuttal","description":"Generate a denial rebuttal report for an SSI claim.","operationId":"get_denial_rebuttal_v1_claims__claim_id__ssi_tools_denial_rebuttal_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RebuttalReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssi-tools/rfc-actions":{"get":{"tags":["ssi-tools"],"summary":"Get Rfc Actions","description":"Generate RFC action items for an SSI claim.","operationId":"get_rfc_actions_v1_claims__claim_id__ssi_tools_rfc_actions_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RFCActionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ssi-tools/financial-review":{"get":{"tags":["ssi-tools"],"summary":"Get Financial Review","description":"Generate a financial eligibility review for an SSI claim.","operationId":"get_financial_review_v1_claims__claim_id__ssi_tools_financial_review_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialReviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/settlement":{"get":{"tags":["wc-tools"],"summary":"Get Settlement Estimate","description":"Calculate a WC settlement estimate for a claim.","operationId":"get_settlement_estimate_v1_claims__claim_id__wc_tools_settlement_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementEstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/reserve":{"get":{"tags":["wc-tools"],"summary":"Get Reserve Worksheet","description":"Generate a reserve worksheet for a WC claim.","operationId":"get_reserve_worksheet_v1_claims__claim_id__wc_tools_reserve_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReserveWorksheetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/compensability":{"get":{"tags":["wc-tools"],"summary":"Get Compensability Checklist","description":"Generate a WC compensability checklist for a claim.","operationId":"get_compensability_checklist_v1_claims__claim_id__wc_tools_compensability_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__wc_tools__ChecklistResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/ur-appeal":{"get":{"tags":["wc-tools"],"summary":"Get Ur Appeal Points","description":"Generate utilization review appeal arguments for a WC claim.","operationId":"get_ur_appeal_points_v1_claims__claim_id__wc_tools_ur_appeal_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/URAppealResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/dispute":{"get":{"tags":["wc-tools"],"summary":"Get Dispute Matrix","description":"Generate a dispute matrix for a WC claim.","operationId":"get_dispute_matrix_v1_claims__claim_id__wc_tools_dispute_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeMatrixResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/ur-tracking":{"get":{"tags":["wc-tools"],"summary":"Get Ur Tracking","description":"Track utilization review denials and appeal status for a WC claim.","operationId":"get_ur_tracking_v1_claims__claim_id__wc_tools_ur_tracking_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/URTrackingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/impairment-calculator":{"get":{"tags":["wc-tools"],"summary":"Get Impairment Calculator","description":"Generate an impairment rating breakdown for a WC claim.","operationId":"get_impairment_calculator_v1_claims__claim_id__wc_tools_impairment_calculator_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImpairmentBreakdownResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/apportionment":{"get":{"tags":["wc-tools"],"summary":"Get Apportionment Analysis","description":"Generate an apportionment analysis for a WC claim.","operationId":"get_apportionment_analysis_v1_claims__claim_id__wc_tools_apportionment_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApportionmentAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/mmi-status":{"get":{"tags":["wc-tools"],"summary":"Get Mmi Status","description":"Track MMI status for a WC claim.","operationId":"get_mmi_status_v1_claims__claim_id__wc_tools_mmi_status_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MMIStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/work-capacity":{"get":{"tags":["wc-tools"],"summary":"Get Work Capacity","description":"Assess work capacity for a WC claim.","operationId":"get_work_capacity_v1_claims__claim_id__wc_tools_work_capacity_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkCapacityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/reserve-adequacy":{"get":{"tags":["wc-tools"],"summary":"Get Reserve Adequacy","description":"Assess reserve adequacy for a WC claim.","operationId":"get_reserve_adequacy_v1_claims__claim_id__wc_tools_reserve_adequacy_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReserveAdequacyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/wage-loss":{"get":{"tags":["wc-tools"],"summary":"Get Wage Loss","description":"Calculate wage loss benefits for a WC claim.","operationId":"get_wage_loss_v1_claims__claim_id__wc_tools_wage_loss_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WageLossCalculationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/litigation-risk":{"get":{"tags":["wc-tools"],"summary":"Get Litigation Risk","description":"Assess litigation risk for a WC claim.","operationId":"get_litigation_risk_v1_claims__claim_id__wc_tools_litigation_risk_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LitigationRiskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/wc-tools/state-rules":{"get":{"tags":["wc-tools"],"summary":"Get State Rules","description":"Return jurisdiction-specific rules summary for a WC claim.","operationId":"get_state_rules_v1_claims__claim_id__wc_tools_state_rules_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateRulesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/va-tools/rating":{"get":{"tags":["va-tools"],"summary":"Get Rating Explanation","description":"Step-by-step VA combined rating calculation for a claim.","operationId":"get_rating_explanation_v1_claims__claim_id__va_tools_rating_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RatingExplanationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/lighthouse/auth/start":{"get":{"tags":["va-lighthouse"],"summary":"Start Oauth","description":"Initiate Login.gov OAuth flow.\n\nRedirects the veteran to Login.gov where they authenticate.\nAfter authentication, Login.gov redirects back to /auth/callback.\n\nQuery params:\n claim_id: the case to connect: requires the caller's session on it (``_starter_for_case``). Without\n one, the sign-in only verifies veteran status and stores nothing.","operationId":"start_oauth_v1_va_lighthouse_auth_start_get","parameters":[{"name":"claim_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/lighthouse/auth/callback":{"get":{"tags":["va-lighthouse"],"summary":"Oauth Callback","description":"Handle Login.gov OAuth callback.\n\nLogin.gov redirects here after veteran authenticates.\nWe exchange the code for tokens, fetch veteran identity,\nand verify veteran status via the Verification API.","operationId":"oauth_callback_v1_va_lighthouse_auth_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","default":"","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","default":"","title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/lighthouse/veteran/{claim_id}":{"get":{"tags":["va-lighthouse"],"summary":"Get Veteran Data","description":"Retrieve stored verified veteran data for a claim.\n\nReturns the veteran profile (service history, rating, etc.)\nthat was fetched during the OAuth flow. Never the tokens.","operationId":"get_veteran_data_v1_va_lighthouse_veteran__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Veteran Data V1 Va Lighthouse Veteran Claim Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/lighthouse/veteran/{claim_id}/refresh":{"post":{"tags":["va-lighthouse"],"summary":"Refresh Veteran Data","description":"Re-fetch veteran data from VA APIs using stored tokens.\n\nUseful for checking if rating has changed or getting updated status.","operationId":"refresh_veteran_data_v1_va_lighthouse_veteran__claim_id__refresh_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Refresh Veteran Data V1 Va Lighthouse Veteran Claim Id Refresh Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/submission/{claim_id}/submit":{"post":{"tags":["va-submission"],"summary":"Submit Claim","description":"Generate forms and submit a VA claim to Benefits Intake.\n\nRequest body:\n claim_data: dict — merged extraction data\n veteran_intake: dict — D2C intake data\n\nReturns the submission record with VA submission ID for tracking.\n\nRequires a prior reviewer approval (POST /va/review/{claim_id}/approve):\nBenefits Intake submissions cannot be recalled outside the sandbox.\n\nOnce only: under a lock on the submission row the approval is checked and the record moves to\n``generating`` before anything is sent, so a second click (another tab, another instance) finds it in\nflight and gets 409.","operationId":"submit_claim_v1_va_submission__claim_id__submit_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Claim V1 Va Submission Claim Id Submit Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/submission/{claim_id}/status":{"get":{"tags":["va-submission"],"summary":"Get Submission Status","description":"Get the current submission status for a claim.","operationId":"get_submission_status_v1_va_submission__claim_id__status_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Submission Status V1 Va Submission Claim Id Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/submission/{claim_id}/refresh":{"get":{"tags":["va-submission"],"summary":"Refresh Submission Status","description":"Poll VA for updated submission status.\n\nOnly polls if the submission is in a non-terminal state.","operationId":"refresh_submission_status_v1_va_submission__claim_id__refresh_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Refresh Submission Status V1 Va Submission Claim Id Refresh Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/submissions":{"get":{"tags":["va-submission"],"summary":"List All Submissions","description":"List all submission records (admin/internal use). Cross-tenant: superadmin only.","operationId":"list_all_submissions_v1_va_submissions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List All Submissions V1 Va Submissions Get"}}}}}}},"/v1/va/review/queue":{"get":{"tags":["va-review"],"summary":"Get Review Queue","description":"List all VA cases grouped by review priority.\n\nPriority order:\n1. Payment received, awaiting QA (stage=draft)\n2. Generation errors needing attention\n3. Submission errors needing retry\n4. Submitted, awaiting VA processing\n5. Completed (for reference)","operationId":"get_review_queue_v1_va_review_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Review Queue V1 Va Review Queue Get"}}}}}}},"/v1/va/review/queue/stats":{"get":{"tags":["va-review"],"summary":"Get Review Stats","description":"Summary counts for the review queue dashboard.","operationId":"get_review_stats_v1_va_review_queue_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Review Stats V1 Va Review Queue Stats Get"}}}}}}},"/v1/va/review/{claim_id}/approve":{"post":{"tags":["va-review"],"summary":"Approve For Filing","description":"Approve a case for filing (the manual QA gate): the operator confirms the claim data and intake are\ncomplete. The submission row is locked while deciding, so two approvals (or an approval racing a hold) apply\none after the other.","operationId":"approve_for_filing_v1_va_review__claim_id__approve_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApproveRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Approve For Filing V1 Va Review Claim Id Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/review/{claim_id}/hold":{"post":{"tags":["va-review"],"summary":"Place On Hold","description":"Place a case on hold — removes it from the active queue (and voids an approval not yet filed).","operationId":"place_on_hold_v1_va_review__claim_id__hold_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoldRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Place On Hold V1 Va Review Claim Id Hold Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/package/{claim_id}/generate":{"post":{"tags":["va-package"],"summary":"Generate Package","description":"Generate a filing-ready VA claim package.\n\nPulls claim_data and veteran_intake from the claim record,\nruns all form generators + report generators, and stores\nthe outputs for download.\n\nReturns a list of generated documents with download URLs.","operationId":"generate_package_v1_va_package__claim_id__generate_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Package V1 Va Package Claim Id Generate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/package/{claim_id}/download":{"get":{"tags":["va-package"],"summary":"Download Package Zip","description":"Download the complete package as a ZIP file (the 21-526EZ without the SSN unless include_full_ssn).","operationId":"download_package_zip_v1_va_package__claim_id__download_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"The 21-526EZ with the whole SSN (owner/admin with MFA, or the claimant from their portal after a recent sign-in; logged).","default":false,"title":"Include Full Ssn"},"description":"The 21-526EZ with the whole SSN (owner/admin with MFA, or the claimant from their portal after a recent sign-in; logged)."},{"name":"via","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"portal: the claimant's own download (never staff acting in the portal).","title":"Via"},"description":"portal: the claimant's own download (never staff acting in the portal)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/package/{claim_id}/documents":{"get":{"tags":["va-package"],"summary":"List Package Documents","description":"List generated documents for a claim.","operationId":"list_package_documents_v1_va_package__claim_id__documents_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Package Documents V1 Va Package Claim Id Documents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/va/package/{claim_id}/document/{doc_name}":{"get":{"tags":["va-package"],"summary":"Download Single Document","description":"Download a single document from the package (the 21-526EZ without the SSN unless include_full_ssn).","operationId":"download_single_document_v1_va_package__claim_id__document__doc_name__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"doc_name","in":"path","required":true,"schema":{"type":"string","title":"Doc Name"}},{"name":"include_full_ssn","in":"query","required":false,"schema":{"type":"boolean","description":"The 21-526EZ with the whole SSN (owner/admin with MFA, or the claimant from their portal after a recent sign-in; logged).","default":false,"title":"Include Full Ssn"},"description":"The 21-526EZ with the whole SSN (owner/admin with MFA, or the claimant from their portal after a recent sign-in; logged)."},{"name":"via","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"portal: the claimant's own download (never staff acting in the portal).","title":"Via"},"description":"portal: the claimant's own download (never staff acting in the portal)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ime-tools/checklist":{"get":{"tags":["ime-tools"],"summary":"Get Pre Exam Checklist","description":"Generate an IME pre-exam preparation checklist.","operationId":"get_pre_exam_checklist_v1_claims__claim_id__ime_tools_checklist_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__ime_tools__ChecklistResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ime-tools/scheduling":{"get":{"tags":["ime-tools"],"summary":"Get Scheduling","description":"Get IME exam scheduling metadata for a claim.","operationId":"get_scheduling_v1_claims__claim_id__ime_tools_scheduling_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IMESchedulingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["ime-tools"],"summary":"Update Scheduling","description":"Set or update IME exam scheduling metadata.","operationId":"update_scheduling_v1_claims__claim_id__ime_tools_scheduling_put","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IMESchedulingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IMESchedulingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/cost-disputes":{"get":{"tags":["msa-tools"],"summary":"Get Cost Disputes","description":"Flag MSA cost items that may be disputable.","operationId":"get_cost_disputes_v1_claims__claim_id__msa_tools_cost_disputes_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CostDisputesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/annuity":{"get":{"tags":["msa-tools"],"summary":"Get Annuity","description":"Calculate seed + annuity funding structure for an MSA.","operationId":"get_annuity_v1_claims__claim_id__msa_tools_annuity_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"discount_rate","in":"query","required":false,"schema":{"type":"number","maximum":0.15,"minimum":0.0,"description":"Annual discount rate","default":0.03,"title":"Discount Rate"},"description":"Annual discount rate"},{"name":"admin_fee_pct","in":"query","required":false,"schema":{"type":"number","maximum":0.1,"minimum":0.0,"description":"Admin fee as fraction","default":0.0,"title":"Admin Fee Pct"},"description":"Admin fee as fraction"},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedAnnuityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/sensitivity":{"get":{"tags":["msa-tools"],"summary":"Get Sensitivity","description":"Run sensitivity analysis on MSA cost parameters.","operationId":"get_sensitivity_v1_claims__claim_id__msa_tools_sensitivity_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SensitivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/cms-form":{"get":{"tags":["msa-tools"],"summary":"Get Cms Form","description":"Generate CMS submission form fields for an MSA claim.","operationId":"get_cms_form_v1_claims__claim_id__msa_tools_cms_form_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__msa_tools__CMSSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/cms-document":{"get":{"tags":["msa-tools"],"summary":"Get Cms Document","description":"Generate a structured CMS MSA-101 form document for submission.","operationId":"get_cms_document_v1_claims__claim_id__msa_tools_cms_document_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CMSFormDocumentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/allocation":{"get":{"tags":["msa-tools"],"summary":"Get Cms Allocation","description":"Calculate CMS WCMSA allocation with full auditable worksheet.","operationId":"get_cms_allocation_v1_claims__claim_id__msa_tools_allocation_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CMSAllocationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-tools/iro":{"get":{"tags":["msa-tools"],"summary":"Get Iro Findings","description":"Extract IRO (Independent Review Organization) findings for an MSA claim.","operationId":"get_iro_findings_v1_claims__claim_id__msa_tools_iro_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IROExtractionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/msa-service/queue":{"get":{"tags":["msa-service"],"summary":"List Msa Queue","description":"List active MSA 48h claims with SLA data.","operationId":"list_msa_queue_v1_msa_service_queue_get","parameters":[{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"}},{"name":"has_blockers","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Blockers"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MSAQueueItem"},"title":"Response List Msa Queue V1 Msa Service Queue Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/start-sla":{"post":{"tags":["msa-service"],"summary":"Start Msa Sla","description":"Initialize the 48-hour SLA clock for an MSA claim.","operationId":"start_msa_sla_v1_claims__claim_id__msa_service_start_sla_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSLAResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/progress":{"get":{"tags":["msa-service"],"summary":"Get Msa Progress","description":"Get MSA service progress including SLA countdown.","operationId":"get_msa_progress_v1_claims__claim_id__msa_service_progress_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MSAProgressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/advance":{"post":{"tags":["msa-service"],"summary":"Advance Msa Stage","description":"Attempt to advance the MSA workflow to the next stage.","operationId":"advance_msa_stage_v1_claims__claim_id__msa_service_advance_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/qa-review":{"get":{"tags":["msa-service"],"summary":"Get Qa Review","description":"Get current QA review status.","operationId":"get_qa_review_v1_claims__claim_id__msa_service_qa_review_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QAReviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["msa-service"],"summary":"Submit Qa Review","description":"Submit QA review decision.","operationId":"submit_qa_review_v1_claims__claim_id__msa_service_qa_review_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QAReviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Qa Review V1 Claims Claim Id Msa Service Qa Review Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/download":{"get":{"tags":["msa-service"],"summary":"Download Via Token","description":"Download MSA report bundle via secure token (no auth required).","operationId":"download_via_token_v1_claims__claim_id__msa_service_download_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"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"}}}}}}},"/v1/claims/{claim_id}/msa-service/report-bundle":{"get":{"tags":["msa-service"],"summary":"Download Report Bundle","description":"Download all MSA reports as a ZIP file (authenticated).","operationId":"download_report_bundle_v1_claims__claim_id__msa_service_report_bundle_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msa-service/review-package":{"get":{"tags":["msa-service"],"summary":"Get Review Package","description":"Get the QA review package (report summaries + gaps + completeness).","operationId":"get_review_package_v1_claims__claim_id__msa_service_review_package_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations":{"post":{"tags":["hipaa"],"summary":"Create Hipaa Authorization","description":"Create a HIPAA authorization for a provider.","operationId":"create_hipaa_authorization_v1_claims__claim_id__hipaa_authorizations_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPAAAuthCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPAAAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["hipaa"],"summary":"List Hipaa Authorizations","description":"List all HIPAA authorizations for a claim.","operationId":"list_hipaa_authorizations_v1_claims__claim_id__hipaa_authorizations_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HIPAAAuthResponse"},"title":"Response List Hipaa Authorizations V1 Claims Claim Id Hipaa Authorizations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/{auth_id}/sign":{"patch":{"tags":["hipaa"],"summary":"Sign Hipaa Authorization","description":"Record a signature on a HIPAA authorization.","operationId":"sign_hipaa_authorization_v1_claims__claim_id__hipaa_authorizations__auth_id__sign_patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"auth_id","in":"path","required":true,"schema":{"type":"string","title":"Auth Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPAAAuthSignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/{auth_id}/send-for-signature":{"post":{"tags":["hipaa"],"summary":"Send For Signature","description":"Send a HIPAA authorization form for e-signature.\n\nGenerates the HIPAA PDF, sends it to the claimant (or representative)\nfor electronic signature, and updates the authorization status.","operationId":"send_for_signature_v1_claims__claim_id__hipaa_authorizations__auth_id__send_for_signature_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"auth_id","in":"path","required":true,"schema":{"type":"string","title":"Auth Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/{auth_id}/revoke":{"post":{"tags":["hipaa"],"summary":"Revoke Hipaa Authorization","description":"Revoke a HIPAA authorization.","operationId":"revoke_hipaa_authorization_v1_claims__claim_id__hipaa_authorizations__auth_id__revoke_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"auth_id","in":"path","required":true,"schema":{"type":"string","title":"Auth Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/status-summary":{"get":{"tags":["hipaa"],"summary":"Hipaa Status Summary","description":"Get a summary of HIPAA authorization statuses for a claim.","operationId":"hipaa_status_summary_v1_claims__claim_id__hipaa_authorizations_status_summary_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPAAStatusSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/{auth_id}/form":{"get":{"tags":["hipaa"],"summary":"Get Hipaa Form","description":"Generate a HIPAA authorization form document for a provider.\n\nQuery params:\n format: \"json\" (default) or \"pdf\"","operationId":"get_hipaa_form_v1_claims__claim_id__hipaa_authorizations__auth_id__form_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"auth_id","in":"path","required":true,"schema":{"type":"string","title":"Auth Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/hipaa-authorizations/generate-batch":{"post":{"tags":["hipaa"],"summary":"Generate Batch Authorizations","description":"Generate HIPAA authorizations for all discovered providers.","operationId":"generate_batch_authorizations_v1_claims__claim_id__hipaa_authorizations_generate_batch_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hospice/adr/respond":{"post":{"tags":["hospice-adr"],"summary":"Respond To Adr","description":"Generate an ADR response for a hospice claim and persist it.\n\nLoads ``merged_extraction`` from the DB (if configured) or the\nin-memory store, re-scores hospice inference deterministically,\nruns the generator, and appends the response to\n``workflow_state[\"hospice_adr\"][\"responses\"]`` so the artifact\nsurvives server restarts and is retrievable for audit.","operationId":"respond_to_adr_v1_hospice_adr_respond_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HospiceADRRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Respond To Adr V1 Hospice Adr Respond Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/providers":{"get":{"tags":["record-collection"],"summary":"List Providers","description":"List discovered providers from extraction + NPI enrichment.","operationId":"list_providers_v1_claims__claim_id__record_collection_providers_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProviderResponse"},"title":"Response List Providers V1 Claims Claim Id Record Collection Providers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/requests":{"get":{"tags":["record-collection"],"summary":"List Record Requests","description":"List all record requests for a claim.","operationId":"list_record_requests_v1_claims__claim_id__record_collection_requests_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecordRequestResponse"},"title":"Response List Record Requests V1 Claims Claim Id Record Collection Requests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["record-collection"],"summary":"Create Record Request","description":"Create a record request for a provider.","operationId":"create_record_request_v1_claims__claim_id__record_collection_requests_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRecordRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/requests/batch":{"post":{"tags":["record-collection"],"summary":"Batch Create Requests","description":"Create record requests for all discovered providers.","operationId":"batch_create_requests_v1_claims__claim_id__record_collection_requests_batch_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/requests/{request_id}/send":{"patch":{"tags":["record-collection"],"summary":"Send Record Request","description":"Send a record request (Phase 1: stub).","operationId":"send_record_request_v1_claims__claim_id__record_collection_requests__request_id__send_patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/requests/{request_id}/received":{"patch":{"tags":["record-collection"],"summary":"Mark Received","description":"Mark records as received, linking to uploaded document.","operationId":"mark_received_v1_claims__claim_id__record_collection_requests__request_id__received_patch","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkReceivedBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/record-collection/completeness":{"get":{"tags":["record-collection"],"summary":"Get Completeness","description":"Get record collection completeness score and checklist.","operationId":"get_completeness_v1_claims__claim_id__record_collection_completeness_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompletenessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/cms/validate":{"post":{"tags":["cms"],"summary":"Validate Cms Package","description":"Validate MSA package completeness for CMS submission.","operationId":"validate_cms_package_v1_claims__claim_id__cms_validate_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CMSValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/cms/submit":{"post":{"tags":["cms"],"summary":"Submit To Cms","description":"Submit MSA package to CMS (Phase 1: stub marks as submitted).","operationId":"submit_to_cms_v1_claims__claim_id__cms_submit_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__cms_submit__CMSSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/cms/submissions":{"get":{"tags":["cms"],"summary":"List Cms Submissions","description":"List all CMS submissions for a claim.","operationId":"list_cms_submissions_v1_claims__claim_id__cms_submissions_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/extraction__api__routes__cms_submit__CMSSubmissionResponse"},"title":"Response List Cms Submissions V1 Claims Claim Id Cms Submissions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/cms/submissions/{submission_id}":{"get":{"tags":["cms"],"summary":"Get Cms Submission","description":"Get a single CMS submission.","operationId":"get_cms_submission_v1_claims__claim_id__cms_submissions__submission_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__cms_submit__CMSSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/cms/submissions/{submission_id}/appeal":{"post":{"tags":["cms"],"summary":"File Appeal","description":"File an appeal on a denied CMS submission.","operationId":"file_appeal_v1_claims__claim_id__cms_submissions__submission_id__appeal_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppealRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msprp":{"get":{"tags":["msprp"],"summary":"Get Conditional Payment","description":"Get conditional payment record for a claim.","operationId":"get_conditional_payment_v1_claims__claim_id__msprp_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ConditionalPaymentResponse"},{"type":"null"}],"title":"Response Get Conditional Payment V1 Claims Claim Id Msprp Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["msprp"],"summary":"Create Or Update Conditional Payment","description":"Create or update conditional payment record.","operationId":"create_or_update_conditional_payment_v1_claims__claim_id__msprp_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConditionalPaymentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConditionalPaymentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msprp/query":{"post":{"tags":["msprp"],"summary":"Query Msprp","description":"Query MSPRP portal for conditional payment info.","operationId":"query_msprp_v1_claims__claim_id__msprp_query_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/msprp/dispute":{"post":{"tags":["msprp"],"summary":"Dispute Recovery","description":"Initiate dispute of recovery demand (Phase 1: stub).","operationId":"dispute_recovery_v1_claims__claim_id__msprp_dispute_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/esign":{"post":{"tags":["esign"],"summary":"Esign Webhook","description":"Handle e-signature provider webhook callbacks.\n\nUpdates HIPAAAuthorization status when documents are signed,\ndeclined, or voided.","operationId":"esign_webhook_v1_webhooks_esign_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/claims/{claim_id}/ltd-tools/appeal-report":{"get":{"tags":["ltd-tools"],"summary":"Get Appeal Report","description":"Generate an ERISA appeal report for an LTD claim.","operationId":"get_appeal_report_v1_claims__claim_id__ltd_tools_appeal_report_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppealReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ltd-tools/aps-requests":{"get":{"tags":["ltd-tools"],"summary":"Get Aps Requests","description":"Generate attending physician statement requests for an LTD claim.","operationId":"get_aps_requests_v1_claims__claim_id__ltd_tools_aps_requests_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APSRequestsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ltd-tools/benefit-calculation":{"get":{"tags":["ltd-tools"],"summary":"Get Benefit Calculation","description":"Calculate LTD benefit amount with offsets for a claim.","operationId":"get_benefit_calculation_v1_claims__claim_id__ltd_tools_benefit_calculation_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BenefitCalculationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/ltd-tools/occupation-analysis":{"get":{"tags":["ltd-tools"],"summary":"Get Occupation Analysis","description":"Analyze occupation demands vs functional capacity for an LTD claim.","operationId":"get_occupation_analysis_v1_claims__claim_id__ltd_tools_occupation_analysis_get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"persona","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OccupationAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/persons":{"get":{"tags":["persons"],"summary":"List Persons","description":"List persons (paginated, searchable).","operationId":"list_persons_v1_persons_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedPersonsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/persons/{person_id}/claims/{claim_id}":{"post":{"tags":["persons"],"summary":"Link Claim","description":"Manually link a claim to a person.","operationId":"link_claim_v1_persons__person_id__claims__claim_id__post","parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}},{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonLinkRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["persons"],"summary":"Unlink Claim","description":"Unlink a claim from a person.","operationId":"unlink_claim_v1_persons__person_id__claims__claim_id__delete","parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}},{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/persons/{person_id}/overrides":{"post":{"tags":["persons"],"summary":"Create Person Override","description":"Create a person-level field override.","operationId":"create_person_override_v1_persons__person_id__overrides_post","parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonOverrideRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonOverrideResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["persons"],"summary":"List Person Overrides","description":"List active person-level overrides.","operationId":"list_person_overrides_v1_persons__person_id__overrides_get","parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PersonOverrideResponse"},"title":"Response List Person Overrides V1 Persons Person Id Overrides Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/persons/{person_id}/overrides/{override_id}":{"delete":{"tags":["persons"],"summary":"Revoke Person Override","description":"Revoke a person-level override.","operationId":"revoke_person_override_v1_persons__person_id__overrides__override_id__delete","parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string","title":"Person Id"}},{"name":"override_id","in":"path","required":true,"schema":{"type":"string","title":"Override Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portfolio/hospice/metrics":{"get":{"tags":["portfolio"],"summary":"Get Hospice Portfolio Metrics","description":"Get aggregate portfolio metrics for hospice claims.","operationId":"get_hospice_portfolio_metrics_v1_portfolio_hospice_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioMetricsResponse"}}}}}}},"/v1/portfolio/hospice/simulate-audit":{"post":{"tags":["portfolio"],"summary":"Simulate Hospice Audit","description":"Preview a random audit sample: how many sampled admissions fall in each denial risk band.\n\nThe expected counts and the high-band range are exact (hypergeometric) for a\nrandom sample without replacement. They count admissions the model rates in a\nband; they are not denials.","operationId":"simulate_hospice_audit_v1_portfolio_hospice_simulate_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditSimulationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditSimulationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portfolio/hospice/trends":{"get":{"tags":["portfolio"],"summary":"Get Hospice Trends","description":"Get month-over-month trend data for hospice portfolio metrics.\n\nReturns historical snapshots and comparison to baseline (earliest snapshot).","operationId":"get_hospice_trends_v1_portfolio_hospice_trends_get","parameters":[{"name":"months","in":"query","required":false,"schema":{"type":"integer","maximum":24,"minimum":1,"description":"Number of months to retrieve","default":12,"title":"Months"},"description":"Number of months to retrieve"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portfolio/hospice/board-report":{"get":{"tags":["portfolio"],"summary":"Get Hospice Board Report","description":"Generate executive board report for hospice portfolio.\n\nReturns comprehensive data for board presentation including:\n- Executive summary of key metrics\n- 6-month trends\n- Top 10 highest-risk admissions (PHI redacted)\n- Recommended actions","operationId":"get_hospice_board_report_v1_portfolio_hospice_board_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardReportResponse"}}}}}}},"/v1/intake/sessions/{token}/documents":{"post":{"tags":["intake"],"summary":"Upload Session Document","description":"Upload a supporting document for an anonymous intake session.\n\nFiles can't ride a chat turn, so the chat agent's ``upload_document`` tool\nsurfaces an upload control that posts here. We resolve the session's own\nclaim (creating one if it doesn't exist yet), then run the SAME validated\nextraction pipeline as the authenticated ``POST /claims/{claim_id}/documents``\nroute — scoped strictly to the session's own org via a system\n``AuthContext``. Once extraction completes, the live re-scoring loop reflects\nthe new evidence.\n\nIsolation: the anonymous caller only controls the opaque ``session_token``;\nthe target ``claim_id`` and ``org_id`` are both derived server-side from the\nsession, so a caller can never upload into another tenant's claim.","operationId":"upload_session_document_v1_intake_sessions__token__documents_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/SessionDocumentUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/sessions/{token}/chat/stream":{"get":{"tags":["intake"],"summary":"Stream Chat","description":"SSE stream for real-time chat events on this intake session.\n\nStreams events from the conversation engine as they occur:\n- agent_response: new message from the AI agent\n- info_collected: a field was collected\n- conversation_completed: conversation finished\n- ping: keepalive","operationId":"stream_chat_v1_intake_sessions__token__chat_stream_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/claims/{claim_id}/snooze":{"post":{"tags":["intake"],"summary":"Snooze Intake","description":"Snooze an intake until a future timestamp. Stored on workflow_state['intake'].","operationId":"snooze_intake_v1_intake_claims__claim_id__snooze_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnoozeIntakeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/quick-capture":{"post":{"tags":["intake"],"summary":"Quick Capture","description":"Spin up a new intake claim from minimal information.\n\nAt least one of claim_type, claimant_name, or phone is required. When a\nphone is provided we first try to reconnect to an existing intake/active\nclaim for that number — this is the \"they called back, return to their\ncase\" flow described in the original requirements.","operationId":"quick_capture_v1_intake_quick_capture_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickCaptureRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickCaptureResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/bulk":{"post":{"tags":["intake"],"summary":"Bulk Intake","description":"Create multiple intake claims in a single API call.\n\nEach item creates a new claim with minimal info (like quick-capture but\nwithout phone reconnection logic). Optionally enqueues background scoring.\n\nReturns immediately with claim IDs. If ``webhook_url`` is provided,\na POST is sent when all background scoring completes.","operationId":"bulk_intake_v1_intake_bulk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkIntakeRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkIntakeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/bulk/{batch_id}":{"get":{"tags":["intake"],"summary":"Get Bulk Intake Status","description":"Poll the status of a bulk intake batch.\n\nComplements the ``bulk_intake.completed`` webhook (and is the fallback\nwhen no ``webhook_url`` was provided): partners can poll the ``batch_id``\nreturned by ``POST /intake/bulk`` until ``status`` is terminal.\n\nItem shape matches the webhook's ``items`` array exactly, so partners can\nshare one parser for both paths.\n\nReturns 404 for unknown batch IDs and for batches submitted with\n``async_scoring=false`` (no background work exists to poll — the sync\nresponse was already final).","operationId":"get_bulk_intake_status_v1_intake_bulk__batch_id__get","parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string","title":"Batch Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/extraction__api__routes__intake__BatchStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intake/bulk/{batch_id}/export/{format}":{"get":{"tags":["intake"],"summary":"Export Bulk Intake","description":"Export all scored claims in a bulk-intake batch in a single call.\n\nComplements the per-claim export (``POST /claims/{id}/export/{format}``):\nrather than one call per claim, this returns every claim in the batch as a\nsingle ``csv`` (one row per claim) or ``json`` document, keyed by the\ncaller's ``external_id``. This is the deliverable for a \"send me N real\nclaims\" proof — one spreadsheet to diff Zicron scores against the\npartner's own reviewers.\n\nRead-only; aggregates data that already exists (no new inference, no new\nstorage). Returns 404 for unknown batch IDs.","operationId":"export_bulk_intake_v1_intake_bulk__batch_id__export__format__get","parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string","title":"Batch Id"}},{"name":"format","in":"path","required":true,"schema":{"type":"string","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/integrations/webhook":{"get":{"tags":["integrations"],"summary":"Get Webhook Config","description":"Return the org's partner webhook URL (Settings → Webhooks).\n\n# legacy: web moved to webhooks.get@1 on 2026-09-28 (web-caps slice 14).","operationId":"get_webhook_config_v1_integrations_webhook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookConfigResponse"}}}}}},"put":{"tags":["integrations"],"summary":"Set Webhook Config","description":"Configure or clear the org partner webhook URL.\n\n# legacy: web moved to webhooks.configure@1 on 2026-09-28 (web-caps slice 14; there, the first URL also\n# generates the signing secret). API keys with claims:write still use this route.\n\nRequires admin/owner (session) or API key with ``integrations:write``.","operationId":"set_webhook_config_v1_integrations_webhook_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/integrations/webhook/secret":{"post":{"tags":["integrations"],"summary":"Rotate Webhook Secret","description":"Generate (or rotate) the org's webhook signing secret.\n\nThe raw secret is returned exactly once. Outgoing webhooks are signed with\nhex HMAC-SHA256 over ``{X-Timestamp}.{raw_body}``, sent in the\n``X-Signature`` header (see docs/PARTNER_INTEGRATION.md for receiver-side\nverification). Rotation takes effect immediately, including queued\ndeliveries.","operationId":"rotate_webhook_secret_v1_integrations_webhook_secret_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSecretResponse"}}}}}}},"/v1/integrations/intake-analytics":{"get":{"tags":["integrations"],"summary":"Get Intake Carrier Analytics","description":"Carrier-view SSDI intake metrics for the authenticated org.\n\n# legacy: web moved to analytics.intake@1 on 2026-09-28 (web-caps slice 14). Same numbers\n# (``orgadmin/reports.intake_analytics``, which reads three columns instead of whole cases).","operationId":"get_intake_carrier_analytics_v1_integrations_intake_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeCarrierAnalyticsResponse"}}}}}}},"/v1/claims/{claim_id}/drafts/{draft_id}":{"delete":{"tags":["drafts"],"summary":"Delete Draft","description":"Soft delete a draft document.","operationId":"delete_draft_v1_claims__claim_id__drafts__draft_id__delete","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/auth/request-otp":{"post":{"tags":["portal-auth"],"summary":"Request Otp","description":"Send an OTP code via SMS. Always returns 200 to prevent phone enumeration.","operationId":"request_otp_v1_portal_auth_request_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestOTPBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/auth/verify-otp":{"post":{"tags":["portal-auth"],"summary":"Verify Otp","description":"Verify an OTP code and create a session.","operationId":"verify_otp_v1_portal_auth_verify_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyOTPBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/guest/session":{"post":{"tags":["guest"],"summary":"Create Guest Session","description":"Create a new guest organization and session.\n\nThis allows self-service flows (hospice, MSA) to work without\nrequiring full user registration. The guest can later claim\ntheir org by registering with the same email.\n\nEvery call creates a new guest org: the email is unverified, so it is\nnever used to look up (and hand out) an existing guest's org.\n\nReturns a session token that can be used for authenticated API calls.","operationId":"create_guest_session_v1_guest_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGuestSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuestSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capabilities":{"get":{"tags":["capabilities"],"summary":"List capabilities with your access","operationId":"manifest_v1_capabilities_get","security":[{"ApiKey":[]},{"Session":[]}],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only this domain, e.g. 'cases'.","title":"Domain"},"description":"Only this domain, e.g. 'cases'."},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"const":"public","type":"string"},{"type":"null"}],"description":"'public' returns only public meta fields.","title":"Include"},"description":"'public' returns only public meta fields."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Manifest V1 Capabilities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capabilities/whoami":{"get":{"tags":["capabilities"],"summary":"Who am I (same as platform.whoami@1)","operationId":"whoami_v1_capabilities_whoami_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKey":[]},{"Session":[]}]}},"/v1/capabilities/invocations":{"get":{"tags":["capabilities"],"summary":"Capability invocation audit feed","operationId":"invocations_v1_capabilities_invocations_get","security":[{"ApiKey":[]},{"Session":[]}],"parameters":[{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"name or name@version","title":"Capability"},"description":"name or name@version"},{"name":"principal_kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["human","api_key","agent","service","anonymous"],"type":"string"},{"type":"null"}],"title":"Principal Kind"}},{"name":"decision","in":"query","required":false,"schema":{"anyOf":[{"enum":["allowed","denied"],"type":"string"},{"type":"null"}],"title":"Decision"}},{"name":"outcome","in":"query","required":false,"schema":{"anyOf":[{"enum":["success","failed","replayed","dry_run","denied"],"type":"string"},{"type":"null"}],"title":"Outcome"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"description":"The run timeline: the call that started this run (who asked) and every step the platform took on their behalf. Use with order=oldest to read it in order.","title":"Run Id"},"description":"The run timeline: the call that started this run (who asked) and every step the platform took on their behalf. Use with order=oldest to read it in order."},{"name":"order","in":"query","required":false,"schema":{"enum":["newest","oldest"],"type":"string","description":"newest first (default) or oldest first.","default":"newest","title":"Order"},"description":"newest first (default) or oldest first."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"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/InvocationsPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capabilities/invocations/stats":{"get":{"tags":["capabilities"],"summary":"Invocation counts by capability, decision and principal kind","operationId":"invocation_stats_v1_capabilities_invocations_stats_get","security":[{"ApiKey":[]},{"Session":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Invocation Stats V1 Capabilities Invocations Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capabilities/{key}:invoke":{"post":{"tags":["capabilities"],"summary":"Invoke a capability (name@version)","operationId":"invoke_colon_v1_capabilities__key__invoke_post","security":[{"ApiKey":[]},{"Session":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvokeRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/metadata/protected-resource":{"get":{"tags":["oauth"],"summary":"RFC 9728 protected resource metadata for /agent/mcp","operationId":"protected_resource_metadata_v1_oauth_metadata_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/metadata/authorization-server":{"get":{"tags":["oauth"],"summary":"RFC 8414 authorization server metadata","operationId":"authorization_server_metadata_v1_oauth_metadata_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/register":{"post":{"tags":["oauth"],"summary":"Dynamic client registration (public clients)","operationId":"register_v1_oauth_register_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/authorize":{"get":{"tags":["oauth"],"summary":"Start authorization: validates, then sends the browser to the consent page","operationId":"authorize_v1_oauth_authorize_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["oauth"],"summary":"Record the consent decision; returns where to send the browser","operationId":"authorize_decision_v1_oauth_authorize_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/authorize/context":{"get":{"tags":["oauth"],"summary":"What the consent page shows (session required)","operationId":"authorize_context_v1_oauth_authorize_context_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/token":{"post":{"tags":["oauth"],"summary":"Token endpoint: authorization_code (PKCE S256) and refresh_token (rotating)","operationId":"token_v1_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/revoke":{"post":{"tags":["oauth"],"summary":"Token revocation (RFC 7009); revokes the whole connection","operationId":"revoke_v1_oauth_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/grants":{"get":{"tags":["oauth"],"summary":"Connected assistants: your grants, or the whole org's (scope=org, owners/admins)","operationId":"list_grants_v1_oauth_grants_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"mine","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/grants/{grant_id}":{"patch":{"tags":["oauth"],"summary":"Choose a connected assistant's toolsets (which tools it lists; people only)","operationId":"update_grant_v1_oauth_grants__grant_id__patch","parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["oauth"],"summary":"Disconnect an assistant: revokes every token of the grant (people only)","operationId":"revoke_grant_v1_oauth_grants__grant_id__delete","parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/mcp":{"post":{"tags":["mcp"],"summary":"Authenticated MCP server (Streamable HTTP, stateless JSON)","operationId":"mcp_post_v1_agent_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ADRLetter":{"properties":{"letter_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Letter Id"},"mac_contractor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mac Contractor","description":"Issuing contractor, e.g. 'Palmetto GBA', 'CGS Administrators'."},"letter_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Letter Date"},"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id","description":"Provider's internal claim id (separate from Zicron claim id)."},"patient_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Name"},"medicare_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medicare Id"},"dates_of_service":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dates Of Service","description":"e.g. '2023-08-15 through 2024-02-29'."},"findings":{"items":{"$ref":"#/components/schemas/AuditorFinding"},"type":"array","title":"Findings"},"raw_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Text","description":"Full pasted letter text; used as fallback when findings == []."}},"type":"object","title":"ADRLetter","description":"Structured ADR (Additional Documentation Request) letter input."},"APSRequestItemResponse":{"properties":{"provider":{"type":"string","title":"Provider"},"specialty":{"type":"string","title":"Specialty","default":""},"information_needed":{"items":{"type":"string"},"type":"array","title":"Information Needed"},"form_sections":{"items":{"type":"string"},"type":"array","title":"Form Sections"},"priority":{"type":"string","title":"Priority","default":"normal"}},"type":"object","required":["provider"],"title":"APSRequestItemResponse"},"APSRequestsResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"requests":{"items":{"$ref":"#/components/schemas/APSRequestItemResponse"},"type":"array","title":"Requests"},"total_requests":{"type":"integer","title":"Total Requests","default":0}},"type":"object","required":["claim_id"],"title":"APSRequestsResponse"},"ActionResponse":{"properties":{"id":{"type":"string","title":"Id"},"action_type":{"type":"string","title":"Action Type"},"action_payload":{"additionalProperties":true,"type":"object","title":"Action Payload"},"result_status":{"type":"string","title":"Result Status"},"requires_approval":{"type":"boolean","title":"Requires Approval"},"approved_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved By"},"approved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved At"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","action_type","action_payload","result_status","requires_approval","created_at"],"title":"ActionResponse"},"AdminConvertTrialRequest":{"properties":{"user_email":{"type":"string","title":"User Email"},"conversion_type":{"type":"string","title":"Conversion Type"},"target_org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Org Id"},"new_org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Org Name"}},"type":"object","required":["user_email","conversion_type"],"title":"AdminConvertTrialRequest","description":"Admin request to convert trial user to production."},"AdminStats":{"properties":{"total_orgs":{"type":"integer","title":"Total Orgs"},"total_users":{"type":"integer","title":"Total Users"},"total_claims":{"type":"integer","title":"Total Claims"}},"type":"object","required":["total_orgs","total_users","total_claims"],"title":"AdminStats"},"AllUsersResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"is_active":{"type":"boolean","title":"Is Active"},"is_superadmin":{"type":"boolean","title":"Is Superadmin"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled","default":false},"require_mfa_setup":{"type":"boolean","title":"Require Mfa Setup","default":false},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","email","name","role","org_id","org_name","is_active","is_superadmin","created_at"],"title":"AllUsersResponse","description":"User with org context for cross-org selection."},"AllocationWorksheetLineResponse":{"properties":{"step":{"type":"string","title":"Step"},"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs"},"formula":{"type":"string","title":"Formula","default":""},"result":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Result","default":0.0},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["step","category","description"],"title":"AllocationWorksheetLineResponse"},"AmendFormRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for the amendment"}},"type":"object","required":["reason"],"title":"AmendFormRequest"},"AnalysisCompleteRequest":{"properties":{"email":{"type":"string","title":"Email"},"claim_id":{"type":"string","title":"Claim Id"},"overall_score":{"type":"number","title":"Overall Score"},"risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Level"},"steps_passed":{"type":"integer","title":"Steps Passed"},"total_steps":{"type":"integer","title":"Total Steps"},"gap_count":{"type":"integer","title":"Gap Count"},"action_count":{"type":"integer","title":"Action Count"}},"type":"object","required":["email","claim_id","overall_score","steps_passed","total_steps","gap_count","action_count"],"title":"AnalysisCompleteRequest","description":"Request to send analysis complete email."},"AnalyticsDashboardResponse":{"properties":{"total_claims":{"type":"integer","title":"Total Claims","default":0},"claims_by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"Claims By Status"},"claims_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Claims By Type"},"total_hours_billed":{"type":"number","title":"Total Hours Billed","default":0.0},"total_fees_collected":{"type":"number","title":"Total Fees Collected","default":0.0},"total_fees_pending":{"type":"number","title":"Total Fees Pending","default":0.0},"avg_claim_duration_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Claim Duration Days"},"approval_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Approval Rate"},"recent_activity":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Activity"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["generated_at"],"title":"AnalyticsDashboardResponse"},"AppealPointResponse":{"properties":{"issue":{"type":"string","title":"Issue"},"argument":{"type":"string","title":"Argument"},"legal_authority":{"type":"string","title":"Legal Authority","default":""},"supporting_evidence":{"items":{"type":"string"},"type":"array","title":"Supporting Evidence"},"strength":{"type":"string","title":"Strength","default":"moderate"}},"type":"object","required":["issue","argument"],"title":"AppealPointResponse"},"AppealReportResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"denial_reason":{"type":"string","title":"Denial Reason","default":""},"points":{"items":{"$ref":"#/components/schemas/AppealPointResponse"},"type":"array","title":"Points"},"erisa_considerations":{"items":{"type":"string"},"type":"array","title":"Erisa Considerations"},"recommended_evidence":{"items":{"type":"string"},"type":"array","title":"Recommended Evidence"}},"type":"object","required":["claim_id"],"title":"AppealReportResponse"},"AppealRequest":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"AppealRequest"},"ApportionmentAnalysisResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"net_industrial_pct":{"type":"number","title":"Net Industrial Pct","default":0.0},"pre_existing_pct":{"type":"number","title":"Pre Existing Pct","default":0.0},"industrial_pct":{"type":"number","title":"Industrial Pct","default":0.0},"method":{"type":"string","title":"Method","default":""},"statute":{"type":"string","title":"Statute","default":""},"description":{"type":"string","title":"Description","default":""},"pre_existing_conditions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pre Existing Conditions"},"impact_on_benefits":{"type":"string","title":"Impact On Benefits","default":""},"state":{"type":"string","title":"State","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"ApportionmentAnalysisResponse"},"ApproveRequest":{"properties":{"notes":{"type":"string","title":"Notes","default":""}},"type":"object","title":"ApproveRequest"},"AssistantMessageRequest":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"message":{"type":"string","title":"Message"},"context":{"anyOf":[{"$ref":"#/components/schemas/AssistantUIContext"},{"type":"null"}]}},"type":"object","required":["conversation_id","message"],"title":"AssistantMessageRequest"},"AssistantUIContext":{"properties":{"active_section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active Section"},"active_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active Document Id"},"active_document_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Document Page"},"selected_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Text"},"selection_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selection Source"}},"type":"object","title":"AssistantUIContext"},"AuditSimulationRequest":{"properties":{"sample_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Sample Size","description":"Admissions an auditor samples","default":30},"avg_reimbursement_per_admission":{"type":"number","minimum":0.0,"title":"Avg Reimbursement Per Admission","description":"Your average reimbursement per admission ($); an input, not a benchmark","default":22000}},"type":"object","title":"AuditSimulationRequest","description":"Parameters for the audit sample preview."},"AuditSimulationResponse":{"properties":{"census":{"type":"integer","title":"Census"},"sample_size":{"type":"integer","title":"Sample Size"},"band_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Band Counts"},"expected_in_sample":{"additionalProperties":{"type":"number"},"type":"object","title":"Expected In Sample"},"high_risk_in_sample_range":{"prefixItems":[{"type":"integer"},{"type":"integer"}],"type":"array","maxItems":2,"minItems":2,"title":"High Risk In Sample Range"},"avg_reimbursement_per_admission":{"type":"number","title":"Avg Reimbursement Per Admission"},"reimbursement_on_high_risk":{"type":"number","title":"Reimbursement On High Risk"},"sample_composition":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sample Composition"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["census","sample_size","band_counts","expected_in_sample","high_risk_in_sample_range","avg_reimbursement_per_admission","reimbursement_on_high_risk","sample_composition","generated_at"],"title":"AuditSimulationResponse","description":"What a random audit sample of the scored census would contain, by denial risk band.\n\nCounts only: how many sampled admissions the model rates in each band. It is\nnot a denial rate or an expected number of denials (the score is not a\nprobability)."},"AuditorFinding":{"properties":{"finding_id":{"type":"string","title":"Finding Id","description":"Short stable id, e.g. 'F1', 'F2'."},"text":{"type":"string","title":"Text","description":"Verbatim auditor language."},"category":{"type":"string","enum":["terminal_diagnosis","prognosis","functional_decline","clinical_indicators","certification_completeness","other"],"title":"Category","default":"other"},"cited_lcd_criterion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cited Lcd Criterion","description":"LCD criterion referenced by auditor, e.g. 'L33393 — EF ≤ 20%'."},"cited_regulation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cited Regulation","description":"CFR / Medicare regulation reference, e.g. '42 CFR §418.22'."}},"type":"object","required":["finding_id","text"],"title":"AuditorFinding","description":"One specific objection raised by a MAC/UPIC/ZPIC auditor."},"BatchStatusItem":{"properties":{"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"status":{"type":"string","title":"Status"},"overall_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Score","description":"Case strength score, 0.0-1.0 (not a percentage). Deterministic rating of how well the evidence supports each evaluation step. Use it to rank and triage; it is NOT a probability of approval and has not been calibrated against claim outcomes."},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence","description":"low | medium | high"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"BatchStatusItem","description":"Per-claim scoring status within a batch (mirrors the\n``bulk_intake.completed`` webhook item shape)."},"BatchTaskStatusResponse":{"properties":{"id":{"type":"string","title":"Id"},"task_type":{"type":"string","title":"Task Type"},"status":{"type":"string","title":"Status"},"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"},"batch_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Id"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"children":{"items":{"$ref":"#/components/schemas/ChildTaskSummary"},"type":"array","title":"Children"},"aggregate":{"additionalProperties":true,"type":"object","title":"Aggregate"}},"type":"object","required":["id","task_type","status","claim_id","batch_id","created_at","completed_at","children","aggregate"],"title":"BatchTaskStatusResponse"},"BenefitCalculationResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"pre_disability_earnings":{"type":"number","title":"Pre Disability Earnings","default":0.0},"benefit_percentage":{"type":"number","title":"Benefit Percentage","default":0.6},"gross_benefit":{"type":"number","title":"Gross Benefit","default":0.0},"offsets":{"additionalProperties":{"type":"number"},"type":"object","title":"Offsets"},"net_benefit":{"type":"number","title":"Net Benefit","default":0.0},"breakdown":{"items":{"type":"string"},"type":"array","title":"Breakdown"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"BenefitCalculationResponse"},"BillingStatusResponse":{"properties":{"billing_enabled":{"type":"boolean","title":"Billing Enabled"},"has_subscription":{"type":"boolean","title":"Has Subscription","default":false},"subscription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Status"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"}},"type":"object","required":["billing_enabled"],"title":"BillingStatusResponse"},"BoardReportResponse":{"properties":{"org_name":{"type":"string","title":"Org Name"},"report_date":{"type":"string","format":"date-time","title":"Report Date"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"trends":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Trends"},"top_risks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Risks"},"recommended_actions":{"items":{"type":"string"},"type":"array","title":"Recommended Actions"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["org_name","report_date","summary","trends","top_risks","recommended_actions","generated_at"],"title":"BoardReportResponse","description":"Executive board report data for hospice portfolio."},"BodyPartImpairmentResponse":{"properties":{"body_part":{"type":"string","title":"Body Part"},"injury_type":{"type":"string","title":"Injury Type","default":""},"wpi_range_low":{"type":"integer","title":"Wpi Range Low","default":0},"wpi_range_high":{"type":"integer","title":"Wpi Range High","default":0},"reported_wpi":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reported Wpi"},"ama_region":{"type":"string","title":"Ama Region","default":""},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["body_part"],"title":"BodyPartImpairmentResponse"},"Body_compare_upload_against_prior_v1_history_delta_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_compare_upload_against_prior_v1_history_delta_post"},"Body_create_batch_upload_v1_claims__claim_id__documents_batch_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","default":[]}},"type":"object","title":"Body_create_batch_upload_v1_claims__claim_id__documents_batch_post"},"Body_create_msa_order_v1_msa_orders_post":{"properties":{"tier":{"type":"string","title":"Tier"},"email":{"type":"string","title":"Email"},"firm_name":{"type":"string","title":"Firm Name"},"claimant_first_name":{"type":"string","title":"Claimant First Name"},"claimant_last_name":{"type":"string","title":"Claimant Last Name"},"date_of_injury":{"type":"string","title":"Date Of Injury"},"settlement_amount":{"type":"string","title":"Settlement Amount"},"medicare_status":{"type":"string","title":"Medicare Status"},"success_url":{"type":"string","title":"Success Url"},"cancel_url":{"type":"string","title":"Cancel Url"},"phone":{"type":"string","title":"Phone","default":""},"case_number":{"type":"string","title":"Case Number","default":""},"notes":{"type":"string","title":"Notes","default":""},"utm_source":{"type":"string","title":"Utm Source","default":""},"utm_medium":{"type":"string","title":"Utm Medium","default":""},"utm_campaign":{"type":"string","title":"Utm Campaign","default":""},"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"}},"type":"object","required":["tier","email","firm_name","claimant_first_name","claimant_last_name","date_of_injury","settlement_amount","medicare_status","success_url","cancel_url","files"],"title":"Body_create_msa_order_v1_msa_orders_post"},"Body_create_referral_v1_api_referrals_post":{"properties":{"referral_id":{"type":"string","title":"Referral Id"},"claim_type":{"type":"string","title":"Claim Type"},"claimant":{"type":"string","title":"Claimant","default":"{}"},"case_info":{"type":"string","title":"Case Info","default":"{}"},"callback_url":{"type":"string","title":"Callback Url"},"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","default":[]}},"type":"object","required":["referral_id","claim_type"],"title":"Body_create_referral_v1_api_referrals_post"},"Body_extract_file_v1_extract_file_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_extract_file_v1_extract_file_post"},"Body_ingest_bulk_v1_ingest_bulk_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_ingest_bulk_v1_ingest_bulk_post"},"Body_ingest_email_v1_ingest_email_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_ingest_email_v1_ingest_email_post"},"Body_ingest_structured_v1_ingest_structured_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_ingest_structured_v1_ingest_structured_post"},"Body_upload_document_v1_claims__claim_id__documents_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_document_v1_claims__claim_id__documents_post"},"Body_upload_portal_document_v1_portal_claims__claim_id__documents_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_portal_document_v1_portal_claims__claim_id__documents_post"},"BrandUpdateRequest":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Color"},"accent_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accent Color"},"wordmark_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wordmark Text"},"email_from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email From Name"},"footer_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Footer Text"},"watermark_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Watermark Text"},"preset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset Id"}},"type":"object","title":"BrandUpdateRequest","description":"Partial update to org brand settings."},"BulkCreateRequest":{"properties":{"claim_ids":{"items":{"type":"string"},"type":"array","title":"Claim Ids"},"script_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Id"},"channel":{"type":"string","pattern":"^(voice|sms|email|web_chat)$","title":"Channel"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"}},"type":"object","required":["claim_ids","channel"],"title":"BulkCreateRequest"},"BulkCreateResponse":{"properties":{"created":{"type":"integer","title":"Created"},"skipped":{"type":"integer","title":"Skipped"},"skipped_claim_ids":{"items":{"type":"string"},"type":"array","title":"Skipped Claim Ids"}},"type":"object","required":["created","skipped"],"title":"BulkCreateResponse"},"BulkExtractionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"documents":{"items":{"$ref":"#/components/schemas/DocumentResult"},"type":"array","title":"Documents"},"total_documents":{"type":"integer","title":"Total Documents"},"successful":{"type":"integer","title":"Successful"},"failed":{"type":"integer","title":"Failed"},"skipped_files":{"items":{"type":"string"},"type":"array","title":"Skipped Files"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"duration_seconds":{"type":"number","title":"Duration Seconds"}},"type":"object","required":["success","documents","total_documents","successful","failed","duration_seconds"],"title":"BulkExtractionResponse","description":"Response for bulk extraction operations."},"BulkIntakeItem":{"properties":{"claim_type":{"type":"string","title":"Claim Type","description":"ssdi | wc | va | ime | msa | pi | ltd"},"claimant_name":{"type":"string","title":"Claimant Name","description":"Full name of the claimant"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"dob":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"ssn_last_four":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ssn Last Four","description":"Last 4 digits of SSN"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id","description":"Caller's external reference ID for correlation"},"alleged_onset_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alleged Onset Date","description":"When the condition stopped work (YYYY-MM-DD, YYYY-MM, or 'March 2025')"},"monthly_earnings":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Monthly Earnings","description":"Current gross monthly earnings in USD (0 if not working)"},"education_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Education Level","description":"Highest grade/degree, e.g. '11', '12', 'GED', 'high school', 'bachelor'"},"work_history":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Work History","description":"Past-15-year jobs: list of {job_title, employer, ...} or free text"},"conditions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Conditions","description":"Alleged medical conditions"}},"type":"object","required":["claim_type","claimant_name"],"title":"BulkIntakeItem","description":"Single item within a bulk intake request."},"BulkIntakeItemResult":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"status":{"type":"string","title":"Status","default":"intake"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["claim_id"],"title":"BulkIntakeItemResult"},"BulkIntakeRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BulkIntakeItem"},"type":"array","maxItems":500,"minItems":1,"title":"Items","description":"List of intake items to create (max 500)"},"source":{"type":"string","title":"Source","description":"Source identifier","default":"bulk_api"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"URL to POST results when all items are processed"},"async_scoring":{"type":"boolean","title":"Async Scoring","description":"If true, enqueue scoring as background tasks; if false, return without scoring","default":true}},"type":"object","required":["items"],"title":"BulkIntakeRequest","description":"Bulk intake: create multiple intake claims in a single request."},"BulkIntakeResponse":{"properties":{"batch_id":{"type":"string","title":"Batch Id"},"total":{"type":"integer","title":"Total"},"created":{"type":"integer","title":"Created"},"errors":{"type":"integer","title":"Errors"},"items":{"items":{"$ref":"#/components/schemas/BulkIntakeItemResult"},"type":"array","title":"Items"}},"type":"object","required":["batch_id","total","created","errors","items"],"title":"BulkIntakeResponse"},"CERecommendationReportResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"recommendations":{"items":{"$ref":"#/components/schemas/CERecommendationResponse"},"type":"array","title":"Recommendations"},"summary":{"type":"string","title":"Summary","default":""}},"type":"object","required":["claim_id"],"title":"CERecommendationReportResponse"},"CERecommendationResponse":{"properties":{"exam_type":{"type":"string","title":"Exam Type"},"specialty":{"type":"string","title":"Specialty"},"reason":{"type":"string","title":"Reason"},"priority":{"type":"string","title":"Priority","default":"medium"},"questions_for_examiner":{"items":{"type":"string"},"type":"array","title":"Questions For Examiner"}},"type":"object","required":["exam_type","specialty","reason"],"title":"CERecommendationResponse"},"CMSAllocationResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"calculation_date":{"type":"string","title":"Calculation Date","default":""},"methodology":{"type":"string","title":"Methodology","default":""},"claimant_name":{"type":"string","title":"Claimant Name","default":""},"chronological_age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chronological Age"},"rated_age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rated Age"},"gender":{"type":"string","title":"Gender","default":""},"state":{"type":"string","title":"State","default":""},"medicare_status":{"type":"string","title":"Medicare Status","default":""},"base_life_expectancy":{"type":"number","title":"Base Life Expectancy","default":0.0},"adjusted_life_expectancy":{"type":"number","title":"Adjusted Life Expectancy","default":0.0},"projection_years":{"type":"number","title":"Projection Years","default":0.0},"comorbidities":{"items":{"type":"string"},"type":"array","title":"Comorbidities"},"comorbidity_adjustments":{"additionalProperties":{"type":"number"},"type":"object","title":"Comorbidity Adjustments"},"annual_drug_total":{"type":"number","title":"Annual Drug Total","default":0.0},"annual_drug_total_with_generics":{"type":"number","title":"Annual Drug Total With Generics","default":0.0},"generic_substitution_savings":{"type":"number","title":"Generic Substitution Savings","default":0.0},"taper_savings":{"type":"number","title":"Taper Savings","default":0.0},"drug_count":{"type":"integer","title":"Drug Count","default":0},"annual_treatment_total":{"type":"number","title":"Annual Treatment Total","default":0.0},"gpci_factor":{"type":"number","title":"Gpci Factor","default":1.0},"treatment_count":{"type":"integer","title":"Treatment Count","default":0},"annual_surgery_equivalent":{"type":"number","title":"Annual Surgery Equivalent","default":0.0},"surgery_count":{"type":"integer","title":"Surgery Count","default":0},"annual_total":{"type":"number","title":"Annual Total","default":0.0},"seed_amount":{"type":"number","title":"Seed Amount","default":0.0},"total_msa_linear":{"type":"number","title":"Total Msa Linear","default":0.0},"total_msa_inflated":{"type":"number","title":"Total Msa Inflated","default":0.0},"total_msa_present_value":{"type":"number","title":"Total Msa Present Value","default":0.0},"total_msa":{"type":"number","title":"Total Msa","default":0.0},"inflation_rate":{"type":"number","title":"Inflation Rate","default":0.025},"discount_rate":{"type":"number","title":"Discount Rate","default":0.03},"cms_review_required":{"type":"boolean","title":"Cms Review Required","default":false},"cms_review_reason":{"type":"string","title":"Cms Review Reason","default":""},"worksheet":{"items":{"$ref":"#/components/schemas/AllocationWorksheetLineResponse"},"type":"array","title":"Worksheet"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"gaps":{"items":{"type":"string"},"type":"array","title":"Gaps"}},"type":"object","required":["claim_id"],"title":"CMSAllocationResponse"},"CMSFieldResponse":{"properties":{"field_name":{"type":"string","title":"Field Name"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"},"section":{"type":"string","title":"Section"},"required":{"type":"boolean","title":"Required"},"valid":{"type":"boolean","title":"Valid"},"validation_note":{"type":"string","title":"Validation Note","default":""}},"type":"object","required":["field_name","section","required","valid"],"title":"CMSFieldResponse"},"CMSFormDocumentResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"sections":{"items":{"$ref":"#/components/schemas/CMSFormSectionResponse"},"type":"array","title":"Sections"},"total_sections":{"type":"integer","title":"Total Sections"},"complete_sections":{"type":"integer","title":"Complete Sections"},"ready_for_submission":{"type":"boolean","title":"Ready For Submission"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id","sections","total_sections","complete_sections","ready_for_submission"],"title":"CMSFormDocumentResponse"},"CMSFormSectionResponse":{"properties":{"section_number":{"type":"integer","title":"Section Number"},"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"fields":{"additionalProperties":true,"type":"object","title":"Fields"},"complete":{"type":"boolean","title":"Complete"}},"type":"object","required":["section_number","title","content","complete"],"title":"CMSFormSectionResponse"},"CMSValidationResponse":{"properties":{"completeness_pct":{"type":"number","title":"Completeness Pct"},"missing_required":{"items":{"type":"string"},"type":"array","title":"Missing Required"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"ready_to_submit":{"type":"boolean","title":"Ready To Submit"}},"type":"object","required":["completeness_pct","missing_required","warnings","ready_to_submit"],"title":"CMSValidationResponse"},"ChangePasswordRequest":{"properties":{"current_password":{"type":"string","title":"Current Password"},"new_password":{"type":"string","minLength":12,"title":"New Password"}},"type":"object","required":["current_password","new_password"],"title":"ChangePasswordRequest"},"CheckoutRequest":{"properties":{"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"},"tier":{"type":"string","title":"Tier","description":"Pricing tier: initial, sc_appeal, hlr_appeal, bva_appeal, monitoring, msa_standard, msa_rush"},"email":{"type":"string","title":"Email","description":"Customer email"},"success_url":{"type":"string","title":"Success Url","description":"Redirect URL after successful payment"},"cancel_url":{"type":"string","title":"Cancel Url","description":"Redirect URL if payment is cancelled"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Extra Stripe session metadata (e.g. submission_id)"}},"type":"object","required":["tier","email","success_url","cancel_url"],"title":"CheckoutRequest"},"CheckoutResponse":{"properties":{"checkout_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Url"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"tier":{"type":"string","title":"Tier"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["checkout_url","tier"],"title":"CheckoutResponse"},"ChildTaskSummary":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"document_type":{"type":"string","title":"Document Type"},"status":{"type":"string","title":"Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","filename","document_type","status","error","created_at","completed_at"],"title":"ChildTaskSummary"},"ClaimDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_type":{"type":"string","title":"Claim Type"},"mechanism":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mechanism"},"context_fields":{"additionalProperties":true,"type":"object","title":"Context Fields","default":{}},"status":{"type":"string","title":"Status","default":"active"},"lifecycle_stage":{"type":"string","title":"Lifecycle Stage","default":"unfiled"},"disposition":{"type":"string","title":"Disposition","default":"open"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"person_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Name"},"documents":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Documents"},"merged_extraction":{"additionalProperties":true,"type":"object","title":"Merged Extraction"},"inference":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Inference"},"workflow":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Workflow"},"intake":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Intake"},"_override_metadata":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Override Metadata"},"schema_version":{"type":"integer","title":"Schema Version","default":1},"schema_current":{"type":"integer","title":"Schema Current","default":20},"schema_stale":{"type":"boolean","title":"Schema Stale","default":false},"inference_version":{"type":"integer","title":"Inference Version","default":1},"inference_current":{"type":"integer","title":"Inference Current","default":33},"inference_stale":{"type":"boolean","title":"Inference Stale","default":false},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_type","mechanism","documents","merged_extraction","inference","workflow","created_at","updated_at"],"title":"ClaimDetailResponse"},"ClaimSummaryResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_type":{"type":"string","title":"Claim Type"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"person_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Name"},"document_count":{"type":"integer","title":"Document Count"},"has_inference":{"type":"boolean","title":"Has Inference"},"overall_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Score","description":"Case strength score, 0.0-1.0 (not a percentage). Deterministic rating of how well the evidence supports each evaluation step. Use it to rank and triage; it is NOT a probability of approval and has not been calibrated against claim outcomes."},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"gap_counts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Gap Counts"},"status":{"type":"string","title":"Status","default":"active"},"lifecycle_stage":{"type":"string","title":"Lifecycle Stage","default":"unfiled"},"disposition":{"type":"string","title":"Disposition","default":"open"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"next_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Deadline"},"intake_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intake Tier"},"lead_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lead Score"},"completeness_p0_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completeness P0 Pct"},"missing_p0":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Missing P0"},"intake_recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intake Recommendation"},"flagged":{"type":"boolean","title":"Flagged","default":false},"snoozed_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snoozed Until"},"recent_contact":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recent Contact"},"submission_ready":{"type":"boolean","title":"Submission Ready","default":true},"submission_blockers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Submission Blockers"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_type","document_count","has_inference","created_at","updated_at"],"title":"ClaimSummaryResponse"},"ClaimType":{"type":"string","enum":["wc","ssdi","ssi","va","pi","ltd","std","feca","sdi","medicare","medicaid","hospice","lnc"],"title":"ClaimType","description":"Insurance/benefits claim types the platform supports."},"CompareGenerationsResponse":{"properties":{"generation_a":{"additionalProperties":true,"type":"object","title":"Generation A"},"generation_b":{"additionalProperties":true,"type":"object","title":"Generation B"},"differences":{"additionalProperties":true,"type":"object","title":"Differences"}},"type":"object","required":["generation_a","generation_b","differences"],"title":"CompareGenerationsResponse"},"ComparisonItemResponse":{"properties":{"category":{"type":"string","title":"Category"},"role_a":{"type":"string","title":"Role A"},"role_b":{"type":"string","title":"Role B"},"value_a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value A"},"value_b":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value B"},"status":{"type":"string","title":"Status"},"significance":{"type":"string","title":"Significance","default":"medium"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["category","role_a","role_b","status"],"title":"ComparisonItemResponse"},"ComparisonResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"role_a":{"type":"string","title":"Role A"},"role_b":{"type":"string","title":"Role B"},"comparisons":{"items":{"$ref":"#/components/schemas/ComparisonItemResponse"},"type":"array","title":"Comparisons"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["claim_id","role_a","role_b","comparisons","total"],"title":"ComparisonResponse"},"CompletenessResponse":{"properties":{"score":{"type":"number","title":"Score"},"sufficient_to_proceed":{"type":"boolean","title":"Sufficient To Proceed"},"providers_total":{"type":"integer","title":"Providers Total"},"providers_received":{"type":"integer","title":"Providers Received"},"missing_required":{"items":{"type":"string"},"type":"array","title":"Missing Required"},"checklist":{"additionalProperties":{"type":"string"},"type":"object","title":"Checklist"}},"type":"object","required":["score","sufficient_to_proceed","providers_total","providers_received","missing_required","checklist"],"title":"CompletenessResponse"},"ConditionalPaymentRequest":{"properties":{"medicare_claim_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medicare Claim Number"},"conditional_payment_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conditional Payment Amount"},"recovery_demand_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recovery Demand Amount"},"recovery_demand_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Demand Date"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"ConditionalPaymentRequest"},"ConditionalPaymentResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"medicare_claim_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medicare Claim Number"},"conditional_payment_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conditional Payment Amount"},"recovery_demand_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recovery Demand Amount"},"recovery_demand_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Demand Date"},"msprp_case_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Msprp Case Id"},"msprp_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Msprp Status"},"offset_from_settlement":{"type":"boolean","title":"Offset From Settlement","default":false},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["id","claim_id"],"title":"ConditionalPaymentResponse"},"ConflictDict":{"properties":{"field_path":{"type":"string","title":"Field Path"},"values":{"items":{},"type":"array","title":"Values"},"sources":{"items":{"$ref":"#/components/schemas/SourceAttributionDict"},"type":"array","title":"Sources"},"resolution":{"type":"string","title":"Resolution"},"chosen_value":{"title":"Chosen Value"},"notes":{"type":"string","title":"Notes"}},"type":"object","required":["field_path","values","sources","resolution","chosen_value","notes"],"title":"ConflictDict","description":"Conflict detected during multi-source merge."},"ConflictsListResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"total_conflicts":{"type":"integer","title":"Total Conflicts"},"conflicts":{"items":{"$ref":"#/components/schemas/ConflictDict"},"type":"array","title":"Conflicts"}},"type":"object","required":["claim_id","total_conflicts","conflicts"],"title":"ConflictsListResponse","description":"List of all conflicts for a claim."},"ConsentCreateRequest":{"properties":{"consent_type":{"type":"string","title":"Consent Type"},"granted":{"type":"boolean","title":"Granted","default":true},"obtained_via":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Obtained Via"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"granted_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Granted By"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["consent_type"],"title":"ConsentCreateRequest"},"ConsentListResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"records":{"items":{"$ref":"#/components/schemas/ConsentRecord"},"type":"array","title":"Records"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["claim_id","records","total"],"title":"ConsentListResponse"},"ConsentRecord":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"consent_type":{"type":"string","title":"Consent Type"},"granted":{"type":"boolean","title":"Granted","default":true},"granted_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Granted By"},"granted_at":{"type":"string","title":"Granted At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","claim_id","consent_type","granted_at"],"title":"ConsentRecord"},"ContractCreateRequest":{"properties":{"contract_type":{"type":"string","title":"Contract Type","default":"fee_agreement"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"terms":{"additionalProperties":true,"type":"object","title":"Terms"},"fee_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fee Percentage"},"fee_cap":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fee Cap"},"custom_clauses":{"items":{"type":"string"},"type":"array","title":"Custom Clauses"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"ContractCreateRequest"},"ContractResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"contract_type":{"type":"string","title":"Contract Type"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body","default":""},"status":{"type":"string","title":"Status","default":"draft"},"signatories":{"items":{"$ref":"#/components/schemas/ContractSignatory"},"type":"array","title":"Signatories"},"terms":{"additionalProperties":true,"type":"object","title":"Terms"},"fee_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fee Percentage"},"fee_cap":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fee Cap"},"custom_clauses":{"items":{"type":"string"},"type":"array","title":"Custom Clauses"},"sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sent At"},"signed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"signer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signer Name"},"signer_ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signer Ip"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_id","contract_type","title","created_at","updated_at"],"title":"ContractResponse"},"ContractSignRequest":{"properties":{"signer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signer Name"},"signer_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signer Email"},"signature_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature Data"},"agreement_accepted":{"type":"boolean","title":"Agreement Accepted","default":true}},"type":"object","title":"ContractSignRequest"},"ContractSignatory":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"signed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed At"}},"type":"object","title":"ContractSignatory"},"ConversationDetail":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"channel":{"type":"string","title":"Channel"},"direction":{"type":"string","title":"Direction"},"status":{"type":"string","title":"Status"},"script_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Id"},"script_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Name"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"phone_number_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number From"},"phone_number_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number To"},"email_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email From"},"email_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email To"},"email_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Subject"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"},"script_state":{"additionalProperties":true,"type":"object","title":"Script State"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"escalated_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalated To"},"escalation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Reason"},"recording_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Url"},"messages":{"items":{"$ref":"#/components/schemas/MessageResponse"},"type":"array","title":"Messages"},"actions":{"items":{"$ref":"#/components/schemas/ActionResponse"},"type":"array","title":"Actions"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_id","channel","direction","status","created_at","updated_at"],"title":"ConversationDetail"},"ConversationSummary":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"channel":{"type":"string","title":"Channel"},"direction":{"type":"string","title":"Direction"},"status":{"type":"string","title":"Status"},"script_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Name"},"phone_number_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number From"},"phone_number_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number To"},"email_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email From"},"email_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email To"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","claim_id","channel","direction","status","created_at"],"title":"ConversationSummary"},"ConversionOption":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"}},"type":"object","required":["type","title","description"],"title":"ConversionOption","description":"A conversion option for the user to choose."},"ConversionOptionsResponse":{"properties":{"trial_org_name":{"type":"string","title":"Trial Org Name"},"claim_count":{"type":"integer","title":"Claim Count"},"is_trial":{"type":"boolean","title":"Is Trial"},"can_convert":{"type":"boolean","title":"Can Convert"},"options":{"items":{"$ref":"#/components/schemas/ConversionOption"},"type":"array","title":"Options"}},"type":"object","required":["trial_org_name","claim_count","is_trial","can_convert","options"],"title":"ConversionOptionsResponse","description":"Response showing user's trial conversion options."},"ConversionRequest":{"properties":{"conversion_type":{"type":"string","title":"Conversion Type","description":"Either 'keep_data' or 'start_fresh'"},"org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Name","description":"New org name (for keep_data) or required for start_fresh"},"org_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Slug","description":"New org slug (required for start_fresh)"}},"type":"object","required":["conversion_type"],"title":"ConversionRequest","description":"Request to convert trial to production."},"ConversionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"org_id":{"type":"string","title":"Org Id"},"conversion_type":{"type":"string","title":"Conversion Type"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","org_id","conversion_type","message"],"title":"ConversionResponse","description":"Response after successful conversion."},"CostDisputeResponse":{"properties":{"item_description":{"type":"string","title":"Item Description"},"projected_cost":{"type":"number","title":"Projected Cost"},"dispute_basis":{"type":"string","title":"Dispute Basis"},"suggested_alternative":{"type":"string","title":"Suggested Alternative","default":""},"potential_savings":{"type":"number","title":"Potential Savings","default":0.0},"category":{"type":"string","title":"Category","default":""}},"type":"object","required":["item_description","projected_cost","dispute_basis"],"title":"CostDisputeResponse"},"CostDisputesResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"disputes":{"items":{"$ref":"#/components/schemas/CostDisputeResponse"},"type":"array","title":"Disputes"},"total":{"type":"integer","title":"Total"},"total_potential_savings":{"type":"number","title":"Total Potential Savings","default":0.0}},"type":"object","required":["claim_id","disputes","total"],"title":"CostDisputesResponse"},"CreateAnalyticsEventRequest":{"properties":{"event_name":{"type":"string","minLength":1,"title":"Event Name"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"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"}},"type":"object","required":["event_name"],"title":"CreateAnalyticsEventRequest"},"CreateClaimRequest":{"properties":{"claim_type":{"$ref":"#/components/schemas/ClaimType","description":"Claim type"},"document_type":{"$ref":"#/components/schemas/DocumentType","description":"Default document type for uploads","default":"medical_record"},"mechanism":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}],"description":"Mechanism type if applicable"},"context_fields":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Context Fields","description":"Claim-type-specific context fields"}},"type":"object","required":["claim_type"],"title":"CreateClaimRequest"},"CreateConversationRequest":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"script_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Id"},"channel":{"type":"string","pattern":"^(voice|sms|email|web_chat)$","title":"Channel"},"direction":{"type":"string","pattern":"^(inbound|outbound)$","title":"Direction","default":"outbound"},"phone_number_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number To"},"email_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email To"},"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"},"task_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Context"}},"type":"object","required":["claim_id","channel"],"title":"CreateConversationRequest"},"CreateFormInstanceRequest":{"properties":{"label":{"type":"string","title":"Label","description":"Human-readable label, e.g. 'Initial Filing'","default":""}},"type":"object","title":"CreateFormInstanceRequest"},"CreateGuestInviteRequest":{"properties":{"invitee_email":{"type":"string","title":"Invitee Email"},"invitee_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invitee Label"},"claim_ids":{"items":{"type":"string"},"type":"array","title":"Claim Ids"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"}},"type":"object","required":["invitee_email","claim_ids"],"title":"CreateGuestInviteRequest","description":"Request to create a guest invite."},"CreateGuestSessionRequest":{"properties":{"email":{"type":"string","title":"Email"},"source":{"type":"string","title":"Source","default":"self_service"},"vertical":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vertical"}},"type":"object","required":["email"],"title":"CreateGuestSessionRequest","description":"Request to create a guest session."},"CreateInviteRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Hint"},"assigned_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Assigned Personas"},"claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Claim Types"},"locked":{"type":"boolean","title":"Locked","default":false},"max_uses":{"type":"integer","title":"Max Uses","default":1},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"type":"object","title":"CreateInviteRequest"},"CreateLeadRequest":{"properties":{"email":{"type":"string","minLength":3,"title":"Email"},"name":{"type":"string","minLength":1,"title":"Name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"role":{"type":"string","minLength":1,"title":"Role"},"product_interest":{"type":"string","minLength":1,"title":"Product Interest"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"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"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"channel":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Channel"},"agent_name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Agent Name"},"landing_referrer":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Landing Referrer"},"utm_term":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Term"},"gclid":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Gclid"},"gbraid":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Gbraid"},"wbraid":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Wbraid"}},"type":"object","required":["email","name","role","product_interest"],"title":"CreateLeadRequest"},"CreateOrgRequest":{"properties":{"name":{"type":"string","minLength":1,"title":"Name"},"slug":{"type":"string","minLength":1,"pattern":"^[a-z0-9\\-]+$","title":"Slug"},"plan":{"type":"string","title":"Plan","default":"pilot"}},"type":"object","required":["name","slug"],"title":"CreateOrgRequest"},"CreateOrgUserRequest":{"properties":{"email":{"type":"string","minLength":3,"title":"Email"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"name":{"type":"string","minLength":1,"title":"Name"},"role":{"type":"string","title":"Role","default":"member"}},"type":"object","required":["email","name"],"title":"CreateOrgUserRequest"},"CreateRecordRequestBody":{"properties":{"provider_name":{"type":"string","title":"Provider Name"},"record_type":{"type":"string","title":"Record Type","default":"medical_records"},"provider_npi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Npi"},"provider_facility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Facility"},"provider_fax":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Fax"},"provider_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Phone"},"provider_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Email"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["provider_name"],"title":"CreateRecordRequestBody"},"CreateScriptRequest":{"properties":{"name":{"type":"string","minLength":1,"title":"Name"},"slug":{"type":"string","minLength":1,"pattern":"^[a-z0-9\\-]+$","title":"Slug"},"script_type":{"type":"string","pattern":"^(outbound_call|inbound_call|sms_campaign|sms_response|email_campaign|email_response)$","title":"Script Type"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"claim_types":{"items":{"type":"string"},"type":"array","title":"Claim Types"},"script_body":{"type":"string","minLength":1,"title":"Script Body"}},"type":"object","required":["name","slug","script_type","script_body"],"title":"CreateScriptRequest"},"DeadlineRequest":{"properties":{"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"due_date":{"type":"string","title":"Due Date"},"deadline_type":{"type":"string","title":"Deadline Type","default":"filing"},"priority":{"type":"string","title":"Priority","default":"medium"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"reminder_days":{"items":{"type":"integer"},"type":"array","title":"Reminder Days"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title","due_date"],"title":"DeadlineRequest"},"DeadlineResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"title":{"type":"string","title":"Title","default":""},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"due_date":{"type":"string","title":"Due Date"},"deadline_type":{"type":"string","title":"Deadline Type"},"priority":{"type":"string","title":"Priority","default":"medium"},"status":{"type":"string","title":"Status","default":"pending"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"reminder_days":{"items":{"type":"integer"},"type":"array","title":"Reminder Days","default":[]},"source_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Stage"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_id","due_date","deadline_type","created_at","updated_at"],"title":"DeadlineResponse"},"DeepHealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"checks":{"additionalProperties":{"type":"string"},"type":"object","title":"Checks"}},"type":"object","required":["status","version","checks"],"title":"DeepHealthResponse","description":"Deep health check response with component-level checks."},"DeliverFormRequest":{"properties":{"delivery_method":{"type":"string","title":"Delivery Method","description":"How the form was delivered: download, transmit, fax"},"delivery_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Reference","description":"Confirmation number or reference"}},"type":"object","required":["delivery_method"],"title":"DeliverFormRequest"},"DeltaResponse":{"properties":{"added_fields":{"additionalProperties":true,"type":"object","title":"Added Fields"},"removed_fields":{"additionalProperties":true,"type":"object","title":"Removed Fields"},"changed_count":{"type":"integer","title":"Changed Count","default":0},"unchanged_count":{"type":"integer","title":"Unchanged Count","default":0},"summary":{"type":"string","title":"Summary","default":""}},"type":"object","title":"DeltaResponse","description":"Structured diff between two extraction outputs."},"DemoAnalyticsResponse":{"properties":{"total_invites":{"type":"integer","title":"Total Invites"},"active_invites":{"type":"integer","title":"Active Invites"},"total_users":{"type":"integer","title":"Total Users"},"total_events":{"type":"integer","title":"Total Events"},"events_by_type":{"additionalProperties":{"type":"integer"},"type":"object","title":"Events By Type"},"recent_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Recent Events"}},"type":"object","required":["total_invites","active_invites","total_users","total_events","events_by_type","recent_events"],"title":"DemoAnalyticsResponse"},"DemoAuthRequest":{"properties":{"token":{"type":"string","title":"Token"},"email_or_phone":{"type":"string","title":"Email Or Phone"},"persona_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Override"}},"type":"object","required":["token","email_or_phone"],"title":"DemoAuthRequest"},"DemoAuthResponse":{"properties":{"redirect":{"type":"string","title":"Redirect"},"user":{"additionalProperties":true,"type":"object","title":"User"},"persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Hint"}},"type":"object","required":["redirect","user"],"title":"DemoAuthResponse"},"DemoEventRequest":{"properties":{"event_name":{"type":"string","title":"Event Name"},"properties":{"additionalProperties":true,"type":"object","title":"Properties","default":{}},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"}},"type":"object","required":["event_name"],"title":"DemoEventRequest"},"DemoInviteInfoResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Hint"},"assigned_personas":{"items":{"type":"string"},"type":"array","title":"Assigned Personas"},"claim_types":{"items":{"type":"string"},"type":"array","title":"Claim Types"},"locked":{"type":"boolean","title":"Locked","default":false},"is_valid":{"type":"boolean","title":"Is Valid"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["assigned_personas","claim_types","is_valid"],"title":"DemoInviteInfoResponse"},"DemoUserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"},"invite_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Id"},"created_at":{"type":"string","title":"Created At"},"last_event_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Event At"}},"type":"object","required":["id","email","name","created_at"],"title":"DemoUserResponse"},"DisputeItemResponse":{"properties":{"issue":{"type":"string","title":"Issue"},"claimant_position":{"type":"string","title":"Claimant Position","default":""},"defense_position":{"type":"string","title":"Defense Position","default":""},"status":{"type":"string","title":"Status","default":"open"},"evidence_balance":{"type":"string","title":"Evidence Balance","default":"neutral"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["issue"],"title":"DisputeItemResponse"},"DisputeMatrixResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"items":{"items":{"$ref":"#/components/schemas/DisputeItemResponse"},"type":"array","title":"Items"},"open_count":{"type":"integer","title":"Open Count","default":0},"resolved_count":{"type":"integer","title":"Resolved Count","default":0}},"type":"object","required":["claim_id","items"],"title":"DisputeMatrixResponse"},"DocumentResult":{"properties":{"filename":{"type":"string","title":"Filename"},"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Count"}},"type":"object","required":["filename","success"],"title":"DocumentResult","description":"Extraction result for a single document within a bulk operation."},"DocumentType":{"type":"string","enum":["medical_record","ime_report","msa_report","first_report_of_injury","wage_statement","fce","function_report","c_and_p_exam","dd_214","police_report","determination_letter","policy_document","attending_physician_statement","demand_letter","buddy_statement","job_description","billing_record","work_history","earnings_record","service_treatment_record","employer_statement","settlement_document","consultative_exam"],"title":"DocumentType","description":"All document types that flow through the platform."},"EmailExtractionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"email_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Subject"},"email_sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Sender"},"email_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Date"},"body_text_length":{"type":"integer","title":"Body Text Length"},"documents":{"items":{"$ref":"#/components/schemas/DocumentResult"},"type":"array","title":"Documents"},"total_attachments":{"type":"integer","title":"Total Attachments"},"successful":{"type":"integer","title":"Successful"},"failed":{"type":"integer","title":"Failed"},"skipped_attachments":{"items":{"type":"string"},"type":"array","title":"Skipped Attachments"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"duration_seconds":{"type":"number","title":"Duration Seconds"}},"type":"object","required":["success","body_text_length","documents","total_attachments","successful","failed","duration_seconds"],"title":"EmailExtractionResponse","description":"Response for email ingestion."},"EscalationResolveRequest":{"properties":{"resolution":{"type":"string","title":"Resolution"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"resolved_by":{"type":"string","title":"Resolved By","default":"operator"}},"type":"object","required":["resolution"],"title":"EscalationResolveRequest","description":"Request to resolve an escalation ticket."},"ExtractionMetadata":{"properties":{"model":{"type":"string","title":"Model"},"claim_type":{"anyOf":[{"$ref":"#/components/schemas/ClaimType"},{"type":"null"}]},"document_type":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}]},"mechanism":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}]},"duration_seconds":{"type":"number","title":"Duration Seconds"},"content_length":{"type":"integer","title":"Content Length"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Count"},"ocr_pages":{"items":{"type":"integer"},"type":"array","title":"Ocr Pages","default":[]},"ocr_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ocr Confidence"},"record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Id"},"prior_record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Record Id"},"has_delta":{"type":"boolean","title":"Has Delta","default":false}},"type":"object","required":["model","duration_seconds","content_length"],"title":"ExtractionMetadata","description":"Metadata about an extraction operation."},"ExtractionRequest":{"properties":{"content":{"type":"string","minLength":50,"title":"Content","description":"Raw text content of the medical record"},"claim_type":{"anyOf":[{"$ref":"#/components/schemas/ClaimType"},{"type":"null"}],"description":"Claim type: wc, ssdi, ssi, va, pi, ltd, std, feca, sdi"},"document_type":{"anyOf":[{"$ref":"#/components/schemas/DocumentType"},{"type":"null"}],"description":"Document type: medical_record, ime_report, etc."},"mechanism":{"anyOf":[{"$ref":"#/components/schemas/MechanismType"},{"type":"null"}],"description":"Mechanism: ime, msa, fce"}},"type":"object","required":["content"],"title":"ExtractionRequest","description":"Request body for text extraction."},"ExtractionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","default":[]},"metadata":{"$ref":"#/components/schemas/ExtractionMetadata"}},"type":"object","required":["success","data","metadata"],"title":"ExtractionResponse","description":"Successful extraction response."},"FieldHistoryEntry":{"properties":{"id":{"type":"string","title":"Id"},"field_path":{"type":"string","title":"Field Path"},"old_value":{"title":"Old Value"},"new_value":{"title":"New Value"},"change_type":{"type":"string","title":"Change Type"},"source_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Document Id"},"source_override_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Override Id"},"actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Id"},"actor_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Type"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","field_path","change_type","created_at"],"title":"FieldHistoryEntry"},"FieldProvenanceResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"field_path":{"type":"string","title":"Field Path"},"current_value":{"title":"Current Value"},"sources":{"items":{"$ref":"#/components/schemas/SourceAttributionDict"},"type":"array","title":"Sources"},"conflict":{"anyOf":[{"$ref":"#/components/schemas/ConflictDict"},{"type":"null"}]},"change_history":{"items":{},"type":"array","title":"Change History"}},"type":"object","required":["claim_id","field_path","current_value","sources","change_history"],"title":"FieldProvenanceResponse","description":"Provenance for a specific field."},"FinancialReviewResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"meets_income_limit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Meets Income Limit"},"meets_asset_limit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Meets Asset Limit"},"countable_income":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Countable Income"},"countable_assets":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Countable Assets"},"estimated_benefit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Benefit"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"FinancialReviewResponse"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"FormFieldResponse":{"properties":{"field_name":{"type":"string","title":"Field Name"},"field_label":{"type":"string","title":"Field Label"},"value":{"title":"Value"},"source":{"type":"string","title":"Source","default":"auto"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"needs_review":{"type":"boolean","title":"Needs Review","default":false}},"type":"object","required":["field_name","field_label"],"title":"FormFieldResponse"},"FormGenerateRequest":{"properties":{"overrides":{"additionalProperties":true,"type":"object","title":"Overrides","description":"Field overrides to apply on top of auto-populated values"},"include_incomplete":{"type":"boolean","title":"Include Incomplete","description":"Include fields that could not be auto-populated","default":false}},"type":"object","title":"FormGenerateRequest"},"FormGenerateResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"form_type":{"type":"string","title":"Form Type"},"form_title":{"type":"string","title":"Form Title"},"fields":{"additionalProperties":true,"type":"object","title":"Fields"},"fields_populated":{"type":"integer","title":"Fields Populated"},"fields_total":{"type":"integer","title":"Fields Total"},"fields_needing_review":{"items":{"type":"string"},"type":"array","title":"Fields Needing Review"},"field_details":{"items":{"$ref":"#/components/schemas/FormFieldResponse"},"type":"array","title":"Field Details"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["id","claim_id","form_type","form_title","fields","fields_populated","fields_total","fields_needing_review","generated_at"],"title":"FormGenerateResponse"},"FormGenerationResponse":{"properties":{"id":{"type":"string","title":"Id"},"form_instance_id":{"type":"string","title":"Form Instance Id"},"generation_number":{"type":"integer","title":"Generation Number"},"purpose":{"type":"string","title":"Purpose"},"field_snapshot":{"additionalProperties":true,"type":"object","title":"Field Snapshot"},"fields_populated":{"type":"integer","title":"Fields Populated"},"fields_total":{"type":"integer","title":"Fields Total"},"fields_needing_review":{"items":{"type":"string"},"type":"array","title":"Fields Needing Review"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["id","form_instance_id","generation_number","purpose","field_snapshot","fields_populated","fields_total","fields_needing_review","generated_at"],"title":"FormGenerationResponse"},"FormInstanceResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"form_type":{"type":"string","title":"Form Type"},"label":{"type":"string","title":"Label"},"instance_number":{"type":"integer","title":"Instance Number"},"state":{"type":"string","title":"State"},"locked_generation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locked Generation Id"},"locked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locked At"},"locked_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locked By"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"delivered_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered By"},"delivery_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Method"},"delivery_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Reference"},"parent_instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Instance Id"},"amendment_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Amendment Reason"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_id","form_type","label","instance_number","state","created_at","updated_at"],"title":"FormInstanceResponse"},"GenerateFormRequest":{"properties":{"purpose":{"type":"string","title":"Purpose","description":"Purpose: preview, download, transmit, lock_snapshot","default":"preview"}},"type":"object","title":"GenerateFormRequest"},"GuestInviteResponse":{"properties":{"invite_id":{"type":"string","title":"Invite Id"},"invite_link":{"type":"string","title":"Invite Link"},"invitee_email":{"type":"string","title":"Invitee Email"},"claim_ids":{"items":{"type":"string"},"type":"array","title":"Claim Ids"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"expires_at":{"type":"string","title":"Expires At"},"email_sent":{"type":"boolean","title":"Email Sent","default":true}},"type":"object","required":["invite_id","invite_link","invitee_email","claim_ids","expires_at"],"title":"GuestInviteResponse","description":"Response for guest invite creation."},"GuestSessionResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"user_id":{"type":"string","title":"User Id"},"session_token":{"type":"string","title":"Session Token"},"is_new":{"type":"boolean","title":"Is New"}},"type":"object","required":["org_id","user_id","session_token","is_new"],"title":"GuestSessionResponse","description":"Response containing guest session details."},"HIPAAAuthCreateRequest":{"properties":{"provider_name":{"type":"string","title":"Provider Name"},"provider_npi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Npi"},"provider_facility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Facility"},"provider_fax":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Fax"},"provider_address":{"additionalProperties":true,"type":"object","title":"Provider Address"},"validity_months":{"type":"integer","title":"Validity Months","default":12}},"type":"object","required":["provider_name"],"title":"HIPAAAuthCreateRequest"},"HIPAAAuthResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"provider_name":{"type":"string","title":"Provider Name"},"provider_npi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Npi"},"provider_facility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Facility"},"status":{"type":"string","title":"Status"},"signature_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature Method"},"signed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed At"},"signed_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed By Name"},"effective_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effective Date"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","claim_id","provider_name","status","created_at"],"title":"HIPAAAuthResponse"},"HIPAAAuthSignRequest":{"properties":{"signed_by_name":{"type":"string","title":"Signed By Name"},"signature_method":{"type":"string","title":"Signature Method","default":"portal"}},"type":"object","required":["signed_by_name"],"title":"HIPAAAuthSignRequest"},"HIPAAStatusSummary":{"properties":{"total":{"type":"integer","title":"Total"},"draft":{"type":"integer","title":"Draft"},"signed":{"type":"integer","title":"Signed"},"active":{"type":"integer","title":"Active"},"expired":{"type":"integer","title":"Expired"},"revoked":{"type":"integer","title":"Revoked"}},"type":"object","required":["total","draft","signed","active","expired","revoked"],"title":"HIPAAStatusSummary"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"extractor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extractor"}},"type":"object","required":["status","version"],"title":"HealthResponse","description":"Health check response."},"HoldRequest":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"HoldRequest"},"HospiceADRRequest":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"adr_letter":{"$ref":"#/components/schemas/ADRLetter"},"use_llm":{"type":"boolean","title":"Use Llm","default":true}},"type":"object","required":["claim_id","adr_letter"],"title":"HospiceADRRequest"},"IMESchedulingRequest":{"properties":{"exam_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exam Date"},"exam_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exam Time"},"examiner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Examiner Name"},"examiner_specialty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Examiner Specialty"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"location_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Address"},"scheduling_company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduling Company"},"status":{"type":"string","title":"Status","default":"pending"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"external_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Reference Id"}},"type":"object","title":"IMESchedulingRequest"},"IMESchedulingResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"scheduling":{"anyOf":[{"$ref":"#/components/schemas/IMESchedulingRequest"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["claim_id"],"title":"IMESchedulingResponse"},"IROExtractionResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"findings":{"items":{"$ref":"#/components/schemas/IROFindingResponse"},"type":"array","title":"Findings"},"overall_disposition":{"type":"string","title":"Overall Disposition"},"adjustment_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Adjustment Amount"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["claim_id","findings","overall_disposition"],"title":"IROExtractionResponse"},"IROFindingResponse":{"properties":{"category":{"type":"string","title":"Category"},"finding":{"type":"string","title":"Finding"},"recommendation":{"type":"string","title":"Recommendation"},"agrees_with_msa":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Agrees With Msa"}},"type":"object","required":["category","finding","recommendation"],"title":"IROFindingResponse"},"ImpairmentBreakdownResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"body_parts":{"items":{"$ref":"#/components/schemas/BodyPartImpairmentResponse"},"type":"array","title":"Body Parts"},"total_reported_wpi":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Reported Wpi"},"combined_wpi_range_low":{"type":"integer","title":"Combined Wpi Range Low","default":0},"combined_wpi_range_high":{"type":"integer","title":"Combined Wpi Range High","default":0},"ca_pd_rating":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ca Pd Rating"},"state":{"type":"string","title":"State","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"ImpairmentBreakdownResponse"},"IntakeActionResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"status":{"type":"string","title":"Status"},"intake_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intake Tier"},"flagged":{"type":"boolean","title":"Flagged","default":false},"snoozed_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snoozed Until"}},"type":"object","required":["claim_id","status"],"title":"IntakeActionResponse"},"IntakeCarrierAnalyticsResponse":{"properties":{"intake_volume":{"type":"integer","title":"Intake Volume","default":0},"scored_count":{"type":"integer","title":"Scored Count","default":0},"scored_rate_pct":{"type":"number","title":"Scored Rate Pct","default":0.0},"avg_win_signal_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Win Signal Pct","description":"Average case strength score of the scored intakes, on a 0-100 scale. Not a probability of winning (the name is historical); show it as N/100."},"strong_cases":{"type":"integer","title":"Strong Cases","default":0},"tier_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Tier Breakdown"},"promoted_count":{"type":"integer","title":"Promoted Count","default":0},"conversations_completed":{"type":"integer","title":"Conversations Completed","default":0},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["generated_at"],"title":"IntakeCarrierAnalyticsResponse","description":"SSDI intake KPIs for carrier / partner dashboards (Claimify)."},"IntakeCompletenessResponse":{"properties":{"claim_type":{"type":"string","title":"Claim Type"},"p0":{"additionalProperties":true,"type":"object","title":"P0"},"p1":{"additionalProperties":true,"type":"object","title":"P1"},"p2":{"additionalProperties":true,"type":"object","title":"P2"},"overall_pct":{"type":"number","title":"Overall Pct"},"p0_complete":{"type":"boolean","title":"P0 Complete"},"missing_p0":{"items":{"type":"string"},"type":"array","title":"Missing P0"},"missing_p1":{"items":{"type":"string"},"type":"array","title":"Missing P1"},"derived_fields":{"additionalProperties":true,"type":"object","title":"Derived Fields"}},"type":"object","required":["claim_type","p0","p1","p2","overall_pct","p0_complete","missing_p0","missing_p1"],"title":"IntakeCompletenessResponse","description":"Intake completeness score response."},"IntakeUpdateRequest":{"properties":{"claim_type":{"type":"string","title":"Claim Type"},"fields":{"additionalProperties":true,"type":"object","title":"Fields"}},"type":"object","required":["claim_type","fields"],"title":"IntakeUpdateRequest","description":"Request body for intake field updates with claim type context."},"InviteResponse":{"properties":{"id":{"type":"string","title":"Id"},"token":{"type":"string","title":"Token"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Hint"},"assigned_personas":{"items":{"type":"string"},"type":"array","title":"Assigned Personas"},"claim_types":{"items":{"type":"string"},"type":"array","title":"Claim Types"},"locked":{"type":"boolean","title":"Locked","default":false},"max_uses":{"type":"integer","title":"Max Uses"},"use_count":{"type":"integer","title":"Use Count"},"is_active":{"type":"boolean","title":"Is Active"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","title":"Created At"},"url":{"type":"string","title":"Url"}},"type":"object","required":["id","token","assigned_personas","claim_types","max_uses","use_count","is_active","created_at","url"],"title":"InviteResponse"},"InviteUserRequest":{"properties":{"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"}},"type":"object","required":["email","role"],"title":"InviteUserRequest","description":"Request to invite a user to an organization."},"InviteUserResponse":{"properties":{"type":{"type":"string","title":"Type"},"id":{"type":"string","title":"Id"}},"type":"object","required":["type","id"],"title":"InviteUserResponse","description":"Response after inviting a user."},"InvocationsPage":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"InvocationsPage"},"InvokeRequest":{"properties":{"input":{"title":"Input","description":"The capability's input (see its input_schema)."},"dry_run":{"type":"boolean","title":"Dry Run","default":false},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent","description":"Why; required with confirmed=true for high/critical blast."},"confirmed":{"type":"boolean","title":"Confirmed","default":false}},"type":"object","title":"InvokeRequest"},"LeaveMembershipResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"},"switched_to_org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Switched To Org Id"},"switched_to_org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Switched To Org Name"}},"type":"object","required":["ok"],"title":"LeaveMembershipResponse","description":"Response after leaving an organization."},"LitigationRiskFactorResponse":{"properties":{"factor":{"type":"string","title":"Factor"},"impact":{"type":"string","title":"Impact","default":"neutral"},"description":{"type":"string","title":"Description","default":""},"weight":{"type":"number","title":"Weight","default":1.0}},"type":"object","required":["factor"],"title":"LitigationRiskFactorResponse"},"LitigationRiskResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"risk_score":{"type":"number","title":"Risk Score","default":0.0},"risk_level":{"type":"string","title":"Risk Level","default":"moderate"},"key_vulnerabilities":{"items":{"type":"string"},"type":"array","title":"Key Vulnerabilities"},"risk_factors":{"items":{"$ref":"#/components/schemas/LitigationRiskFactorResponse"},"type":"array","title":"Risk Factors"},"estimated_trial_cost_low":{"type":"number","title":"Estimated Trial Cost Low","default":0.0},"estimated_trial_cost_high":{"type":"number","title":"Estimated Trial Cost High","default":0.0},"settlement_recommendation":{"type":"string","title":"Settlement Recommendation","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"LitigationRiskResponse"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"MMIStatusResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"status":{"type":"string","title":"Status","default":"unknown"},"mmi_date":{"type":"string","title":"Mmi Date","default":""},"declaring_provider":{"type":"string","title":"Declaring Provider","default":""},"is_disputed":{"type":"boolean","title":"Is Disputed","default":false},"disputing_party":{"type":"string","title":"Disputing Party","default":""},"treatment_post_mmi":{"items":{"type":"string"},"type":"array","title":"Treatment Post Mmi"},"time_since_injury":{"type":"string","title":"Time Since Injury","default":""},"state_mmi_presumption":{"type":"string","title":"State Mmi Presumption","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"MMIStatusResponse"},"MSABlocker":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["type","description"],"title":"MSABlocker"},"MSAProgressResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"sla_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sla Deadline"},"sla_remaining_ms":{"type":"integer","title":"Sla Remaining Ms","default":0},"sla_severity":{"type":"string","title":"Sla Severity","default":"ok"},"current_stage":{"type":"string","title":"Current Stage","default":"msa_intake"},"completeness_score":{"type":"number","title":"Completeness Score","default":0.0},"stages":{"items":{"$ref":"#/components/schemas/MSAProgressStage"},"type":"array","title":"Stages","default":[]},"blockers":{"items":{"$ref":"#/components/schemas/MSABlocker"},"type":"array","title":"Blockers","default":[]},"qa_decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qa Decision"},"qa_reviewer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qa Reviewer Id"}},"type":"object","required":["claim_id"],"title":"MSAProgressResponse"},"MSAProgressStage":{"properties":{"stage":{"type":"string","title":"Stage"},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["stage","status"],"title":"MSAProgressStage"},"MSAQueueItem":{"properties":{"id":{"type":"string","title":"Id"},"claim_type":{"type":"string","title":"Claim Type","default":"msa"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"sla_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sla Deadline"},"sla_remaining_ms":{"type":"integer","title":"Sla Remaining Ms","default":0},"sla_severity":{"type":"string","title":"Sla Severity","default":"ok"},"workflow_stage":{"type":"string","title":"Workflow Stage","default":"msa_intake"},"blockers":{"items":{"$ref":"#/components/schemas/MSABlocker"},"type":"array","title":"Blockers","default":[]},"assigned_analyst":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Analyst"},"assigned_reviewer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned Reviewer"},"completeness_score":{"type":"number","title":"Completeness Score","default":0.0},"record_checklist_complete":{"type":"boolean","title":"Record Checklist Complete","default":false},"reports_generated":{"items":{"type":"string"},"type":"array","title":"Reports Generated","default":[]},"overall_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Score"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id"],"title":"MSAQueueItem"},"MagicLinkRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"MagicLinkRequest"},"MarkReceivedBody":{"properties":{"document_id":{"type":"string","title":"Document Id"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Count"},"date_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Range"}},"type":"object","required":["document_id"],"title":"MarkReceivedBody"},"MechanismType":{"type":"string","enum":["ime","msa","fce"],"title":"MechanismType","description":"Cross-cutting evaluation/settlement mechanisms that serve multiple claim types."},"MembershipResponse":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"org_slug":{"type":"string","title":"Org Slug"},"role":{"type":"string","title":"Role"},"accepted_at":{"type":"string","title":"Accepted At"},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false}},"type":"object","required":["id","org_id","org_name","org_slug","role","accepted_at"],"title":"MembershipResponse","description":"Accepted membership."},"MessageResponse":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"content_type":{"type":"string","title":"Content Type"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"},"tool_args":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Args"},"tool_result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Result"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"sequence":{"type":"integer","title":"Sequence"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["id","role","content","content_type","sequence","timestamp"],"title":"MessageResponse"},"MetricsResponse":{"properties":{"claims_total":{"type":"integer","title":"Claims Total"},"documents_total":{"type":"integer","title":"Documents Total"},"tasks_pending":{"type":"integer","title":"Tasks Pending"},"tasks_running":{"type":"integer","title":"Tasks Running"},"tasks_failed_last_hour":{"type":"integer","title":"Tasks Failed Last Hour"},"avg_pipeline_duration_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Pipeline Duration Ms"},"worker_alive":{"type":"boolean","title":"Worker Alive"},"checked_at":{"type":"string","title":"Checked At"}},"type":"object","required":["claims_total","documents_total","tasks_pending","tasks_running","tasks_failed_last_hour","avg_pipeline_duration_ms","worker_alive","checked_at"],"title":"MetricsResponse"},"MfaEmailSetupRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","title":"MfaEmailSetupRequest"},"MfaEmailVerifyRequest":{"properties":{"code":{"type":"string","maxLength":6,"minLength":6,"title":"Code"}},"type":"object","required":["code"],"title":"MfaEmailVerifyRequest"},"MfaSetupResponse":{"properties":{"secret":{"type":"string","title":"Secret"},"provisioning_uri":{"type":"string","title":"Provisioning Uri"},"backup_codes":{"items":{"type":"string"},"type":"array","title":"Backup Codes","default":[]}},"type":"object","required":["secret","provisioning_uri"],"title":"MfaSetupResponse"},"MfaSmsSetupRequest":{"properties":{"phone":{"type":"string","maxLength":20,"minLength":10,"title":"Phone"}},"type":"object","required":["phone"],"title":"MfaSmsSetupRequest"},"MfaSmsVerifyRequest":{"properties":{"phone":{"type":"string","title":"Phone"},"code":{"type":"string","maxLength":6,"minLength":6,"title":"Code"}},"type":"object","required":["phone","code"],"title":"MfaSmsVerifyRequest"},"MfaVerifyRequest":{"properties":{"code":{"type":"string","title":"Code"}},"type":"object","required":["code"],"title":"MfaVerifyRequest"},"MfaVerifyResponse":{"properties":{"verified":{"type":"boolean","title":"Verified"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled"}},"type":"object","required":["verified","mfa_enabled"],"title":"MfaVerifyResponse"},"NoteResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"user_id":{"type":"string","title":"User Id"},"user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Name"},"body":{"type":"string","title":"Body"},"is_internal":{"type":"boolean","title":"Is Internal","default":true},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","claim_id","user_id","body","created_at"],"title":"NoteResponse"},"NotificationResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"notification_type":{"type":"string","title":"Notification Type"},"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body"},"is_read":{"type":"boolean","title":"Is Read","default":false},"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"},"channel":{"type":"string","title":"Channel","default":"in_app"},"delivery_status":{"type":"string","title":"Delivery Status","default":"sent"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","notification_type","title","body","created_at"],"title":"NotificationResponse"},"OccupationAnalysisResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"definition_phase":{"type":"string","title":"Definition Phase","default":""},"job_title":{"type":"string","title":"Job Title","default":""},"job_demands":{"items":{"type":"string"},"type":"array","title":"Job Demands"},"functional_capacity":{"items":{"type":"string"},"type":"array","title":"Functional Capacity"},"can_perform":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Can Perform"},"rationale":{"type":"string","title":"Rationale","default":""},"transition_date":{"type":"string","title":"Transition Date","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"OccupationAnalysisResponse"},"OrgDetail":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"plan":{"type":"string","title":"Plan"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"custom_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Domain"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false},"trial_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial Expires At"},"converted_to_production_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Converted To Production At"}},"type":"object","required":["id","name","slug","plan","settings","created_at","updated_at"],"title":"OrgDetail"},"OrgSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"plan":{"type":"string","title":"Plan"},"custom_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Domain"},"user_count":{"type":"integer","title":"User Count","default":0},"claim_count":{"type":"integer","title":"Claim Count","default":0},"created_at":{"type":"string","title":"Created At"},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false},"trial_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial Expires At"},"converted_to_production_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Converted To Production At"}},"type":"object","required":["id","name","slug","plan","created_at"],"title":"OrgSummary"},"OrgUsageResponse":{"properties":{"active_claims":{"type":"integer","title":"Active Claims"},"max_active_claims":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Active Claims"},"documents_this_month":{"type":"integer","title":"Documents This Month"},"max_uploads_per_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uploads Per Month"},"extractions_this_month":{"type":"integer","title":"Extractions This Month"},"max_extractions_per_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Extractions Per Month"},"period_start":{"type":"string","title":"Period Start"}},"type":"object","required":["active_claims","max_active_claims","documents_this_month","max_uploads_per_month","extractions_this_month","max_extractions_per_month","period_start"],"title":"OrgUsageResponse"},"OrgUserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"},"allowed_claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Claim Types"},"allowed_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Personas"},"is_active":{"type":"boolean","title":"Is Active"},"is_superadmin":{"type":"boolean","title":"Is Superadmin"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled","default":false},"require_mfa_setup":{"type":"boolean","title":"Require Mfa Setup","default":false},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","email","name","role","is_active","is_superadmin","created_at"],"title":"OrgUserResponse"},"PaginatedClaimsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ClaimSummaryResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"PaginatedClaimsResponse"},"PaginatedPersonsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PersonResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"PaginatedPersonsResponse"},"PasswordResetLinkResponse":{"properties":{"reset_url":{"type":"string","title":"Reset Url"},"expires_at":{"type":"string","title":"Expires At"},"user_email":{"type":"string","title":"User Email"},"user_name":{"type":"string","title":"User Name"}},"type":"object","required":["reset_url","expires_at","user_email","user_name"],"title":"PasswordResetLinkResponse","description":"Response containing password reset link."},"PendingMembershipResponse":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"org_slug":{"type":"string","title":"Org Slug"},"role":{"type":"string","title":"Role"},"invited_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By"},"invited_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By Name"},"invited_at":{"type":"string","title":"Invited At"},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false}},"type":"object","required":["id","org_id","org_name","org_slug","role","invited_by","invited_by_name","invited_at"],"title":"PendingMembershipResponse","description":"Pending membership invitation."},"PersonLinkRequest":{"properties":{"link_method":{"type":"string","title":"Link Method","default":"manual"}},"type":"object","title":"PersonLinkRequest"},"PersonOverrideRequest":{"properties":{"field_path":{"type":"string","title":"Field Path"},"value":{"title":"Value"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["field_path","value"],"title":"PersonOverrideRequest"},"PersonOverrideResponse":{"properties":{"id":{"type":"string","title":"Id"},"person_id":{"type":"string","title":"Person Id"},"field_path":{"type":"string","title":"Field Path"},"value":{"title":"Value"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"is_active":{"type":"boolean","title":"Is Active","default":true},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","person_id","field_path","value","created_at"],"title":"PersonOverrideResponse"},"PersonResponse":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"canonical_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Name"},"date_of_birth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Of Birth"},"ssn_last_four":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ssn Last Four"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"address":{"additionalProperties":true,"type":"object","title":"Address"},"demographics":{"additionalProperties":true,"type":"object","title":"Demographics"},"work_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Work History"},"education":{"additionalProperties":true,"type":"object","title":"Education"},"daily_activities":{"additionalProperties":true,"type":"object","title":"Daily Activities"},"treating_doctors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Treating Doctors"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"linked_claim_ids":{"items":{"type":"string"},"type":"array","title":"Linked Claim Ids"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","org_id","created_at","updated_at"],"title":"PersonResponse"},"PortalClaimSummary":{"properties":{"id":{"type":"string","title":"Id"},"claim_type":{"type":"string","title":"Claim Type"},"status":{"type":"string","title":"Status"},"current_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Stage"},"last_updated":{"type":"string","title":"Last Updated"},"documents_count":{"type":"integer","title":"Documents Count","default":0}},"type":"object","required":["id","claim_type","status","last_updated"],"title":"PortalClaimSummary","description":"One of the claimant's cases on the portal home page (``current_stage`` is the lifecycle stage id)."},"PortalDocumentUploadResponse":{"properties":{"document_id":{"type":"string","title":"Document Id"},"filename":{"type":"string","title":"Filename"},"uploaded_at":{"type":"string","title":"Uploaded At"},"status":{"type":"string","title":"Status","default":"received"}},"type":"object","required":["document_id","filename","uploaded_at"],"title":"PortalDocumentUploadResponse"},"PortalStatusResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"claim_type":{"type":"string","title":"Claim Type"},"status":{"type":"string","title":"Status"},"current_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Stage"},"stage_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage Description"},"next_steps":{"items":{"type":"string"},"type":"array","title":"Next Steps"},"documents_needed":{"items":{"type":"string"},"type":"array","title":"Documents Needed"},"last_updated":{"type":"string","title":"Last Updated"},"lifecycle_stage":{"type":"string","title":"Lifecycle Stage","default":"unfiled"},"disposition":{"type":"string","title":"Disposition","default":"open"},"stage_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage Name"},"stage_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage Type"},"document_count":{"type":"integer","title":"Document Count","default":0},"documents_reviewed":{"type":"integer","title":"Documents Reviewed","default":0},"pending_contracts":{"type":"integer","title":"Pending Contracts","default":0},"has_analysis":{"type":"boolean","title":"Has Analysis","default":false}},"type":"object","required":["claim_id","claim_type","status","last_updated"],"title":"PortalStatusResponse","description":"What a claimant sees about their own case (``GET /portal/claims/{id}/status``).\n\nMinimum necessary: where the case is and how far our work on it has got.\nNo medical content, no score, no names, no document titles: the claimant\nportal page (``app/portal/[id]/page.tsx``) shows the stage, the progress\ntimeline, a document count and whether something awaits their signature.\n\nThe first fields are the route's original ones, now filled from data that\nexists: ``current_stage`` is the id of the workflow stage the documents put\nthe case in (``workflow_state.current_stage`` is a ``{id, name,\ncompleteness}`` dict, which used to fail validation: every read was a 500);\n``next_steps`` are the names of the stages after it and ``documents_needed``\nthe document types it still misses (``workflow_state`` never had those\nkeys, so they were always empty); ``stage_description`` describes the\nlifecycle stage. Added 2026-09-28 (additive), what the page reads:\n\n- ``lifecycle_stage``: the case's stage id (``claims.lifecycle_stage``; in the\n database one of unfiled, intake, evaluation, filing, filed, hearing, appeal,\n closed), with ``stage_name`` and ``stage_type`` from the claim type's\n workflow definition (``domain/workflow.py``; null for an id it doesn't\n define, which is most of them: the page then shows the id in words);\n- ``disposition``: open, closed or delivered (our work on the case is done);\n- ``document_count``: files on the case (a split file once, deleted ones\n not at all) and ``documents_reviewed``, how many are fully processed;\n- ``pending_contracts``: contracts sent to be signed and not yet signed;\n- ``has_analysis``: the case has been scored (the score itself is not sent)."},"PortfolioMetricsResponse":{"properties":{"total_admissions":{"type":"integer","title":"Total Admissions"},"scored_admissions":{"type":"integer","title":"Scored Admissions"},"avg_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Score"},"median_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Score"},"risk_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Risk Distribution"},"gap_summary":{"additionalProperties":{"type":"integer"},"type":"object","title":"Gap Summary"},"step_performance":{"additionalProperties":{"type":"number"},"type":"object","title":"Step Performance"},"confidence_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Confidence Distribution"},"top_gaps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Gaps"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["total_admissions","scored_admissions","avg_score","median_score","risk_distribution","gap_summary","step_performance","confidence_distribution","top_gaps","generated_at"],"title":"PortfolioMetricsResponse","description":"Aggregate portfolio metrics for a claim type."},"PostMessageRequest":{"properties":{"content":{"type":"string","maxLength":4000,"title":"Content"}},"type":"object","required":["content"],"title":"PostMessageRequest"},"PostMessageResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"message_id":{"type":"string","title":"Message Id","default":""},"agent_response_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Response Text"},"accepted":{"type":"boolean","title":"Accepted","default":true}},"type":"object","required":["conversation_id"],"title":"PostMessageResponse","description":"Response shape for POST /threads/{id}/messages.\n\nItem #16 of the holistic-agent follow-ups: the endpoint now enqueues\n`process_turn` as a background task and returns 202 Accepted\nimmediately. The agent reply is delivered to the frontend via the\nSSE stream `/threads/{id}/stream`.\n\nBackwards-compat fields kept (and now always None / \"\"):\n - `message_id`: was the persisted human message id; the engine now\n runs after the response, so we can't return it. The frontend\n matches its optimistic message against the SSE-delivered\n canonical row by `(role, content, conversation_id, ts-window)`.\n - `agent_response_text`: was the synchronous agent reply; now\n delivered over SSE."},"ProfileRequest":{"properties":{"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"date_of_birth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Of Birth"},"ssn_last_four":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ssn Last Four"},"ssn_full":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ssn Full"},"address":{"additionalProperties":true,"type":"object","title":"Address"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"demographics":{"additionalProperties":true,"type":"object","title":"Demographics"},"work_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Work History"},"education":{"additionalProperties":true,"type":"object","title":"Education"},"daily_activities":{"additionalProperties":true,"type":"object","title":"Daily Activities"},"treating_doctors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Treating Doctors"}},"type":"object","title":"ProfileRequest"},"ProfileResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"date_of_birth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Of Birth"},"ssn_last_four":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ssn Last Four"},"address":{"additionalProperties":true,"type":"object","title":"Address"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"demographics":{"additionalProperties":true,"type":"object","title":"Demographics"},"work_history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Work History"},"education":{"additionalProperties":true,"type":"object","title":"Education"},"daily_activities":{"additionalProperties":true,"type":"object","title":"Daily Activities"},"treating_doctors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Treating Doctors"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","claim_id","created_at","updated_at"],"title":"ProfileResponse"},"ProviderResponse":{"properties":{"name":{"type":"string","title":"Name"},"specialty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specialty"},"facility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facility"},"npi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Npi"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"fax":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fax"},"source":{"type":"string","title":"Source","default":"extraction"}},"type":"object","required":["name"],"title":"ProviderResponse"},"QAReviewRequest":{"properties":{"action":{"type":"string","title":"Action"},"notes":{"type":"string","title":"Notes","default":""},"revision_items":{"items":{"type":"string"},"type":"array","title":"Revision Items"}},"type":"object","required":["action"],"title":"QAReviewRequest"},"QAReviewResponse":{"properties":{"status":{"type":"string","title":"Status"},"reviewer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"revision_items":{"items":{"type":"string"},"type":"array","title":"Revision Items","default":[]}},"type":"object","required":["status"],"title":"QAReviewResponse"},"QuickCaptureRequest":{"properties":{"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type","description":"ssdi | wc | va | ime | msa"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"source":{"type":"string","title":"Source","description":"Where this capture came from: user_ui | agent | voice_inbound | sms_inbound","default":"user_ui"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Free-text note from the capturer"}},"type":"object","title":"QuickCaptureRequest","description":"Minimal-info intake creation. At least one of claim_type, claimant_name,\nor phone must be provided."},"QuickCaptureResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"reconnected":{"type":"boolean","title":"Reconnected","description":"True if we matched an existing intake by phone instead of creating a new one","default":false},"status":{"type":"string","title":"Status","default":"intake"},"intake_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intake Tier"},"intake_recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intake Recommendation"}},"type":"object","required":["claim_id"],"title":"QuickCaptureResponse"},"RFCActionItemResponse":{"properties":{"limitation_area":{"type":"string","title":"Limitation Area"},"current_evidence":{"type":"string","title":"Current Evidence"},"needed_evidence":{"type":"string","title":"Needed Evidence"},"provider_to_contact":{"type":"string","title":"Provider To Contact"},"form_reference":{"type":"string","title":"Form Reference"},"priority":{"type":"string","title":"Priority","default":"medium"}},"type":"object","required":["limitation_area","current_evidence","needed_evidence","provider_to_contact","form_reference"],"title":"RFCActionItemResponse"},"RFCActionsResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"claim_type":{"type":"string","title":"Claim Type"},"actions":{"items":{"$ref":"#/components/schemas/RFCActionItemResponse"},"type":"array","title":"Actions"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["claim_id","claim_type","total"],"title":"RFCActionsResponse"},"RatingExplanationResponse":{"properties":{"final_combined":{"type":"integer","title":"Final Combined"},"final_rounded":{"type":"integer","title":"Final Rounded"},"steps":{"items":{"$ref":"#/components/schemas/RatingStepResponse"},"type":"array","title":"Steps"},"bilateral_factor_applied":{"type":"boolean","title":"Bilateral Factor Applied","default":false},"tdiu_eligible":{"type":"boolean","title":"Tdiu Eligible","default":false},"tdiu_reason":{"type":"string","title":"Tdiu Reason","default":""},"conditions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conditions"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["final_combined","final_rounded","steps"],"title":"RatingExplanationResponse"},"RatingStepResponse":{"properties":{"condition":{"type":"string","title":"Condition"},"diagnostic_code":{"type":"string","title":"Diagnostic Code","default":""},"individual_rating":{"type":"integer","title":"Individual Rating","default":0},"combined_before":{"type":"integer","title":"Combined Before","default":0},"combined_after":{"type":"integer","title":"Combined After","default":0},"remaining_efficiency":{"type":"number","title":"Remaining Efficiency","default":100.0},"explanation":{"type":"string","title":"Explanation","default":""}},"type":"object","required":["condition"],"title":"RatingStepResponse"},"RebuttalPointResponse":{"properties":{"step_name":{"type":"string","title":"Step Name"},"ssa_finding":{"type":"string","title":"Ssa Finding"},"rebuttal_argument":{"type":"string","title":"Rebuttal Argument"},"supporting_evidence":{"items":{"type":"string"},"type":"array","title":"Supporting Evidence"},"strength":{"type":"string","title":"Strength","default":"moderate"}},"type":"object","required":["step_name","ssa_finding","rebuttal_argument"],"title":"RebuttalPointResponse"},"RebuttalReportResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"denial_type":{"type":"string","title":"Denial Type"},"points":{"items":{"$ref":"#/components/schemas/RebuttalPointResponse"},"type":"array","title":"Points"},"overall_strategy":{"type":"string","title":"Overall Strategy","default":""},"recommended_evidence":{"items":{"type":"string"},"type":"array","title":"Recommended Evidence"}},"type":"object","required":["claim_id","denial_type"],"title":"RebuttalReportResponse"},"RecordRequestResponse":{"properties":{"id":{"type":"string","title":"Id"},"provider_name":{"type":"string","title":"Provider Name"},"record_type":{"type":"string","title":"Record Type"},"status":{"type":"string","title":"Status"},"request_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Method"},"request_sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Sent At"},"follow_up_count":{"type":"integer","title":"Follow Up Count","default":0},"next_follow_up_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Follow Up At"},"received_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Received At"},"received_document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Received Document Id"}},"type":"object","required":["id","provider_name","record_type","status"],"title":"RecordRequestResponse"},"RecordSummary":{"properties":{"record_id":{"type":"string","title":"Record Id"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"timestamp":{"type":"string","title":"Timestamp"},"field_count":{"type":"integer","title":"Field Count"}},"type":"object","required":["record_id","timestamp","field_count"],"title":"RecordSummary","description":"Lightweight summary of an extraction record."},"ReferralAcceptedResponse":{"properties":{"referral_id":{"type":"string","title":"Referral Id"},"claim_id":{"type":"string","title":"Claim Id"},"batch_id":{"type":"string","title":"Batch Id"},"documents_queued":{"type":"integer","title":"Documents Queued"},"status_url":{"type":"string","title":"Status Url"}},"type":"object","required":["referral_id","claim_id","batch_id","documents_queued","status_url"],"title":"ReferralAcceptedResponse"},"ReferralResultsResponse":{"properties":{"referral_id":{"type":"string","title":"Referral Id"},"claim_id":{"type":"string","title":"Claim Id"},"status":{"type":"string","title":"Status"},"merged_extraction":{"additionalProperties":true,"type":"object","title":"Merged Extraction","default":{}},"inference_result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Inference Result"},"chronology":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Chronology","default":[]},"msa_projection":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Msa Projection"},"gaps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Gaps","default":[]}},"type":"object","required":["referral_id","claim_id","status"],"title":"ReferralResultsResponse"},"RegisterRequest":{"properties":{"email":{"type":"string","minLength":3,"title":"Email"},"password":{"type":"string","minLength":12,"title":"Password"},"name":{"type":"string","minLength":1,"title":"Name"},"org_name":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Org Name"},"org_slug":{"anyOf":[{"type":"string","minLength":1,"pattern":"^[a-z0-9\\-]+$"},{"type":"null"}],"title":"Org Slug"},"invite_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Token"}},"type":"object","required":["email","password","name"],"title":"RegisterRequest"},"ReportResponse":{"properties":{"title":{"type":"string","title":"Title"},"report_type":{"type":"string","title":"Report Type"},"sections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sections"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title","report_type","sections","metadata"],"title":"ReportResponse"},"RequestOTPBody":{"properties":{"phone":{"type":"string","title":"Phone"}},"type":"object","required":["phone"],"title":"RequestOTPBody"},"ResendVerificationRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"ResendVerificationRequest"},"ReserveAdequacyItemResponse":{"properties":{"category":{"type":"string","title":"Category"},"reserve_amount":{"type":"number","title":"Reserve Amount","default":0.0},"estimated_exposure":{"type":"number","title":"Estimated Exposure","default":0.0},"adequacy_ratio":{"type":"number","title":"Adequacy Ratio","default":0.0},"status":{"type":"string","title":"Status","default":"adequate"},"recommended_adjustment":{"type":"number","title":"Recommended Adjustment","default":0.0},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["category"],"title":"ReserveAdequacyItemResponse"},"ReserveAdequacyResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"items":{"items":{"$ref":"#/components/schemas/ReserveAdequacyItemResponse"},"type":"array","title":"Items"},"total_reserve":{"type":"number","title":"Total Reserve","default":0.0},"total_exposure":{"type":"number","title":"Total Exposure","default":0.0},"overall_adequacy":{"type":"string","title":"Overall Adequacy","default":"adequate"},"recommended_total_adjustment":{"type":"number","title":"Recommended Total Adjustment","default":0.0},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"ReserveAdequacyResponse"},"ReserveLineItemResponse":{"properties":{"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"incurred":{"type":"number","title":"Incurred","default":0.0},"paid":{"type":"number","title":"Paid","default":0.0},"outstanding":{"type":"number","title":"Outstanding","default":0.0},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["category","description"],"title":"ReserveLineItemResponse"},"ReserveWorksheetResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"total_incurred":{"type":"number","title":"Total Incurred"},"total_paid":{"type":"number","title":"Total Paid"},"total_outstanding":{"type":"number","title":"Total Outstanding"},"line_items":{"items":{"$ref":"#/components/schemas/ReserveLineItemResponse"},"type":"array","title":"Line Items"},"assumptions":{"items":{"type":"string"},"type":"array","title":"Assumptions"}},"type":"object","required":["claim_id","total_incurred","total_paid","total_outstanding","line_items"],"title":"ReserveWorksheetResponse"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","minLength":12,"title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest"},"RetentionPolicy":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"resource_type":{"type":"string","title":"Resource Type"},"retention_days":{"type":"integer","title":"Retention Days"},"action":{"type":"string","title":"Action","default":"archive"},"is_active":{"type":"boolean","title":"Is Active","default":true},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","name","resource_type","retention_days"],"title":"RetentionPolicy"},"RetentionPolicyListResponse":{"properties":{"policies":{"items":{"$ref":"#/components/schemas/RetentionPolicy"},"type":"array","title":"Policies"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["policies","total"],"title":"RetentionPolicyListResponse"},"RotateApiKeyRequest":{"properties":{"grace_period_hours":{"type":"integer","maximum":720.0,"minimum":1.0,"title":"Grace Period Hours","default":24}},"type":"object","title":"RotateApiKeyRequest"},"SSASubmitPackageRequest":{"properties":{"form_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Form Types"},"use_mock":{"type":"boolean","title":"Use Mock","default":false}},"type":"object","title":"SSASubmitPackageRequest","description":"Request body for submitting all locked forms for a claim."},"SSASubmitRequest":{"properties":{"form_instance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Instance Id"},"use_mock":{"type":"boolean","title":"Use Mock","default":false}},"type":"object","title":"SSASubmitRequest","description":"Request body for submitting a form to SSA."},"ScriptSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"script_type":{"type":"string","title":"Script Type"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"claim_types":{"items":{"type":"string"},"type":"array","title":"Claim Types"},"version":{"type":"integer","title":"Version"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","slug","script_type","channels","claim_types","version","is_active","created_at","updated_at"],"title":"ScriptSummary"},"SecureInfoRequest":{"properties":{"token":{"type":"string","title":"Token"},"ssn":{"type":"string","title":"Ssn","description":"9-digit SSN, with or without dashes"},"dob":{"type":"string","title":"Dob","description":"ISO date YYYY-MM-DD"},"mbi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mbi"},"medicare_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medicare Id"},"address_line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code"}},"type":"object","required":["token","ssn","dob"],"title":"SecureInfoRequest"},"SeedAnnuityResponse":{"properties":{"seed_amount":{"type":"number","title":"Seed Amount","default":0.0},"annual_deposit":{"type":"number","title":"Annual Deposit","default":0.0},"total_funding":{"type":"number","title":"Total Funding","default":0.0},"projection_years":{"type":"number","title":"Projection Years","default":0.0},"discount_rate":{"type":"number","title":"Discount Rate","default":0.03},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","title":"SeedAnnuityResponse"},"SeedClaimRequest":{"properties":{"merged_extraction":{"additionalProperties":true,"type":"object","title":"Merged Extraction"},"inference":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Inference"},"documents":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Documents","description":"Synthetic documents: [{filename, document_type}]"}},"type":"object","title":"SeedClaimRequest"},"SendMessageRequest":{"properties":{"content":{"type":"string","title":"Content"},"role":{"type":"string","const":"human","title":"Role","default":"human"}},"type":"object","required":["content"],"title":"SendMessageRequest"},"SensitivityResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"base_total":{"type":"number","title":"Base Total","default":0.0},"scenarios":{"items":{"$ref":"#/components/schemas/SensitivityScenarioResponse"},"type":"array","title":"Scenarios"},"parameters_tested":{"items":{"type":"string"},"type":"array","title":"Parameters Tested"}},"type":"object","required":["claim_id"],"title":"SensitivityResponse"},"SensitivityScenarioResponse":{"properties":{"parameter":{"type":"string","title":"Parameter"},"value":{"type":"number","title":"Value"},"total_msa":{"type":"number","title":"Total Msa"},"delta_from_base":{"type":"number","title":"Delta From Base"},"delta_pct":{"type":"number","title":"Delta Pct"}},"type":"object","required":["parameter","value","total_msa","delta_from_base","delta_pct"],"title":"SensitivityScenarioResponse"},"SessionDocumentUploadResponse":{"properties":{"status":{"type":"string","title":"Status"},"claim_id":{"type":"string","title":"Claim Id"},"filename":{"type":"string","title":"Filename"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id"}},"type":"object","required":["status","claim_id","filename"],"title":"SessionDocumentUploadResponse"},"SettlementComponentResponse":{"properties":{"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"estimated_value":{"type":"number","title":"Estimated Value"},"low_estimate":{"type":"number","title":"Low Estimate"},"high_estimate":{"type":"number","title":"High Estimate"},"basis":{"type":"string","title":"Basis"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["category","description","estimated_value","low_estimate","high_estimate","basis"],"title":"SettlementComponentResponse"},"SettlementEstimateResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"total_low":{"type":"number","title":"Total Low"},"total_high":{"type":"number","title":"Total High"},"total_midpoint":{"type":"number","title":"Total Midpoint"},"components":{"items":{"$ref":"#/components/schemas/SettlementComponentResponse"},"type":"array","title":"Components"},"pd_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pd Rating"},"life_pension_eligible":{"type":"boolean","title":"Life Pension Eligible","default":false},"state":{"type":"string","title":"State","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id","total_low","total_high","total_midpoint","components"],"title":"SettlementEstimateResponse"},"SnoozeIntakeRequest":{"properties":{"until":{"type":"string","format":"date-time","title":"Until","description":"UTC ISO timestamp until which to snooze"}},"type":"object","required":["until"],"title":"SnoozeIntakeRequest"},"SourceAttributionDict":{"properties":{"document_id":{"type":"string","title":"Document Id"},"document_name":{"type":"string","title":"Document Name"},"page_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Number"},"section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section"},"source_confidence":{"type":"number","title":"Source Confidence"},"extraction_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Timestamp"},"extraction_method":{"type":"string","title":"Extraction Method"},"value":{"title":"Value"}},"type":"object","required":["document_id","document_name","source_confidence","extraction_method","value"],"title":"SourceAttributionDict","description":"Source attribution for a field value."},"SsaFormBundleResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"payloads":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Payloads"},"intake_issues":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Intake Issues"},"form_issues":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Form Issues"},"templates_available":{"items":{"type":"string"},"type":"array","title":"Templates Available"}},"type":"object","required":["claim_id"],"title":"SsaFormBundleResponse","description":"Bundle of all SSA forms for a single claim."},"SsaFormPayloadResponse":{"properties":{"form_type":{"type":"string","title":"Form Type"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"intake_issues":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Intake Issues"},"form_issues":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Form Issues"},"template_available":{"type":"boolean","title":"Template Available","default":false}},"type":"object","required":["form_type","payload"],"title":"SsaFormPayloadResponse","description":"Response payload for SSA-aligned form export."},"StartSLAResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"sla_start":{"type":"string","title":"Sla Start"},"sla_deadline":{"type":"string","title":"Sla Deadline"},"current_stage":{"type":"string","title":"Current Stage"}},"type":"object","required":["claim_id","sla_start","sla_deadline","current_stage"],"title":"StartSLAResponse"},"StateRulesResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"state":{"type":"string","title":"State","default":""},"has_full_rates":{"type":"boolean","title":"Has Full Rates","default":false},"has_thresholds":{"type":"boolean","title":"Has Thresholds","default":false},"has_apportionment_rules":{"type":"boolean","title":"Has Apportionment Rules","default":false},"thresholds":{"additionalProperties":true,"type":"object","title":"Thresholds"},"benefit_rates":{"additionalProperties":true,"type":"object","title":"Benefit Rates"},"apportionment":{"additionalProperties":true,"type":"object","title":"Apportionment"}},"type":"object","required":["claim_id"],"title":"StateRulesResponse"},"StructuredDataResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"source_format":{"type":"string","title":"Source Format"},"coded_data":{"additionalProperties":true,"type":"object","title":"Coded Data"},"patient_found":{"type":"boolean","title":"Patient Found"},"diagnosis_count":{"type":"integer","title":"Diagnosis Count"},"medication_count":{"type":"integer","title":"Medication Count"},"procedure_count":{"type":"integer","title":"Procedure Count"},"observation_count":{"type":"integer","title":"Observation Count"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["success","source_format","coded_data","patient_found","diagnosis_count","medication_count","procedure_count","observation_count"],"title":"StructuredDataResponse","description":"Response for structured data ingestion."},"SubscriptionRequest":{"properties":{"org_name":{"type":"string","title":"Org Name"},"email":{"type":"string","title":"Email","default":""},"price_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Id"}},"type":"object","required":["org_name"],"title":"SubscriptionRequest"},"SubscriptionResponse":{"properties":{"subscription_id":{"type":"string","title":"Subscription Id"},"customer_id":{"type":"string","title":"Customer Id"},"status":{"type":"string","title":"Status"},"current_period_start":{"type":"string","title":"Current Period Start"},"current_period_end":{"type":"string","title":"Current Period End"},"plan":{"type":"string","title":"Plan","default":""},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End","default":false}},"type":"object","required":["subscription_id","customer_id","status","current_period_start","current_period_end"],"title":"SubscriptionResponse"},"SwitchOrgRequest":{"properties":{"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["org_id"],"title":"SwitchOrgRequest","description":"Request to switch active organization."},"TaskStatusResponse":{"properties":{"id":{"type":"string","title":"Id"},"task_type":{"type":"string","title":"Task Type"},"status":{"type":"string","title":"Status"},"claim_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"attempts":{"type":"integer","title":"Attempts"},"created_at":{"type":"string","title":"Created At"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","task_type","status","attempts","created_at"],"title":"TaskStatusResponse"},"TenantBrandingResponse":{"properties":{"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"primary_color":{"type":"string","title":"Primary Color","default":"#0d9488"},"secondary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary Color"},"font_family":{"type":"string","title":"Font Family","default":"Inter"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"support_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Support Email"},"support_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Support Phone"},"agent_voice_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Voice Tone"},"agent_name":{"type":"string","title":"Agent Name","default":"Agent"},"powered_by_visible":{"type":"boolean","title":"Powered By Visible","default":true},"hide_zicron_branding":{"type":"boolean","title":"Hide Zicron Branding","default":false}},"type":"object","title":"TenantBrandingResponse","description":"Tenant branding configuration for B2B integrations (e.g., Claimify)."},"TenantBrandingUpdate":{"properties":{"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Color"},"secondary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secondary Color"},"font_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Font Family"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"support_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Support Email"},"support_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Support Phone"},"agent_voice_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Voice Tone"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"powered_by_visible":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Powered By Visible"},"hide_zicron_branding":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hide Zicron Branding"}},"type":"object","title":"TenantBrandingUpdate","description":"Partial update for tenant branding."},"ThreadClaim":{"properties":{"id":{"type":"string","title":"Id"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"lifecycle_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lifecycle Stage"}},"type":"object","required":["id"],"title":"ThreadClaim"},"ThreadConversation":{"properties":{"id":{"type":"string","title":"Id"},"channel":{"type":"string","title":"Channel"},"direction":{"type":"string","title":"Direction"},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At"},"last_delivery_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Delivery Status"},"last_delivery_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Delivery Error"},"last_delivery_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Delivery At"}},"type":"object","required":["id","channel","direction","status"],"title":"ThreadConversation"},"ThreadDetail":{"properties":{"thread_id":{"type":"string","title":"Thread Id"},"person":{"$ref":"#/components/schemas/ThreadPerson"},"claims":{"items":{"$ref":"#/components/schemas/ThreadClaim"},"type":"array","title":"Claims"},"channels_used":{"items":{"type":"string"},"type":"array","title":"Channels Used"},"active_status":{"type":"string","title":"Active Status"},"conversations":{"items":{"$ref":"#/components/schemas/ThreadConversation"},"type":"array","title":"Conversations"},"messages":{"items":{"$ref":"#/components/schemas/ThreadMessage"},"type":"array","title":"Messages"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"pinned_facts":{"additionalProperties":true,"type":"object","title":"Pinned Facts"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"last_activity_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity At"}},"type":"object","required":["thread_id","person","active_status"],"title":"ThreadDetail"},"ThreadMessage":{"properties":{"id":{"type":"string","title":"Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"content_type":{"type":"string","title":"Content Type"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"},"tool_args":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Args"},"timestamp":{"type":"string","title":"Timestamp"},"claim_context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Context Id"}},"type":"object","required":["id","conversation_id","role","content","content_type","timestamp"],"title":"ThreadMessage"},"ThreadPerson":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"phone_masked":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Masked"},"email_masked":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Masked"}},"type":"object","title":"ThreadPerson"},"ThreadSummary":{"properties":{"thread_id":{"type":"string","title":"Thread Id"},"person_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Id"},"person_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Name"},"channels_used":{"items":{"type":"string"},"type":"array","title":"Channels Used"},"claim_ids":{"items":{"type":"string"},"type":"array","title":"Claim Ids"},"claim_types":{"items":{"type":"string"},"type":"array","title":"Claim Types"},"last_activity_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity At"},"last_message_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message Preview"},"active_status":{"type":"string","title":"Active Status"},"conversation_count":{"type":"integer","title":"Conversation Count"},"unread_count":{"type":"integer","title":"Unread Count","default":0},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"pinned_facts":{"additionalProperties":true,"type":"object","title":"Pinned Facts"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["thread_id","active_status","conversation_count"],"title":"ThreadSummary"},"TrackEventRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Event type to track"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Event payload"}},"type":"object","required":["event_type"],"title":"TrackEventRequest"},"TrendsResponse":{"properties":{"snapshots":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Snapshots"},"current_vs_baseline":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Current Vs Baseline"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["snapshots","current_vs_baseline","generated_at"],"title":"TrendsResponse","description":"Month-over-month trend data for portfolio metrics."},"URAppealResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"points":{"items":{"$ref":"#/components/schemas/AppealPointResponse"},"type":"array","title":"Points"}},"type":"object","required":["claim_id","points"],"title":"URAppealResponse"},"URDenialItemResponse":{"properties":{"treatment_requested":{"type":"string","title":"Treatment Requested"},"denial_date":{"type":"string","title":"Denial Date","default":""},"denial_reason":{"type":"string","title":"Denial Reason","default":""},"appeal_deadline":{"type":"string","title":"Appeal Deadline","default":""},"appeal_status":{"type":"string","title":"Appeal Status","default":"not_started"},"recommended_action":{"type":"string","title":"Recommended Action","default":""},"supporting_evidence":{"items":{"type":"string"},"type":"array","title":"Supporting Evidence"}},"type":"object","required":["treatment_requested"],"title":"URDenialItemResponse"},"URTrackingResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"denials":{"items":{"$ref":"#/components/schemas/URDenialItemResponse"},"type":"array","title":"Denials"},"total_denials":{"type":"integer","title":"Total Denials","default":0},"appeals_filed":{"type":"integer","title":"Appeals Filed","default":0},"appeals_pending":{"type":"integer","title":"Appeals Pending","default":0},"appeals_won":{"type":"integer","title":"Appeals Won","default":0}},"type":"object","required":["claim_id","denials"],"title":"URTrackingResponse"},"UpdateInviteRequest":{"properties":{"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Hint"},"assigned_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Assigned Personas"},"claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Claim Types"},"locked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Locked"}},"type":"object","title":"UpdateInviteRequest"},"UpdateLeadRequest":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","title":"UpdateLeadRequest"},"UpdateMeRequest":{"properties":{"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"}},"type":"object","title":"UpdateMeRequest"},"UpdateOrgRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"custom_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Domain"}},"type":"object","title":"UpdateOrgRequest"},"UpdateUserRequest":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"},"allowed_claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Claim Types"},"allowed_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Personas"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"is_superadmin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Superadmin"},"mfa_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mfa Enabled"},"require_mfa_setup":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Require Mfa Setup"}},"type":"object","title":"UpdateUserRequest"},"UploadConfirmationRequest":{"properties":{"email":{"type":"string","title":"Email"},"claim_id":{"type":"string","title":"Claim Id"},"document_count":{"type":"integer","title":"Document Count"}},"type":"object","required":["email","claim_id","document_count"],"title":"UploadConfirmationRequest","description":"Request to send upload confirmation email."},"UsageSummaryResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"subscription":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Subscription"},"usage":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Usage"}},"type":"object","required":["enabled"],"title":"UsageSummaryResponse"},"UserDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"},"allowed_claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Claim Types"},"allowed_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Personas"},"is_active":{"type":"boolean","title":"Is Active"},"is_superadmin":{"type":"boolean","title":"Is Superadmin"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled","default":false},"require_mfa_setup":{"type":"boolean","title":"Require Mfa Setup","default":false},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"org_slug":{"type":"string","title":"Org Slug"}},"type":"object","required":["id","email","name","role","is_active","is_superadmin","created_at","updated_at","org_id","org_name","org_slug"],"title":"UserDetailResponse","description":"Detailed user info including org context."},"UserMembershipResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"role":{"type":"string","title":"Role"},"accepted_at":{"type":"string","title":"Accepted At"},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false}},"type":"object","required":["org_id","org_name","role","accepted_at"],"title":"UserMembershipResponse","description":"User's membership in an organization."},"UserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"role":{"type":"string","title":"Role"},"persona":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"is_superadmin":{"type":"boolean","title":"Is Superadmin","default":false},"is_demo":{"type":"boolean","title":"Is Demo","default":false},"is_trial":{"type":"boolean","title":"Is Trial","default":false},"org_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Role"},"trial_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial Expires At"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled","default":false},"allowed_claim_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Claim Types"},"allowed_personas":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Personas"},"impersonating_org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impersonating Org Id"},"impersonating_org_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impersonating Org Name"},"impersonating_user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impersonating User Name"},"impersonating_user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impersonating User Email"}},"type":"object","required":["id","email","name","role","org_id","org_name"],"title":"UserResponse"},"UserTimelineResponse":{"properties":{"user":{"$ref":"#/components/schemas/DemoUserResponse"},"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Events"}},"type":"object","required":["user","events"],"title":"UserTimelineResponse"},"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"},"VerifyEmailRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"VerifyEmailRequest"},"VerifyOTPBody":{"properties":{"phone":{"type":"string","title":"Phone"},"code":{"type":"string","title":"Code"}},"type":"object","required":["phone","code"],"title":"VerifyOTPBody"},"WageLossCalculationResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"pre_injury_aww":{"type":"number","title":"Pre Injury Aww","default":0.0},"ttd_weekly_rate":{"type":"number","title":"Ttd Weekly Rate","default":0.0},"tpd_weekly_rate":{"type":"number","title":"Tpd Weekly Rate","default":0.0},"ttd_weeks":{"type":"number","title":"Ttd Weeks","default":0.0},"total_ttd_benefits":{"type":"number","title":"Total Ttd Benefits","default":0.0},"total_tpd_benefits":{"type":"number","title":"Total Tpd Benefits","default":0.0},"future_wage_loss_estimate":{"type":"number","title":"Future Wage Loss Estimate","default":0.0},"state":{"type":"string","title":"State","default":""},"state_max_ttd_rate":{"type":"number","title":"State Max Ttd Rate","default":0.0},"state_min_ttd_rate":{"type":"number","title":"State Min Ttd Rate","default":0.0},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"WageLossCalculationResponse"},"WebhookConfigRequest":{"properties":{"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"HTTPS URL to receive partner events. Pass null/empty to clear."}},"type":"object","title":"WebhookConfigRequest"},"WebhookConfigResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url"},"has_signing_secret":{"type":"boolean","title":"Has Signing Secret","default":false},"events":{"items":{"type":"string"},"type":"array","title":"Events"}},"type":"object","required":["org_id"],"title":"WebhookConfigResponse"},"WebhookSecretResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"secret":{"type":"string","title":"Secret","description":"Signing secret — shown once, store it securely."},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["org_id","secret","created_at"],"title":"WebhookSecretResponse"},"WorkCapacityResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"current_status":{"type":"string","title":"Current Status","default":"unknown"},"exertional_level":{"type":"string","title":"Exertional Level","default":""},"restrictions":{"items":{"type":"string"},"type":"array","title":"Restrictions"},"fce_completed":{"type":"boolean","title":"Fce Completed","default":false},"fce_level":{"type":"string","title":"Fce Level","default":""},"job_of_injury_demands":{"type":"string","title":"Job Of Injury Demands","default":""},"rtw_feasible":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Rtw Feasible"},"ttd_weeks_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttd Weeks Used"},"ttd_weeks_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttd Weeks Max"},"vocational_status":{"type":"string","title":"Vocational Status","default":""},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["claim_id"],"title":"WorkCapacityResponse"},"WorkflowResponse":{"properties":{"claim_type":{"type":"string","title":"Claim Type"},"current_stage":{"additionalProperties":true,"type":"object","title":"Current Stage"},"overall_completeness":{"type":"number","title":"Overall Completeness"},"documents_processed":{"items":{"type":"string"},"type":"array","title":"Documents Processed"},"documents_missing":{"items":{"type":"string"},"type":"array","title":"Documents Missing"},"next_stages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Next Stages"},"stages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Stages"}},"type":"object","required":["claim_type","current_stage","overall_completeness","documents_processed","documents_missing","next_stages","stages"],"title":"WorkflowResponse"},"extraction__api__routes__auth_routes__MfaLoginRequest":{"properties":{"mfa_session":{"type":"string","title":"Mfa Session"},"code":{"type":"string","title":"Code"}},"type":"object","required":["mfa_session","code"],"title":"MfaLoginRequest"},"extraction__api__routes__cms_submit__CMSSubmissionResponse":{"properties":{"id":{"type":"string","title":"Id"},"claim_id":{"type":"string","title":"Claim Id"},"submission_type":{"type":"string","title":"Submission Type"},"status":{"type":"string","title":"Status"},"cms_tracking_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cms Tracking Number"},"completeness_pct":{"type":"number","title":"Completeness Pct","default":0.0},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields","default":[]},"submitted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submitted At"},"submission_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submission Method"},"approved_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Approved Amount"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","claim_id","submission_type","status","created_at"],"title":"CMSSubmissionResponse"},"extraction__api__routes__ime_tools__ChecklistItemResponse":{"properties":{"item":{"type":"string","title":"Item"},"category":{"type":"string","title":"Category","default":""},"completed":{"type":"boolean","title":"Completed","default":false},"notes":{"type":"string","title":"Notes","default":""},"priority":{"type":"string","title":"Priority","default":"medium"}},"type":"object","required":["item"],"title":"ChecklistItemResponse"},"extraction__api__routes__ime_tools__ChecklistResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"title":{"type":"string","title":"Title"},"items":{"items":{"$ref":"#/components/schemas/extraction__api__routes__ime_tools__ChecklistItemResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"completed_count":{"type":"integer","title":"Completed Count"}},"type":"object","required":["claim_id","title","items","total","completed_count"],"title":"ChecklistResponse"},"extraction__api__routes__intake__BatchStatusResponse":{"properties":{"batch_id":{"type":"string","title":"Batch Id"},"status":{"type":"string","title":"Status","description":"processing | completed | partial"},"total":{"type":"integer","title":"Total"},"completed":{"type":"integer","title":"Completed"},"failed":{"type":"integer","title":"Failed"},"pending":{"type":"integer","title":"Pending"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"webhook_sent":{"type":"boolean","title":"Webhook Sent","default":false},"items":{"items":{"$ref":"#/components/schemas/BatchStatusItem"},"type":"array","title":"Items"}},"type":"object","required":["batch_id","status","total","completed","failed","pending","items"],"title":"BatchStatusResponse"},"extraction__api__routes__mfa_extended__MfaLoginRequest":{"properties":{"mfa_session":{"type":"string","title":"Mfa Session"},"code":{"type":"string","maxLength":6,"minLength":6,"title":"Code"}},"type":"object","required":["mfa_session","code"],"title":"MfaLoginRequest"},"extraction__api__routes__msa_tools__CMSSubmissionResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"fields":{"items":{"$ref":"#/components/schemas/CMSFieldResponse"},"type":"array","title":"Fields"},"completeness_pct":{"type":"number","title":"Completeness Pct"},"missing_required":{"items":{"type":"string"},"type":"array","title":"Missing Required"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"ready_to_submit":{"type":"boolean","title":"Ready To Submit"}},"type":"object","required":["claim_id","fields","completeness_pct","ready_to_submit"],"title":"CMSSubmissionResponse"},"extraction__api__routes__referrals__BatchStatusResponse":{"properties":{"referral_id":{"type":"string","title":"Referral Id"},"claim_id":{"type":"string","title":"Claim Id"},"batch_id":{"type":"string","title":"Batch Id"},"status":{"type":"string","title":"Status"},"total_documents":{"type":"integer","title":"Total Documents"},"documents_complete":{"type":"integer","title":"Documents Complete"},"documents_failed":{"type":"integer","title":"Documents Failed"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["referral_id","claim_id","batch_id","status","total_documents","documents_complete","documents_failed","created_at"],"title":"BatchStatusResponse"},"extraction__api__routes__wc_tools__ChecklistItemResponse":{"properties":{"item":{"type":"string","title":"Item"},"category":{"type":"string","title":"Category","default":""},"met":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Met"},"evidence":{"type":"string","title":"Evidence","default":""},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["item"],"title":"ChecklistItemResponse"},"extraction__api__routes__wc_tools__ChecklistResponse":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"title":{"type":"string","title":"Title"},"items":{"items":{"$ref":"#/components/schemas/extraction__api__routes__wc_tools__ChecklistItemResponse"},"type":"array","title":"Items"},"met_count":{"type":"integer","title":"Met Count","default":0},"total_count":{"type":"integer","title":"Total Count","default":0}},"type":"object","required":["claim_id","title","items"],"title":"ChecklistResponse"}},"securitySchemes":{"ApiKey":{"type":"http","description":"API key: `Authorization: Bearer zk_live_…`","scheme":"bearer"},"Session":{"type":"apiKey","description":"Zicron web session cookie","in":"cookie","name":"zicron_session"}}}}