{"service":"HBox Cortex","description":"Internal HBox-hosted LLM service with HIPAA-aware prompting for healthcare applications","version":"1.0.0","environment":"production","authentication":{"type":"Bearer Token (JWT)","description":"Use your existing HBox JWT token for authentication","hbox_api":"https://hapi.hbox.ai/","header":"Authorization: Bearer <your_hbox_jwt_token>","note":"All valid JWT tokens issued by HBox service (hapi.hbox.ai) are accepted"},"hipaa_modes":{"description":"Control HIPAA behavior using the 'mode' parameter in chat requests","parameter":"mode","options":{"USER":{"description":"Default mode with strict PHI protections","behavior":"Warns about PHI, asks for de-identification, won't request patient identifiers","intended_for":"Patients (user_type='P')"},"POWER_USER":{"description":"Clinical mode - PHI handling permitted","behavior":"Allows working with real patient data for legitimate clinical purposes","intended_for":"Clinical staff (user_type='DO', 'MO', 'CC', etc.)"}},"access_control":"Mode access is determined by your HBox user type in the JWT token","example":{"to_disable_strict_hipaa":"Set 'mode': 'POWER_USER' in your request body","request_body":{"model":"hbox-cortex-qwen35-9b","mode":"POWER_USER","messages":[{"role":"user","content":"Your message..."}]}}},"documentation":{"swagger_ui":"Disabled in production","redoc":"Disabled in production","openapi_spec":"Disabled in production"},"endpoints":{"chat":{"url":"/v1/chat/completions","method":"POST","description":"OpenAI-compatible chat completions with HIPAA-aware modes","auth":"Bearer token required (HBox JWT)","modes":{"USER":"Standard mode with strict PHI protections (for patients)","POWER_USER":"Clinical mode allowing PHI (for doctors, nurses, staff)"}},"models":{"list":{"url":"/v1/models","method":"GET","description":"List available LLM models"},"get":{"url":"/v1/models/{model_id}","method":"GET","description":"Get details for a specific model"}},"health":{"basic":{"url":"/health","method":"GET","description":"Basic health check (no auth required)"},"live":{"url":"/health/live","method":"GET","description":"Liveness probe for container orchestrators"},"ready":{"url":"/health/ready","method":"GET","description":"Readiness probe - checks all dependencies"},"queue":{"url":"/health/queue","method":"GET","description":"Request queue statistics"},"instance":{"url":"/health/instance","method":"GET","description":"Comprehensive instance health and configuration"}},"admin":{"usage":{"url":"/v1/admin/usage","method":"GET","description":"Get aggregated usage statistics (admin only)"},"requests":{"url":"/v1/admin/requests","method":"GET","description":"Get paginated request logs (admin only)"},"quota":{"url":"/v1/admin/quota/{entity_type}/{entity_id}","methods":["GET","PUT"],"description":"Get or update quota for user/org (admin only)"}},"metrics":{"url":"/metrics","method":"GET","description":"Prometheus metrics endpoint"}},"links":{"health_check":"http://hapi.hbox.ai/health","instance_info":"http://hapi.hbox.ai/health/instance","hbox_api":"https://hapi.hbox.ai/"}}