Configuration reference

MedAssistConfig is the optional third argument to renderMedAssist. Every field is optional — anything you omit falls back to the agent config you set in console.eka.care.

MedAssistConfig

string

default:"Medi Clinic"

Header text shown to the user.

string

default:"https://cdn.eka.care/bot-icon.svg"

Icon URL for the widget launcher.

"development" | "staging" | "production"

default:"production"

Which backend environment to connect to.

string

Custom API base URL. Only used in development mode.

string

Auth token sent when the session is created.

string

Sent as the x-auth-token header on the create-session API call.

TContext

Key-value context object sent with the session to the backend. Used by the agent and its tools.

"socket" | "sse"

Real-time transport. Usually inherited from agent config.

"full" | "widget"

default:"widget"

full is fullscreen; widget is a floating window. Mobile always uses the widget layout.

boolean

Show a resize toggle in the header.

Array<"text" | "file" | "audio" | "voice">

Input types to show. Omit to show all.

TInitialMessage

A pre-loaded greeting and suggestion pills shown before the user types.

boolean

default:"false"

Hide the “Powered by Eka Care” footer branding.

() => void

Callback fired when the user closes the widget.

boolean

default:"true"

Show the close (✕) button in the header.

object

Brand colors and styling. See Theming & design system.

How config maps to the console

Many fields can be set either here or on the agent in the console. When both exist, the agent config seeds the defaults and your config overrides them.

Field	Console relationship
`agentId`	Resolves the agent’s config — name, theme, allowed inputs, nudges, initial message.
`environment`	Selects which backend (dev/staging/prod) hosts the agent.
`context`	Passed to the backend session; used by the agent and tool chain.
`theme`	Seeded from the agent config’s theme, overridable here.
`initialMessage`	Can come from the agent’s configured greeting and suggestion pills.
`allowed`	Input-type restrictions can also be sourced from the agent config.

Example

const config: MedAssistConfig = {
  title: "Moolchand Assist",
  environment: "production",
  displayMode: "widget",
  allowed: ["text", "file", "audio"],
  hideWatermark: true,
  theme: {
    primary: "#6B5CE0",
    mode: "light",
    headerTinted: true,
  },
  context: { intent: "general_query" },
  onClose: () => console.log("closed"),
};

renderMedAssist(container, "YOUR_AGENT_ID", config);

Authorization

End-to-End Encryption

Connect

HealthAI

Medical Database

ABDM Connect

Doctor Tool

Medical Knowledge-bases

Medical Records

User App

MedAssistConfig

How config maps to the console

Example

​MedAssistConfig

​How config maps to the console

​Example

MedAssistConfig

How config maps to the console

Example