{"openapi":"3.1.0","info":{"title":"KATSU AI Autopilot","version":"1.0.4"},"paths":{"/health":{"get":{"tags":["health"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","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":{"$ref":"#/components/schemas/Token"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/me":{"get":{"tags":["auth"],"summary":"Me","operationId":"me_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}}}}},"/v1/admin/users":{"get":{"tags":["auth"],"summary":"List Users","operationId":"list_users_v1_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UserOut"},"type":"array","title":"Response List Users V1 Admin Users Get"}}}}}},"post":{"tags":["auth"],"summary":"Create User","operationId":"create_user_v1_admin_users_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/users/{user_id}":{"patch":{"tags":["auth"],"summary":"Update User","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/UserUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["auth"],"summary":"Delete User","operationId":"delete_user_v1_admin_users__user_id__delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys":{"get":{"tags":["auth"],"summary":"List Api Keys","operationId":"list_api_keys_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiKeyOut"},"type":"array","title":"Response List Api Keys V1 Api Keys Get"}}}}}},"post":{"tags":["auth"],"summary":"Create Api Key","operationId":"create_api_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}/revoke":{"post":{"tags":["auth"],"summary":"Revoke Api Key","operationId":"revoke_api_key_v1_api_keys__key_id__revoke_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}/rotate":{"post":{"tags":["auth"],"summary":"Rotate Api Key","operationId":"rotate_api_key_v1_api_keys__key_id__rotate_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models":{"get":{"tags":["inference"],"summary":"List Models","operationId":"list_models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/chat/completions":{"post":{"tags":["inference"],"summary":"Chat Completions","operationId":"chat_completions_v1_chat_completions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/embeddings":{"post":{"tags":["inference"],"summary":"Embeddings","operationId":"embeddings_v1_embeddings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage":{"get":{"tags":["inference"],"summary":"Usage","operationId":"usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/memory":{"post":{"tags":["memory"],"summary":"Create Memory","operationId":"create_memory_v1_memory_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["memory"],"summary":"List Memory","operationId":"list_memory_v1_memory_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","default":"","title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemoryOut"},"title":"Response List Memory V1 Memory Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/{memory_id}":{"delete":{"tags":["memory"],"summary":"Delete Memory","operationId":"delete_memory_v1_memory__memory_id__delete","parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/export":{"get":{"tags":["memory"],"summary":"Export Memory","operationId":"export_memory_v1_memory_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/knowledge/upload":{"post":{"tags":["knowledge"],"summary":"Upload Knowledge","operationId":"upload_knowledge_v1_knowledge_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_knowledge_v1_knowledge_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/knowledge":{"get":{"tags":["knowledge"],"summary":"List Knowledge","operationId":"list_knowledge_v1_knowledge_get","parameters":[{"name":"collection","in":"query","required":false,"schema":{"type":"string","default":"","title":"Collection"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/knowledge/search":{"get":{"tags":["knowledge"],"summary":"Search Knowledge","operationId":"search_knowledge_v1_knowledge_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"top_k","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Top K"}},{"name":"collection","in":"query","required":false,"schema":{"type":"string","default":"","title":"Collection"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/knowledge/{doc_id}/approve":{"post":{"tags":["knowledge"],"summary":"Approve Knowledge","operationId":"approve_knowledge_v1_knowledge__doc_id__approve_post","parameters":[{"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/knowledge/{doc_id}":{"delete":{"tags":["knowledge"],"summary":"Delete Knowledge","operationId":"delete_knowledge_v1_knowledge__doc_id__delete","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/providers":{"get":{"tags":["admin"],"summary":"List Providers","operationId":"list_providers_v1_admin_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["admin"],"summary":"Create Provider","operationId":"create_provider_v1_admin_providers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/providers/{provider_id}":{"patch":{"tags":["admin"],"summary":"Update Provider","operationId":"update_provider_v1_admin_providers__provider_id__patch","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Provider","operationId":"delete_provider_v1_admin_providers__provider_id__delete","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/providers/{provider_id}/test":{"post":{"tags":["admin"],"summary":"Test Provider","operationId":"test_provider_v1_admin_providers__provider_id__test_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/models":{"get":{"tags":["admin"],"summary":"Admin Models","operationId":"admin_models_v1_admin_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/models/pull":{"post":{"tags":["admin"],"summary":"Pull Model","operationId":"pull_model_v1_admin_models_pull_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/models/{model_name}":{"delete":{"tags":["admin"],"summary":"Delete Model","operationId":"delete_model_v1_admin_models__model_name__delete","parameters":[{"name":"model_name","in":"path","required":true,"schema":{"type":"string","title":"Model Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/research/sources":{"get":{"tags":["admin"],"summary":"List Sources","operationId":"list_sources_v1_admin_research_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["admin"],"summary":"Add Source","operationId":"add_source_v1_admin_research_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchSourceCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/research/sources/{source_id}":{"delete":{"tags":["admin"],"summary":"Delete Source","operationId":"delete_source_v1_admin_research_sources__source_id__delete","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","title":"Source Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/research/run":{"post":{"tags":["admin"],"summary":"Run Research Now","operationId":"run_research_now_v1_admin_research_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/research/runs":{"get":{"tags":["admin"],"summary":"List Runs","operationId":"list_runs_v1_admin_research_runs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/finetune/datasets":{"get":{"tags":["admin"],"summary":"List Datasets","operationId":"list_datasets_v1_admin_finetune_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["admin"],"summary":"Create Dataset","operationId":"create_dataset_v1_admin_finetune_datasets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/finetune/datasets/{dataset_id}/import":{"post":{"tags":["admin"],"summary":"Import Dataset","description":"Import JSONL rows: {\"messages\": [...]} or {\"prompt\":..,\"completion\":..}.","operationId":"import_dataset_v1_admin_finetune_datasets__dataset_id__import_post","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/finetune/datasets/{dataset_id}/export":{"get":{"tags":["admin"],"summary":"Export Dataset","operationId":"export_dataset_v1_admin_finetune_datasets__dataset_id__export_get","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/finetune/jobs":{"get":{"tags":["admin"],"summary":"List Jobs","operationId":"list_jobs_v1_admin_finetune_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["admin"],"summary":"Create Job","operationId":"create_job_v1_admin_finetune_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrainingJobCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/settings":{"get":{"tags":["admin"],"summary":"Get Settings Api","description":"Return all DB-backed settings. Secret values are masked.","operationId":"get_settings_api_v1_admin_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"put":{"tags":["admin"],"summary":"Update Settings","operationId":"update_settings_v1_admin_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/telegram/links":{"get":{"tags":["admin"],"summary":"List Telegram Links","operationId":"list_telegram_links_v1_admin_telegram_links_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/telegram/links/{link_id}":{"delete":{"tags":["admin"],"summary":"Delete Telegram Link","operationId":"delete_telegram_link_v1_admin_telegram_links__link_id__delete","parameters":[{"name":"link_id","in":"path","required":true,"schema":{"type":"string","title":"Link Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/telegram/test":{"post":{"tags":["admin"],"summary":"Telegram Test","operationId":"telegram_test_v1_admin_telegram_test_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/telegram/set-webhook":{"post":{"tags":["admin"],"summary":"Telegram Set Webhook","operationId":"telegram_set_webhook_v1_admin_telegram_set_webhook_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/telegram/status":{"get":{"tags":["admin"],"summary":"Telegram Status","description":"Diagnose \"the bot is not online\".\n\nA Telegram bot has no presence indicator: it only receives messages through\na registered webhook (this app does not poll). A valid token with no webhook\ntherefore looks like an offline bot. This endpoint reports both facts plus\nthe URL the webhook should point at.","operationId":"telegram_status_v1_admin_telegram_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/whatsapp/links":{"get":{"tags":["admin"],"summary":"List Whatsapp Links","operationId":"list_whatsapp_links_v1_admin_whatsapp_links_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/whatsapp/links/{link_id}":{"delete":{"tags":["admin"],"summary":"Delete Whatsapp Link","operationId":"delete_whatsapp_link_v1_admin_whatsapp_links__link_id__delete","parameters":[{"name":"link_id","in":"path","required":true,"schema":{"type":"string","title":"Link Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/whatsapp/test":{"post":{"tags":["admin"],"summary":"Whatsapp Test","operationId":"whatsapp_test_v1_admin_whatsapp_test_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/logs":{"get":{"tags":["admin"],"summary":"Get Logs","operationId":"get_logs_v1_admin_logs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/backup":{"post":{"tags":["admin"],"summary":"Trigger Backup","description":"Best-effort host backup trigger.\n\nFull backups (database + uploads + config) must be created on the VPS host\nwith ``sudo bash backup.sh`` because they need docker and host paths.\nThis endpoint runs the script when the container has it mounted, and\notherwise reports the exact command to run.","operationId":"trigger_backup_v1_admin_backup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/backup/export":{"get":{"tags":["admin"],"summary":"Export Data","description":"Portable JSON export of every logical table (restore-friendly, no binaries).\n\nSecrets are exported exactly as stored (encrypted provider keys, key hashes),\nso treat the file as sensitive.","operationId":"export_data_v1_admin_backup_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/telegram/webhook":{"get":{"tags":["telegram"],"summary":"Verify Webhook","operationId":"verify_webhook_v1_telegram_webhook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["telegram"],"summary":"Telegram Webhook","operationId":"telegram_webhook_v1_telegram_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/whatsapp/webhook":{"get":{"tags":["whatsapp"],"summary":"Verify Webhook","operationId":"verify_webhook_v1_whatsapp_webhook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["whatsapp"],"summary":"Whatsapp Webhook","operationId":"whatsapp_webhook_v1_whatsapp_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","description":"Liveness probe for Docker/Caddy — no auth, no database dependency.","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ApiKeyCreate":{"properties":{"name":{"type":"string","title":"Name","default":"default"},"daily_limit":{"type":"integer","title":"Daily Limit","default":1000},"monthly_limit":{"type":"integer","title":"Monthly Limit","default":10000},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"},"allowed_providers":{"items":{"type":"string"},"type":"array","title":"Allowed Providers","default":[]}},"type":"object","title":"ApiKeyCreate"},"ApiKeyCreated":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"is_active":{"type":"boolean","title":"Is Active"},"daily_limit":{"type":"integer","title":"Daily Limit"},"monthly_limit":{"type":"integer","title":"Monthly Limit"},"daily_used":{"type":"integer","title":"Daily Used"},"monthly_used":{"type":"integer","title":"Monthly Used"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"raw_key":{"type":"string","title":"Raw Key"}},"type":"object","required":["id","name","key_prefix","is_active","daily_limit","monthly_limit","daily_used","monthly_used","raw_key"],"title":"ApiKeyCreated"},"ApiKeyOut":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"is_active":{"type":"boolean","title":"Is Active"},"daily_limit":{"type":"integer","title":"Daily Limit"},"monthly_limit":{"type":"integer","title":"Monthly Limit"},"daily_used":{"type":"integer","title":"Daily Used"},"monthly_used":{"type":"integer","title":"Monthly Used"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["id","name","key_prefix","is_active","daily_limit","monthly_limit","daily_used","monthly_used"],"title":"ApiKeyOut"},"Body_upload_knowledge_v1_knowledge_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"collection":{"type":"string","title":"Collection","default":"default"},"is_global":{"type":"boolean","title":"Is Global","default":false}},"type":"object","required":["file"],"title":"Body_upload_knowledge_v1_knowledge_upload_post"},"ChatCompletionRequest":{"properties":{"model":{"type":"string","title":"Model","default":"auto"},"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","title":"Messages"},"temperature":{"type":"number","title":"Temperature","default":0.7},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens"},"stream":{"type":"boolean","title":"Stream","default":false},"use_rag":{"type":"boolean","title":"Use Rag","default":false},"collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection"},"top_k":{"type":"integer","title":"Top K","default":5}},"type":"object","required":["messages"],"title":"ChatCompletionRequest"},"ChatMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"}},"type":"object","required":["role","content"],"title":"ChatMessage"},"DatasetCreate":{"properties":{"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version","default":"v1"}},"type":"object","required":["name"],"title":"DatasetCreate"},"EmbeddingRequest":{"properties":{"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Input"},"model":{"type":"string","title":"Model","default":"embedding"}},"type":"object","required":["input"],"title":"EmbeddingRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"MemoryCreate":{"properties":{"kind":{"type":"string","title":"Kind","default":"fact"},"content":{"type":"string","title":"Content"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"}},"type":"object","required":["content"],"title":"MemoryCreate"},"MemoryOut":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind"},"content":{"type":"string","title":"Content"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","kind","content","created_at"],"title":"MemoryOut"},"ProviderCreate":{"properties":{"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","default":"openai_compatible"},"base_url":{"type":"string","title":"Base Url"},"api_key":{"type":"string","title":"Api Key","default":""},"models":{"items":{"type":"string"},"type":"array","title":"Models","default":[]},"priority":{"type":"integer","title":"Priority","default":100},"is_enabled":{"type":"boolean","title":"Is Enabled","default":true},"timeout_seconds":{"type":"number","title":"Timeout Seconds","default":60.0},"max_retries":{"type":"integer","title":"Max Retries","default":2},"cost_per_1k_input":{"type":"number","title":"Cost Per 1K Input","default":0.0},"cost_per_1k_output":{"type":"number","title":"Cost Per 1K Output","default":0.0}},"type":"object","required":["name","base_url"],"title":"ProviderCreate"},"ProviderUpdate":{"properties":{"base_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Url"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Models"},"priority":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Priority"},"is_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Enabled"},"timeout_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Timeout Seconds"},"max_retries":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Retries"},"cost_per_1k_input":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost Per 1K Input"},"cost_per_1k_output":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost Per 1K Output"}},"type":"object","title":"ProviderUpdate"},"ResearchSourceCreate":{"properties":{"url":{"type":"string","title":"Url"},"kind":{"type":"string","title":"Kind","default":"website"},"trust_level":{"type":"string","title":"Trust Level","default":"web"}},"type":"object","required":["url"],"title":"ResearchSourceCreate"},"SettingUpdate":{"properties":{"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["key","value"],"title":"SettingUpdate"},"Token":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"}},"type":"object","required":["access_token"],"title":"Token"},"TrainingJobCreate":{"properties":{"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"name":{"type":"string","title":"Name"},"method":{"type":"string","title":"Method","default":"lora"},"base_model":{"type":"string","title":"Base Model","default":""},"config":{"type":"object","title":"Config","default":{}}},"type":"object","required":["name"],"title":"TrainingJobCreate"},"UserCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"},"role":{"type":"string","enum":["super_admin","admin","user"],"title":"Role","default":"user"},"display_name":{"type":"string","title":"Display Name","default":""}},"type":"object","required":["email","password"],"title":"UserCreate"},"UserOut":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"display_name":{"type":"string","title":"Display Name"}},"type":"object","required":["id","email","role","is_active","display_name"],"title":"UserOut"},"UserUpdate":{"properties":{"role":{"anyOf":[{"type":"string","enum":["super_admin","admin","user"]},{"type":"null"}],"title":"Role"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","title":"UserUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}