MedhaOS is the Governed Enterprise AI Engine—a white-label AI operating layer that enables SaaS companies to embed semantic search, RAG (Retrieval Augmented Generation), and autonomous agents with strict governance and audit trails.

Is MedhaOS secure for regulated industries?

Yes. MedhaOS is designed for finance and legal sectors, offering strict tenant isolation, immutable JSON-based audit logs, and PII redaction to ensure data sovereignty.

Can I white-label MedhaOS?

Yes. MedhaOS is a white-label solution. You can deploy it under your own domain and branding to provide AI capabilities to your customers without building infrastructure from scratch.

Developer documentation

API reference, SDK integration, and supported formats. Start with onboarding or browse the guides below.

Guides

AI capabilities

The API uses capability-based model selection. Use these IDs when calling AI endpoints.

Loading supported capabilities…

API reference

Endpoints are loaded from the OpenAPI spec. For request/response schemas, use the interactive docs below.

Try it

Admin: POST/api/v1/medha-os/admin/ingestion/web/run— Run Web Ingestion
POST/api/v1/medha-os/admin/ingestion/web/run— Run Web Ingestion
GET/api/v1/medha-os/admin/config— Get Configs
GET/api/v1/medha-os/admin/config— Get Configs
POST/api/v1/medha-os/admin/config— Set Config
POST/api/v1/medha-os/admin/config— Set Config
GET/api/v1/medha-os/admin/config/list— List Configs
GET/api/v1/medha-os/admin/config/list— List Configs
GET/api/v1/medha-os/admin/config/{config_key}— Get Config
GET/api/v1/medha-os/admin/config/{config_key}— Get Config
+158 more. See OpenAPI for full list.
AI: GET/api/v1/medha-os/ai/intent/schema— Get Intent Schema
GET/api/v1/medha-os/ai/intent/schema— Get Intent Schema
GET/api/v1/medha-os/ai/identity— Get Identity
GET/api/v1/medha-os/ai/identity— Get Identity
POST/api/v1/medha-os/ai/files/guest— Upload file for guest chat
POST/api/v1/medha-os/ai/files/guest— Upload file for guest chat
GET/api/v1/medha-os/ai/files/guest/{file_id}— Download guest file
GET/api/v1/medha-os/ai/files/guest/{file_id}— Download guest file
POST/api/v1/medha-os/ai/chat/guest— Public guest chat
POST/api/v1/medha-os/ai/chat/guest— Public guest chat
+194 more. See OpenAPI for full list.
AI Execution: POST/api/v1/medha-os/ai/execute— Execute AI Operation
POST/api/v1/medha-os/ai/execute— Execute AI Operation
POST/api/v1/ai/execute— Execute AI Operation
POST/api/v1/ai/execute— Execute AI Operation
Assistant: POST/api/v1/medha-os/assistant/chat— Chat with Assistant
POST/api/v1/medha-os/assistant/chat— Chat with Assistant
GET/api/v1/medha-os/assistant/capabilities— Get Assistant Capabilities
GET/api/v1/medha-os/assistant/capabilities— Get Assistant Capabilities
GET/api/v1/medha-os/assistant/conversations— List Conversations
GET/api/v1/medha-os/assistant/conversations— List Conversations
GET/api/v1/medha-os/assistant/conversations/{conversation_id}— Get Conversation
GET/api/v1/medha-os/assistant/conversations/{conversation_id}— Get Conversation
DELETE/api/v1/medha-os/assistant/conversations/{conversation_id}— Delete Conversation
DELETE/api/v1/medha-os/assistant/conversations/{conversation_id}— Delete Conversation
+10 more. See OpenAPI for full list.
Audit: GET/api/v1/medha-os/audit/cases/{case_id}— Get Audit Trail for Case
GET/api/v1/medha-os/audit/cases/{case_id}— Get Audit Trail for Case
GET/api/v1/medha-os/audit/export/{case_id}— Export Audit Trail
GET/api/v1/medha-os/audit/export/{case_id}— Export Audit Trail
GET/api/v1/medha-os/audit/verify/{case_id}— Verify Audit Trail Hash Chain
GET/api/v1/medha-os/audit/verify/{case_id}— Verify Audit Trail Hash Chain
GET/api/v1/medha-os/audit— List Audit Events
GET/api/v1/medha-os/audit— List Audit Events
GET/api/v1/audit/cases/{case_id}— Get Audit Trail for Case
GET/api/v1/audit/cases/{case_id}— Get Audit Trail for Case
+6 more. See OpenAPI for full list.
Auth: POST/api/v1/medha-os/auth/login— Login
POST/api/v1/medha-os/auth/login— Login
POST/api/v1/medha-os/auth/logout— Logout
POST/api/v1/medha-os/auth/logout— Logout
GET/api/v1/medha-os/auth/oauth/login— Oauth Login
GET/api/v1/medha-os/auth/oauth/login— Oauth Login
GET/api/v1/medha-os/auth/oauth/callback— Oauth Callback
GET/api/v1/medha-os/auth/oauth/callback— Oauth Callback
POST/api/v1/medha-os/auth/oauth/logout— Oauth Logout
POST/api/v1/medha-os/auth/oauth/logout— Oauth Logout
+10 more. See OpenAPI for full list.
Chat: POST/api/v1/chat/message— Chat Message
Data Export: POST/api/v1/medha-os/data/export— Export All Tenant Data
POST/api/v1/medha-os/data/export— Export All Tenant Data
POST/api/v1/data/export— Export All Tenant Data
POST/api/v1/data/export— Export All Tenant Data
Data Ingestion: POST/api/v1/medha-os/ingestion/urls— Ingest Urls
POST/api/v1/medha-os/ingestion/urls— Ingest Urls
POST/api/v1/medha-os/ingestion/files— Ingest Files
POST/api/v1/medha-os/ingestion/files— Ingest Files
POST/api/v1/medha-os/ingestion/structured— Ingest Structured
POST/api/v1/medha-os/ingestion/structured— Ingest Structured
GET/api/v1/medha-os/ingestion/jobs— List Ingestion Jobs
GET/api/v1/medha-os/ingestion/jobs— List Ingestion Jobs
GET/api/v1/medha-os/ingestion/status— Get Tenant Ingestion Status
GET/api/v1/medha-os/ingestion/status— Get Tenant Ingestion Status
+18 more. See OpenAPI for full list.
Evals: POST/api/v1/medha-os/evals/run— Run Eval
POST/api/v1/medha-os/evals/run— Run Eval
POST/api/v1/medha-os/evals/compare— Compare Evals
POST/api/v1/medha-os/evals/compare— Compare Evals
GET/api/v1/medha-os/evals/results— List Eval Results
GET/api/v1/medha-os/evals/results— List Eval Results
POST/api/v1/evals/run— Run Eval
POST/api/v1/evals/run— Run Eval
POST/api/v1/evals/compare— Compare Evals
POST/api/v1/evals/compare— Compare Evals
+2 more. See OpenAPI for full list.
Feedback: POST/api/v1/medha-os/feedback/guest— Submit Guest Feedback
POST/api/v1/medha-os/feedback/guest— Submit Guest Feedback
POST/api/v1/medha-os/feedback— Submit Feedback
POST/api/v1/medha-os/feedback— Submit Feedback
GET/api/v1/medha-os/feedback— List Feedback
GET/api/v1/medha-os/feedback— List Feedback
GET/api/v1/medha-os/feedback/admin— List Feedback Admin
GET/api/v1/medha-os/feedback/admin— List Feedback Admin
POST/api/v1/medha-os/feedback/analyze— Analyze Feedback
POST/api/v1/medha-os/feedback/analyze— Analyze Feedback
+14 more. See OpenAPI for full list.
Kill Switches: POST/api/v1/medha-os/kill-switches/ai/disable— Disable AI Globally
POST/api/v1/medha-os/kill-switches/ai/disable— Disable AI Globally
POST/api/v1/medha-os/kill-switches/ai/enable— Enable AI Globally
POST/api/v1/medha-os/kill-switches/ai/enable— Enable AI Globally
POST/api/v1/medha-os/kill-switches/models/{model_version}/disable— Disable Model
POST/api/v1/medha-os/kill-switches/models/{model_version}/disable— Disable Model
POST/api/v1/medha-os/kill-switches/models/{model_version}/enable— Enable Model
POST/api/v1/medha-os/kill-switches/models/{model_version}/enable— Enable Model
POST/api/v1/medha-os/kill-switches/tenants/{tenant_id}/disable— Disable AI for Tenant
POST/api/v1/medha-os/kill-switches/tenants/{tenant_id}/disable— Disable AI for Tenant
+18 more. See OpenAPI for full list.
Metrics: GET/api/v1/medha-os/metrics/ai— AI Metrics
GET/api/v1/medha-os/metrics/ai— AI Metrics
GET/api/v1/medha-os/metrics/sla— SLA Metrics
GET/api/v1/medha-os/metrics/sla— SLA Metrics
GET/api/v1/medha-os/metrics/drift— Drift alerts
GET/api/v1/medha-os/metrics/drift— Drift alerts
GET/api/v1/metrics/ai— AI Metrics
GET/api/v1/metrics/ai— AI Metrics
GET/api/v1/metrics/sla— SLA Metrics
GET/api/v1/metrics/sla— SLA Metrics
+2 more. See OpenAPI for full list.
Models: POST/api/v1/medha-os/models— Create Model
POST/api/v1/medha-os/models— Create Model
GET/api/v1/medha-os/models— List Models
GET/api/v1/medha-os/models— List Models
GET/api/v1/medha-os/models/ab-tests— List Ab Tests
GET/api/v1/medha-os/models/ab-tests— List Ab Tests
GET/api/v1/medha-os/models/{model_id}— Get Model
GET/api/v1/medha-os/models/{model_id}— Get Model
POST/api/v1/medha-os/models/{model_id}/versions— Create Version
POST/api/v1/medha-os/models/{model_id}/versions— Create Version
+42 more. See OpenAPI for full list.
Onboarding: POST/api/v1/medha-os/onboard— Onboard Tenant
POST/api/v1/medha-os/onboard— Onboard Tenant
GET/api/v1/medha-os/onboard/status/{tenant_id}— Get Onboarding Status
GET/api/v1/medha-os/onboard/status/{tenant_id}— Get Onboarding Status
POST/api/v1/medha-os/onboard/verify-domain— Verify Domain
POST/api/v1/medha-os/onboard/verify-domain— Verify Domain
POST/api/v1/medha-os/onboard/domains— Register Domain
POST/api/v1/medha-os/onboard/domains— Register Domain
GET/api/v1/medha-os/onboard/domains— List Domains
GET/api/v1/medha-os/onboard/domains— List Domains
+26 more. See OpenAPI for full list.
Orchestration: GET/api/v1/medha-os/intent/schema— Get Intent Schema
GET/api/v1/medha-os/identity— Get Identity
GET/api/v1/intent/schema— Get Intent Schema
GET/api/v1/identity— Get Identity
Payment: POST/api/v1/medha-os/payment/create— Create Payment
POST/api/v1/medha-os/payment/create— Create Payment
GET/api/v1/medha-os/payment/status/{payment_id}— Get Payment Status
GET/api/v1/medha-os/payment/status/{payment_id}— Get Payment Status
GET/api/v1/medha-os/payment/status/order/{merchant_order_id}— Get Payment Status By Order
GET/api/v1/medha-os/payment/status/order/{merchant_order_id}— Get Payment Status By Order
POST/api/v1/medha-os/payment/callback— Handle Payment Callback
POST/api/v1/medha-os/payment/callback— Handle Payment Callback
POST/api/v1/medha-os/payment/refund— Process Refund
POST/api/v1/medha-os/payment/refund— Process Refund
+10 more. See OpenAPI for full list.
PDF Ops: POST/api/v1/medha-os/pdf/merge— Pdf Merge
POST/api/v1/medha-os/pdf/split— Pdf Split
POST/api/v1/medha-os/pdf/split-bookmarks— Pdf Split Bookmarks
POST/api/v1/medha-os/pdf/split-size— Pdf Split Size
POST/api/v1/medha-os/pdf/split-count— Pdf Split Count
POST/api/v1/medha-os/pdf/compare— Pdf Compare
POST/api/v1/medha-os/pdf/overlay-mode— Pdf Overlay Mode
POST/api/v1/medha-os/pdf/convert— Pdf Convert Generic
POST/api/v1/medha-os/edit/replace-text— Replace Text
POST/api/v1/medha-os/edit/replace-image— Replace Image
+250 more. See OpenAPI for full list.
Policy: POST/api/v1/medha-os/policy/check— Policy Check
POST/api/v1/medha-os/policy/check— Policy Check
GET/api/v1/medha-os/policy/packs— List Policy Packs
GET/api/v1/medha-os/policy/packs— List Policy Packs
POST/api/v1/medha-os/policy/packs— Create Policy Pack
POST/api/v1/medha-os/policy/packs— Create Policy Pack
POST/api/v1/medha-os/policy/packs/{pack_id}/activate— Activate Policy Pack
POST/api/v1/medha-os/policy/packs/{pack_id}/activate— Activate Policy Pack
POST/api/v1/policy/check— Policy Check
POST/api/v1/policy/check— Policy Check
+6 more. See OpenAPI for full list.
Preflight: GET/api/v1/medha-os/preflight— Preflight check
GET/api/v1/medha-os/preflight— Preflight check
GET/api/v1/preflight— Preflight check
GET/api/v1/preflight— Preflight check
Prompts: GET/api/v1/medha-os/prompts/{prompt_id}— Get Latest Approved Prompt
GET/api/v1/medha-os/prompts/{prompt_id}— Get Latest Approved Prompt
POST/api/v1/medha-os/prompts/{prompt_id}/versions— Create Prompt Version
POST/api/v1/medha-os/prompts/{prompt_id}/versions— Create Prompt Version
POST/api/v1/medha-os/prompts/{prompt_id}/versions/{version}/approve— Approve Prompt Version
POST/api/v1/medha-os/prompts/{prompt_id}/versions/{version}/approve— Approve Prompt Version
GET/api/v1/medha-os/prompts— List Prompt Versions
GET/api/v1/medha-os/prompts— List Prompt Versions
GET/api/v1/prompts/{prompt_id}— Get Latest Approved Prompt
GET/api/v1/prompts/{prompt_id}— Get Latest Approved Prompt
+6 more. See OpenAPI for full list.
Readiness: GET/api/v1/medha-os/readiness— Get Enterprise Readiness Score
GET/api/v1/medha-os/readiness— Get Enterprise Readiness Score
GET/api/v1/readiness— Get Enterprise Readiness Score
GET/api/v1/readiness— Get Enterprise Readiness Score
Registry: POST/api/v1/medha-os/registry/models— Create Provider Model
POST/api/v1/medha-os/registry/models— Create Provider Model
GET/api/v1/medha-os/registry/models— List Provider Models
GET/api/v1/medha-os/registry/models— List Provider Models
GET/api/v1/medha-os/registry/models/{model_id}— Get Provider Model
GET/api/v1/medha-os/registry/models/{model_id}— Get Provider Model
PATCH/api/v1/medha-os/registry/models/{model_id}— Update Provider Model
PATCH/api/v1/medha-os/registry/models/{model_id}— Update Provider Model
DELETE/api/v1/medha-os/registry/models/{model_id}— Delete Provider Model
DELETE/api/v1/medha-os/registry/models/{model_id}— Delete Provider Model
+30 more. See OpenAPI for full list.
sastra: GET/api/v1/sastra/conversations/{conversation_id}— Get Conversation
POST/api/v1/sastra/conversations— Create Conversation
POST/api/v1/sastra/messages— Add Message
POST/api/v1/sastra/leads— Create Lead
POST/api/v1/sastra/continue-chat— Continue Chat
Sastra: GET/api/v1/sastra/conversations/{conversation_id}— Get Conversation
POST/api/v1/sastra/conversations— Create Conversation
POST/api/v1/sastra/messages— Add Message
POST/api/v1/sastra/leads— Create Lead
POST/api/v1/sastra/continue-chat— Continue Chat
SCIM: GET/api/v1/medha-os/scim/v2/Users— List Users
GET/api/v1/medha-os/scim/v2/Users— List Users
POST/api/v1/medha-os/scim/v2/Users— Create User
POST/api/v1/medha-os/scim/v2/Users— Create User
GET/api/v1/medha-os/scim/v2/Users/{user_id}— Get User
GET/api/v1/medha-os/scim/v2/Users/{user_id}— Get User
PUT/api/v1/medha-os/scim/v2/Users/{user_id}— Update User
PUT/api/v1/medha-os/scim/v2/Users/{user_id}— Update User
PATCH/api/v1/medha-os/scim/v2/Users/{user_id}— Patch User
PATCH/api/v1/medha-os/scim/v2/Users/{user_id}— Patch User
+26 more. See OpenAPI for full list.
Search: GET/api/v1/medha-os/search/history— Get Search History
GET/api/v1/medha-os/search/history— Get Search History
DELETE/api/v1/medha-os/search/history— Clear Search History
DELETE/api/v1/medha-os/search/history— Clear Search History
GET/api/v1/medha-os/search/suggestions— Get Search Suggestions
GET/api/v1/medha-os/search/suggestions— Get Search Suggestions
GET/api/v1/search/history— Get Search History
GET/api/v1/search/history— Get Search History
DELETE/api/v1/search/history— Clear Search History
DELETE/api/v1/search/history— Clear Search History
+2 more. See OpenAPI for full list.
Similarity: POST/api/v1/medha-os/similarity/calculate— Calculate Document Similarity
POST/api/v1/medha-os/similarity/calculate— Calculate Document Similarity
GET/api/v1/medha-os/similarity/{file_id}— Find Similar Documents
GET/api/v1/medha-os/similarity/{file_id}— Find Similar Documents
POST/api/v1/similarity/calculate— Calculate Document Similarity
POST/api/v1/similarity/calculate— Calculate Document Similarity
GET/api/v1/similarity/{file_id}— Find Similar Documents
GET/api/v1/similarity/{file_id}— Find Similar Documents
Tables: POST/api/v1/medha-os/tables/recognize— Recognize Tables in Document
POST/api/v1/medha-os/tables/recognize— Recognize Tables in Document
GET/api/v1/medha-os/tables/{file_id}— Get Tables from Document
GET/api/v1/medha-os/tables/{file_id}— Get Tables from Document
POST/api/v1/tables/recognize— Recognize Tables in Document
POST/api/v1/tables/recognize— Recognize Tables in Document
GET/api/v1/tables/{file_id}— Get Tables from Document
GET/api/v1/tables/{file_id}— Get Tables from Document
training: POST/api/v1/medha-os/training/start— Start Training
GET/api/v1/medha-os/training/status/{job_id}— Get Training Status
GET/api/v1/medha-os/training/jobs— List Training Jobs
GET/api/v1/medha-os/training/checkpoints— List Checkpoints
POST/api/v1/medha-os/training/jobs/{job_id}/sync-to-s3— Sync Job Output To S3
GET/api/v1/medha-os/training/s3-datasets— List S3 Datasets
GET/api/v1/medha-os/training/dataset-links— Get Dataset Links
POST/api/v1/medha-os/training/dataset-links— Add Dataset Link
DELETE/api/v1/medha-os/training/dataset-links— Remove Dataset Link
POST/api/v1/training/start— Start Training
+8 more. See OpenAPI for full list.
Training: POST/api/v1/medha-os/training/start— Start Training
GET/api/v1/medha-os/training/status/{job_id}— Get Training Status
GET/api/v1/medha-os/training/jobs— List Training Jobs
GET/api/v1/medha-os/training/checkpoints— List Checkpoints
POST/api/v1/medha-os/training/jobs/{job_id}/sync-to-s3— Sync Job Output To S3
GET/api/v1/medha-os/training/s3-datasets— List S3 Datasets
GET/api/v1/medha-os/training/dataset-links— Get Dataset Links
POST/api/v1/medha-os/training/dataset-links— Add Dataset Link
DELETE/api/v1/medha-os/training/dataset-links— Remove Dataset Link
POST/api/v1/training/start— Start Training
+8 more. See OpenAPI for full list.

Quick links

Try it Onboarding API health OpenAPI (Swagger)ReDoc