> ## Documentation Index
> Fetch the complete documentation index at: https://developer.eka.care/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration reference

> Every option in MedAssistConfig

`MedAssistConfig` is the optional third argument to [`renderMedAssist`](https://developer.eka.care/docs/agents/medassist/synapse/react/installation#api). Every field is optional — anything you omit falls back to the agent config you set in [console.eka.care](https://console.eka.care).

## MedAssistConfig

**title** `string` (default: Medi Clinic)

Header text shown to the user.

**iconUrl** `string` (default: [https://cdn.eka.care/bot-icon.svg](https://cdn.eka.care/bot-icon.svg))

Icon URL for the widget launcher.

**environment** `"development" | "staging" | "production"` (default: production)

Which backend environment to connect to.

**baseUrl** `string`

Custom API base URL. Only used in development mode.

**auth** `string`

Auth token sent when the session is created.

**authToken** `string`

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

**context** `TContext`

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

**connectionType** `"socket" | "sse"`

Real-time transport. Usually inherited from agent config.

**displayMode** `"full" | "widget"` (default: widget)

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

**resize** `boolean`

Show a resize toggle in the header.

**allowed** `Array\<"text" | "file" | "audio" | "voice"\>`

Input types to show. Omit to show all.

**initialMessage** `TInitialMessage`

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

**hideWatermark** `boolean` (default: false)

Hide the "Powered by Eka Care" footer branding.

**onClose** `() =\> void`

Callback fired when the user closes the widget.

**showCloseButton** `boolean` (default: true)

Show the close (✕) button in the header.

**theme** `object`

Brand colors and styling. See [Theming & design system](https://developer.eka.care/docs/agents/medassist/synapse/react/theming.md).

## 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

```tsx theme={null}
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);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.