# API Documentation

The mnx Object

Include the `mnx` object in your request body to control Mnexium features:

### Parameters

| Parameter        | Type         | Description |
|------------------|--------------|-------------|
| `subject_id`     | string       | Identifies the end-user. Auto-generated with `subj_` prefix if omitted. |
| `chat_id`        | string       | Conversation identifier (UUID). Auto-generated if omitted. |
| `log`            | boolean      | Save messages to chat history. Default: `true` |
| `learn`          | boolean \/ 'force' | Memory extraction: `true` (LLM decides), `"force"` (always), `false` (never). Default: `true` |
| `recall`         | boolean      | Inject relevant stored memories into context. Searches memories for this subject and adds matching ones to the system prompt. Default: `false` |
| `history`        | boolean      | Prepend previous messages from this chat. Default: `true` |
| `summarize`      | boolean \/ string | Enable conversation summarization to reduce token costs. Use preset modes: `"light"`, `"balanced"`, or `"aggressive"`. Default: `false` |
| `system_prompt`   | boolean \/ string | `true` (auto-resolve, default), `false` (skip injection), or a prompt ID like `"sp_abc"` for explicit selection. |
| `memory_policy`  | boolean \/ string | `true / omitted` (auto-resolve default policy by scope), `false` (disable memory policy), or a policy ID like `"mp_support_assistant"` for explicit selection. |
| `metadata`       | object       | Custom metadata attached to saved logs. |