mavenagi 1.1.0 → 1.2.0

package/reference.md

@@ -2,6 +2,54 @@
 
 ## Actions
 
+<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">search</a>({ ...params }) -> MavenAGI.ActionsResponse</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.actions.search({});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ActionsSearchRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Actions.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.ActionResponse</code></summary>
 <dl>
 <dd>
@@ -88,7 +136,7 @@ await client.actions.createOrUpdate({
 </dl>
 </details>
 
-<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">get</a>(actionReferenceId) -> MavenAGI.ActionResponse</code></summary>
+<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">get</a>(actionReferenceId, { ...params }) -> MavenAGI.ActionResponse</code></summary>
 <dl>
 <dd>
 
@@ -140,6 +188,14 @@ await client.actions.get("get-balance");
 <dl>
 <dd>
 
+**request:** `MavenAGI.ActionGetRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `Actions.RequestOptions`
 
 </dd>
@@ -151,7 +207,7 @@ await client.actions.get("get-balance");
 </dl>
 </details>
 
-<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">delete</a>(actionReferenceId) -> void</code></summary>
+<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">patch</a>(actionReferenceId, { ...params }) -> MavenAGI.ActionResponse</code></summary>
 <dl>
 <dd>
 
@@ -163,7 +219,10 @@ await client.actions.get("get-balance");
 <dl>
 <dd>
 
-Delete an action
+Update mutable action fields
+
+The `appId` field can be provided to update an action owned by a different app.
+All other fields will overwrite the existing value on the action only if provided.
 
 </dd>
 </dl>
@@ -179,7 +238,7 @@ Delete an action
 <dd>
 
 ```typescript
-await client.actions.delete("get-balance");
+await client.actions.patch("actionReferenceId", {});
 ```
 
 </dd>
@@ -195,7 +254,15 @@ await client.actions.delete("get-balance");
 <dl>
 <dd>
 
-**actionReferenceId:** `string` — The reference ID of the action to unregister. All other entity ID fields are inferred from the request.
+**actionReferenceId:** `string` — The reference ID of the action to patch.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ActionPatchRequest`
 
 </dd>
 </dl>
@@ -214,9 +281,7 @@ await client.actions.delete("get-balance");
 </dl>
 </details>
 
-## Agents
-
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">search</a>({ ...params }) -> MavenAGI.AgentsSearchResponse</code></summary>
+<details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">delete</a>(actionReferenceId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -228,11 +293,8 @@ await client.actions.delete("get-balance");
 <dl>
 <dd>
 
-Search for agents across all organizations.
+Delete an action
 
-<Tip>
-This endpoint requires additional permissions. Contact support to request access.
-</Tip>
 </dd>
 </dl>
 </dd>
@@ -247,7 +309,7 @@ This endpoint requires additional permissions. Contact support to request access
 <dd>
 
 ```typescript
-await client.agents.search({});
+await client.actions.delete("get-balance");
 ```
 
 </dd>
@@ -263,7 +325,7 @@ await client.agents.search({});
 <dl>
 <dd>
 
-**request:** `MavenAGI.AgentsSearchRequest`
+**actionReferenceId:** `string` — The reference ID of the action to unregister. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -271,7 +333,7 @@ await client.agents.search({});
 <dl>
 <dd>
 
-**requestOptions:** `Agents.RequestOptions`
+**requestOptions:** `Actions.RequestOptions`
 
 </dd>
 </dl>
@@ -282,7 +344,9 @@ await client.agents.search({});
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">list</a>(organizationReferenceId) -> MavenAGI.Agent[]</code></summary>
+## Agents
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">search</a>({ ...params }) -> MavenAGI.AgentsSearchResponse</code></summary>
 <dl>
 <dd>
 
@@ -294,8 +358,11 @@ await client.agents.search({});
 <dl>
 <dd>
 
-Lists all agents for an organization
+Search for agents across all organizations.
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -310,7 +377,7 @@ Lists all agents for an organization
 <dd>
 
 ```typescript
-await client.agents.list("organizationReferenceId");
+await client.agents.search({});
 ```
 
 </dd>
@@ -326,7 +393,7 @@ await client.agents.list("organizationReferenceId");
 <dl>
 <dd>
 
-**organizationReferenceId:** `string` — The ID of the organization.
+**request:** `MavenAGI.AgentsSearchRequest`
 
 </dd>
 </dl>
@@ -345,7 +412,7 @@ await client.agents.list("organizationReferenceId");
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">get</a>(organizationReferenceId, agentReferenceId) -> MavenAGI.Agent</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">list</a>(organizationReferenceId) -> MavenAGI.Agent[]</code></summary>
 <dl>
 <dd>
 
@@ -357,7 +424,7 @@ await client.agents.list("organizationReferenceId");
 <dl>
 <dd>
 
-Get an agent
+Lists all agents for an organization
 
 </dd>
 </dl>
@@ -373,7 +440,7 @@ Get an agent
 <dd>
 
 ```typescript
-await client.agents.get("organizationReferenceId", "agentReferenceId");
+await client.agents.list("organizationReferenceId");
 ```
 
 </dd>
@@ -397,14 +464,6 @@ await client.agents.get("organizationReferenceId", "agentReferenceId");
 <dl>
 <dd>
 
-**agentReferenceId:** `string` — The ID of the agent.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `Agents.RequestOptions`
 
 </dd>
@@ -416,9 +475,7 @@ await client.agents.get("organizationReferenceId", "agentReferenceId");
 </dl>
 </details>
 
-## Analytics
-
-<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getConversationTable</a>({ ...params }) -> MavenAGI.ConversationTableResponse</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">create</a>(organizationReferenceId, agentReferenceId, { ...params }) -> MavenAGI.Agent</code></summary>
 <dl>
 <dd>
 
@@ -430,8 +487,11 @@ await client.agents.get("organizationReferenceId", "agentReferenceId");
 <dl>
 <dd>
 
-Retrieves structured conversation data formatted as a table, allowing users to group, filter, and define specific metrics to display as columns.
+Create a new agent
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -446,39 +506,9 @@ Retrieves structured conversation data formatted as a table, allowing users to g
 <dd>
 
 ```typescript
-await client.analytics.getConversationTable({
-    conversationFilter: {
-        languages: ["en", "es"],
-    },
-    timeGrouping: "DAY",
-    fieldGroupings: [
-        {
-            field: "Category",
-        },
-    ],
-    columnDefinitions: [
-        {
-            header: "count",
-            metric: {
-                type: "count",
-            },
-        },
-        {
-            header: "avg_first_response_time",
-            metric: {
-                type: "average",
-                targetField: "FirstResponseTime",
-            },
-        },
-        {
-            header: "percentile_handle_time",
-            metric: {
-                type: "percentile",
-                targetField: "HandleTime",
-                percentile: 25,
-            },
-        },
-    ],
+await client.agents.create("organizationReferenceId", "agentReferenceId", {
+    name: "name",
+    environment: "DEMO",
 });
 ```
 
@@ -495,7 +525,7 @@ await client.analytics.getConversationTable({
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationTableRequest`
+**organizationReferenceId:** `string` — The ID of the organization.
 
 </dd>
 </dl>
@@ -503,7 +533,23 @@ await client.analytics.getConversationTable({
 <dl>
 <dd>
 
-**requestOptions:** `Analytics.RequestOptions`
+**agentReferenceId:** `string` — The ID of the agent.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.CreateAgentRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
 
 </dd>
 </dl>
@@ -514,7 +560,7 @@ await client.analytics.getConversationTable({
 </dl>
 </details>
 
-<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getConversationChart</a>({ ...params }) -> MavenAGI.ChartResponse</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">get</a>(organizationReferenceId, agentReferenceId) -> MavenAGI.Agent</code></summary>
 <dl>
 <dd>
 
@@ -526,7 +572,7 @@ await client.analytics.getConversationTable({
 <dl>
 <dd>
 
-Fetches conversation data visualized in a chart format. Supported chart types include pie chart, date histogram, and stacked bar charts.
+Get an agent
 
 </dd>
 </dl>
@@ -542,18 +588,7 @@ Fetches conversation data visualized in a chart format. Supported chart types in
 <dd>
 
 ```typescript
-await client.analytics.getConversationChart({
-    type: "pieChart",
-    conversationFilter: {
-        languages: ["en", "es"],
-    },
-    groupBy: {
-        field: "Category",
-    },
-    metric: {
-        type: "count",
-    },
-});
+await client.agents.get("organizationReferenceId", "agentReferenceId");
 ```
 
 </dd>
@@ -569,7 +604,7 @@ await client.analytics.getConversationChart({
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationChartRequest`
+**organizationReferenceId:** `string` — The ID of the organization.
 
 </dd>
 </dl>
@@ -577,7 +612,15 @@ await client.analytics.getConversationChart({
 <dl>
 <dd>
 
-**requestOptions:** `Analytics.RequestOptions`
+**agentReferenceId:** `string` — The ID of the agent.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
 
 </dd>
 </dl>
@@ -588,7 +631,7 @@ await client.analytics.getConversationChart({
 </dl>
 </details>
 
-<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getFeedbackTable</a>({ ...params }) -> MavenAGI.FeedbackTableResponse</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">patch</a>(organizationReferenceId, agentReferenceId, { ...params }) -> MavenAGI.Agent</code></summary>
 <dl>
 <dd>
 
@@ -600,8 +643,12 @@ await client.analytics.getConversationChart({
 <dl>
 <dd>
 
-Retrieves structured feedback data formatted as a table, allowing users to group, filter, and define specific metrics to display as columns.
+Update mutable agent fields
+All fields will overwrite the existing value on the agent only if provided.
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -616,24 +663,7 @@ Retrieves structured feedback data formatted as a table, allowing users to group
 <dd>
 
 ```typescript
-await client.analytics.getFeedbackTable({
-    feedbackFilter: {
-        types: ["THUMBS_UP", "INSERT"],
-    },
-    fieldGroupings: [
-        {
-            field: "CreatedBy",
-        },
-    ],
-    columnDefinitions: [
-        {
-            header: "feedback_count",
-            metric: {
-                type: "count",
-            },
-        },
-    ],
-});
+await client.agents.patch("organizationReferenceId", "agentReferenceId", {});
 ```
 
 </dd>
@@ -649,7 +679,7 @@ await client.analytics.getFeedbackTable({
 <dl>
 <dd>
 
-**request:** `MavenAGI.FeedbackTableRequest`
+**organizationReferenceId:** `string` — The ID of the organization.
 
 </dd>
 </dl>
@@ -657,7 +687,23 @@ await client.analytics.getFeedbackTable({
 <dl>
 <dd>
 
-**requestOptions:** `Analytics.RequestOptions`
+**agentReferenceId:** `string` — The ID of the agent.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.AgentPatchRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
 
 </dd>
 </dl>
@@ -668,9 +714,7 @@ await client.analytics.getFeedbackTable({
 </dl>
 </details>
 
-## AppSettings
-
-<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">search</a>({ ...params }) -> MavenAGI.SearchAppSettingsResponse</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">delete</a>(organizationReferenceId, agentReferenceId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -682,12 +726,11 @@ await client.analytics.getFeedbackTable({
 <dl>
 <dd>
 
-Search for app settings which have the `$index` key set to the provided value.
-
-You can set the `$index` key using the Update app settings API.
-
-<Warning>This API currently requires an organization ID and agent ID for any agent which is installed on the app. This requirement will be removed in a future update.</Warning>
+Delete an agent.
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -702,9 +745,7 @@ You can set the `$index` key using the Update app settings API.
 <dd>
 
 ```typescript
-await client.appSettings.search({
-    index: "index",
-});
+await client.agents.delete("organizationReferenceId", "agentReferenceId");
 ```
 
 </dd>
@@ -720,7 +761,7 @@ await client.appSettings.search({
 <dl>
 <dd>
 
-**request:** `MavenAGI.SearchAppSettingsRequest`
+**organizationReferenceId:** `string` — The ID of the organization.
 
 </dd>
 </dl>
@@ -728,10 +769,1230 @@ await client.appSettings.search({
 <dl>
 <dd>
 
-**requestOptions:** `AppSettings.RequestOptions`
+**agentReferenceId:** `string` — The ID of the agent.
 
-</dd>
-</dl>
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Agents.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## Analytics
+
+<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getConversationTable</a>({ ...params }) -> MavenAGI.ConversationTableResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieves structured conversation data formatted as a table, allowing users to group, filter, and define specific metrics to display as columns.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.analytics.getConversationTable({
+    conversationFilter: {
+        languages: ["en", "es"],
+    },
+    timeGrouping: "DAY",
+    fieldGroupings: [
+        {
+            field: "Category",
+        },
+    ],
+    columnDefinitions: [
+        {
+            header: "count",
+            metric: {
+                type: "count",
+            },
+        },
+        {
+            header: "avg_first_response_time",
+            metric: {
+                type: "average",
+                targetField: "FirstResponseTime",
+            },
+        },
+        {
+            header: "percentile_handle_time",
+            metric: {
+                type: "percentile",
+                targetField: "HandleTime",
+                percentile: 25,
+            },
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationTableRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Analytics.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getConversationChart</a>({ ...params }) -> MavenAGI.ChartResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Fetches conversation data visualized in a chart format. Supported chart types include pie chart, date histogram, and stacked bar charts.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.analytics.getConversationChart({
+    type: "pieChart",
+    conversationFilter: {
+        languages: ["en", "es"],
+    },
+    groupBy: {
+        field: "Category",
+    },
+    metric: {
+        type: "count",
+    },
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationChartRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Analytics.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getFeedbackTable</a>({ ...params }) -> MavenAGI.FeedbackTableResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieves structured feedback data formatted as a table, allowing users to group, filter, and define specific metrics to display as columns.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.analytics.getFeedbackTable({
+    feedbackFilter: {
+        types: ["THUMBS_UP", "INSERT"],
+    },
+    fieldGroupings: [
+        {
+            field: "CreatedBy",
+        },
+    ],
+    columnDefinitions: [
+        {
+            header: "feedback_count",
+            metric: {
+                type: "count",
+            },
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.FeedbackTableRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Analytics.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## AppSettings
+
+<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">search</a>({ ...params }) -> MavenAGI.SearchAppSettingsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Search for app settings which have the `$index` key set to the provided value.
+
+You can set the `$index` key using the Update app settings API.
+
+<Warning>This API currently requires an organization ID and agent ID for any agent which is installed on the app. This requirement will be removed in a future update.</Warning>
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.appSettings.search({
+    index: "index",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.SearchAppSettingsRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AppSettings.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">get</a>() -> Record<string, unknown></code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get app settings set during installation
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.appSettings.get();
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `AppSettings.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">update</a>({ ...params }) -> Record<string, unknown></code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Update app settings. Performs a merge of the provided settings with the existing app settings.
+
+- If a new key is provided, it will be added to the app settings.
+- If an existing key is provided, it will be updated.
+- No keys will be removed.
+
+Note that if an array value is provided it will fully replace an existing value as arrays cannot be merged.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.appSettings.update({
+    string: {
+        key: "value",
+    },
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Record<string, unknown>`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AppSettings.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## Assets
+
+<details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">initiateUpload</a>({ ...params }) -> MavenAGI.InitiateAssetUploadResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Initiate an upload.
+Returns a pre-signed URL for direct file upload and an asset ID for subsequent operations.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.assets.initiateUpload({
+    type: "type",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.InitiateAssetUploadRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Assets.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">commitUpload</a>(assetReferenceId, { ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Commit an upload after successful file transfer.
+Updates the asset status and makes it available for use.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.assets.commitUpload("assetReferenceId", {});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**assetReferenceId:** `string` — The reference ID of the asset to commit (provided by the initiate call). All other entity ID fields are inferred from the API request.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.CommitAssetUploadRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Assets.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## Conversation
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">initialize</a>({ ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Initialize a new conversation.
+Only required if the ask request wishes to supply conversation level data or when syncing to external systems.
+
+Conversations can not be modified using this API. If the conversation already exists then the existing conversation will be returned.
+
+After initialization,
+
+- metadata can be changed using the `updateConversationMetadata` API.
+- messages can be added to the conversation with the `appendNewMessages` or `ask` APIs.
+  </dd>
+  </dl>
+  </dd>
+  </dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.initialize({
+    conversationId: {
+        referenceId: "referenceId",
+    },
+    messages: [
+        {
+            conversationMessageId: {
+                referenceId: "referenceId",
+            },
+            userId: {
+                referenceId: "referenceId",
+            },
+            text: "text",
+            userMessageType: "USER",
+        },
+        {
+            conversationMessageId: {
+                referenceId: "referenceId",
+            },
+            userId: {
+                referenceId: "referenceId",
+            },
+            text: "text",
+            userMessageType: "USER",
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">patch</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Update mutable conversation fields.
+
+The `appId` field can be provided to update a conversation owned by a different app.
+All other fields will overwrite the existing value on the conversation only if provided.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.patch("conversation-0", {
+    llmEnabled: true,
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of the conversation to patch
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationPatchRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">get</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get a conversation
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.get("conversationId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of the conversation to get
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationGetRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">delete</a>(conversationId, { ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Wipes a conversation of all user data.
+The conversation ID will still exist and non-user specific data will still be retained.
+Attempts to modify or add messages to the conversation will throw an error.
+
+<Warning>This is a destructive operation and cannot be undone. <br/><br/>
+The exact fields cleared include: the conversation subject, userRequest, agentResponse.
+As well as the text response, followup questions, and backend LLM prompt of all messages.</Warning>
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.delete("conversation-0", {
+    reason: "GDPR deletion request 1234.",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of the conversation to delete
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationDeleteRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">appendNewMessages</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Append messages to an existing conversation. The conversation must be initialized first. If a message with the same ID already exists, it will be ignored. Messages do not allow modification.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.appendNewMessages("conversationId", [
+    {
+        conversationMessageId: {
+            referenceId: "referenceId",
+        },
+        userId: {
+            referenceId: "referenceId",
+        },
+        text: "text",
+        userMessageType: "USER",
+    },
+    {
+        conversationMessageId: {
+            referenceId: "referenceId",
+        },
+        userId: {
+            referenceId: "referenceId",
+        },
+        text: "text",
+        userMessageType: "USER",
+    },
+]);
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of the conversation to append messages to
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationMessageRequest[]`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">ask</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get an answer from Maven for a given user question. If the user question or its answer already exists,
+they will be reused and will not be updated. Messages do not allow modification once generated.
+
+Concurrency Behavior:
+
+- If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
+- The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
+
+Known Limitation:
+
+- The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
+  </dd>
+  </dl>
+  </dd>
+  </dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.ask("conversation-0", {
+    conversationMessageId: {
+        referenceId: "message-0",
+    },
+    userId: {
+        referenceId: "user-0",
+    },
+    text: "How do I reset my password?",
+    attachments: [
+        {
+            type: "image/png",
+            content: "iVBORw0KGgo...",
+        },
+    ],
+    transientData: {
+        userToken: "abcdef123",
+        queryApiKey: "foobar456",
+    },
+    timezone: "America/New_York",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.AskRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">askStream</a>(conversationId, { ...params }) -> core.Stream<MavenAGI.StreamResponse></code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get an answer from Maven for a given user question with a streaming response. The response will be sent as a stream of events.
+The text portions of stream responses should be concatenated to form the full response text.
+Action and metadata events should overwrite past data and do not need concatenation.
+
+If the user question or its answer already exists, they will be reused and will not be updated.
+Messages do not allow modification once generated.
+
+Concurrency Behavior:
+
+- If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
+- The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
+
+Known Limitation:
+
+- The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
+  </dd>
+  </dl>
+  </dd>
+  </dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+const response = await client.conversation.askStream("conversation-0", {
+    conversationMessageId: {
+        referenceId: "message-0",
+    },
+    userId: {
+        referenceId: "user-0",
+    },
+    text: "How do I reset my password?",
+    attachments: [
+        {
+            type: "image/png",
+            content: "iVBORw0KGgo...",
+        },
+    ],
+    transientData: {
+        userToken: "abcdef123",
+        queryApiKey: "foobar456",
+    },
+    timezone: "America/New_York",
+});
+for await (const item of response) {
+    console.log(item);
+}
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.AskRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
 </dd>
 </dl>
 
@@ -739,7 +2000,7 @@ await client.appSettings.search({
 </dl>
 </details>
 
-<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">get</a>() -> Record<string, unknown></code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">generateMavenSuggestions</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
 <dl>
 <dd>
 
@@ -751,7 +2012,7 @@ await client.appSettings.search({
 <dl>
 <dd>
 
-Get app settings set during installation
+This method is deprecated and will be removed in a future release. Use either `ask` or `askStream` instead.
 
 </dd>
 </dl>
@@ -767,7 +2028,261 @@ Get app settings set during installation
 <dd>
 
 ```typescript
-await client.appSettings.get();
+await client.conversation.generateMavenSuggestions("conversationId", {
+    conversationMessageIds: [
+        {
+            referenceId: "referenceId",
+        },
+        {
+            referenceId: "referenceId",
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of a conversation the messages belong to
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.GenerateMavenSuggestionsRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">askObjectStream</a>(conversationId, { ...params }) -> core.Stream<MavenAGI.ObjectStreamResponse></code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generate a structured object response based on a provided schema and user prompt with a streaming response.
+The response will be sent as a stream of events containing text, start, and end events.
+The text portions of stream responses should be concatenated to form the full response text.
+
+If the user question and object response already exist, they will be reused and not updated.
+
+Concurrency Behavior:
+
+- If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
+- The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
+
+Known Limitations:
+
+- Schema enforcement is best-effort and may not guarantee exact conformity.
+- The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
+  </dd>
+  </dl>
+  </dd>
+  </dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+const response = await client.conversation.askObjectStream("conversationId", {
+    schema: "schema",
+    conversationMessageId: {
+        referenceId: "referenceId",
+    },
+    userId: {
+        referenceId: "referenceId",
+    },
+    text: "text",
+});
+for await (const item of response) {
+    console.log(item);
+}
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of a new or existing conversation to use as context for the object generation request
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.AskObjectRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">categorize</a>(conversationId) -> MavenAGI.CategorizationResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Uses an LLM flow to categorize the conversation. Experimental.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.categorize("conversationId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**conversationId:** `string` — The ID of the conversation to categorize
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">createFeedback</a>({ ...params }) -> MavenAGI.Feedback</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Update feedback or create it if it doesn't exist
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversation.createFeedback({
+    feedbackId: {
+        referenceId: "feedback-0",
+    },
+    userId: {
+        referenceId: "user-0",
+    },
+    conversationId: {
+        referenceId: "conversation-0",
+    },
+    conversationMessageId: {
+        referenceId: "message-1",
+    },
+    type: "THUMBS_UP",
+    text: "Great answer!",
+});
 ```
 
 </dd>
@@ -783,7 +2298,15 @@ await client.appSettings.get();
 <dl>
 <dd>
 
-**requestOptions:** `AppSettings.RequestOptions`
+**request:** `MavenAGI.FeedbackRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
 
 </dd>
 </dl>
@@ -794,7 +2317,7 @@ await client.appSettings.get();
 </dl>
 </details>
 
-<details><summary><code>client.appSettings.<a href="/src/api/resources/appSettings/client/Client.ts">update</a>({ ...params }) -> Record<string, unknown></code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">submitActionForm</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
 <dl>
 <dd>
 
@@ -806,13 +2329,7 @@ await client.appSettings.get();
 <dl>
 <dd>
 
-Update app settings. Performs a merge of the provided settings with the existing app settings.
-
-- If a new key is provided, it will be added to the app settings.
-- If an existing key is provided, it will be updated.
-- No keys will be removed.
-
-Note that if an array value is provided it will fully replace an existing value as arrays cannot be merged.
+Submit a filled out action form
 
 </dd>
 </dl>
@@ -828,9 +2345,12 @@ Note that if an array value is provided it will fully replace an existing value
 <dd>
 
 ```typescript
-await client.appSettings.update({
-    string: {
-        key: "value",
+await client.conversation.submitActionForm("conversationId", {
+    actionFormId: "actionFormId",
+    parameters: {
+        parameters: {
+            key: "value",
+        },
     },
 });
 ```
@@ -848,7 +2368,7 @@ await client.appSettings.update({
 <dl>
 <dd>
 
-**request:** `Record<string, unknown>`
+**conversationId:** `string` — The ID of a conversation the form being submitted belongs to
 
 </dd>
 </dl>
@@ -856,7 +2376,15 @@ await client.appSettings.update({
 <dl>
 <dd>
 
-**requestOptions:** `AppSettings.RequestOptions`
+**request:** `MavenAGI.SubmitActionFormRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversation.RequestOptions`
 
 </dd>
 </dl>
@@ -867,9 +2395,7 @@ await client.appSettings.update({
 </dl>
 </details>
 
-## Conversation
-
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">initialize</a>({ ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">addConversationMetadata</a>(conversationId, { ...params }) -> Record<string, string></code></summary>
 <dl>
 <dd>
 
@@ -881,19 +2407,14 @@ await client.appSettings.update({
 <dl>
 <dd>
 
-Initialize a new conversation.
-Only required if the ask request wishes to supply conversation level data or when syncing to external systems.
-
-Conversations can not be modified using this API. If the conversation already exists then the existing conversation will be returned.
+Replaced by `updateConversationMetadata`.
 
-After initialization,
+Adds metadata to an existing conversation. If a metadata field already exists, it will be overwritten.
 
-- metadata can be changed using the `updateConversationMetadata` API.
-- messages can be added to the conversation with the `appendNewMessages` or `ask` APIs.
-  </dd>
-  </dl>
-  </dd>
-  </dl>
+</dd>
+</dl>
+</dd>
+</dl>
 
 #### 🔌 Usage
 
@@ -904,32 +2425,8 @@ After initialization,
 <dd>
 
 ```typescript
-await client.conversation.initialize({
-    conversationId: {
-        referenceId: "referenceId",
-    },
-    messages: [
-        {
-            conversationMessageId: {
-                referenceId: "referenceId",
-            },
-            userId: {
-                referenceId: "referenceId",
-            },
-            text: "text",
-            userMessageType: "USER",
-        },
-        {
-            conversationMessageId: {
-                referenceId: "referenceId",
-            },
-            userId: {
-                referenceId: "referenceId",
-            },
-            text: "text",
-            userMessageType: "USER",
-        },
-    ],
+await client.conversation.addConversationMetadata("conversationId", {
+    string: "string",
 });
 ```
 
@@ -946,7 +2443,15 @@ await client.conversation.initialize({
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationRequest`
+**conversationId:** `string` — The ID of a conversation the metadata being added belongs to
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Record<string, string>`
 
 </dd>
 </dl>
@@ -965,7 +2470,7 @@ await client.conversation.initialize({
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">get</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">updateConversationMetadata</a>(conversationId, { ...params }) -> MavenAGI.ConversationMetadata</code></summary>
 <dl>
 <dd>
 
@@ -977,7 +2482,13 @@ await client.conversation.initialize({
 <dl>
 <dd>
 
-Get a conversation
+Update metadata supplied by the calling application for an existing conversation.
+Does not modify metadata saved by other apps.
+
+If a metadata field already exists for the calling app, it will be overwritten.
+If it does not exist, it will be added. Will not remove metadata fields.
+
+Returns all metadata saved by any app on the conversation.
 
 </dd>
 </dl>
@@ -993,7 +2504,12 @@ Get a conversation
 <dd>
 
 ```typescript
-await client.conversation.get("conversationId");
+await client.conversation.updateConversationMetadata("conversation-0", {
+    appId: "conversation-owning-app",
+    values: {
+        key: "newValue",
+    },
+});
 ```
 
 </dd>
@@ -1009,7 +2525,7 @@ await client.conversation.get("conversationId");
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of the conversation to get
+**conversationId:** `string` — The ID of the conversation to modify metadata for
 
 </dd>
 </dl>
@@ -1017,7 +2533,7 @@ await client.conversation.get("conversationId");
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationGetRequest`
+**request:** `MavenAGI.UpdateMetadataRequest`
 
 </dd>
 </dl>
@@ -1036,7 +2552,7 @@ await client.conversation.get("conversationId");
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">delete</a>(conversationId, { ...params }) -> void</code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">search</a>({ ...params }) -> MavenAGI.ConversationsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1048,13 +2564,7 @@ await client.conversation.get("conversationId");
 <dl>
 <dd>
 
-Wipes a conversation of all user data.
-The conversation ID will still exist and non-user specific data will still be retained.
-Attempts to modify or add messages to the conversation will throw an error.
-
-<Warning>This is a destructive operation and cannot be undone. <br/><br/>
-The exact fields cleared include: the conversation subject, userRequest, agentResponse.
-As well as the text response, followup questions, and backend LLM prompt of all messages.</Warning>
+Search conversations
 
 </dd>
 </dl>
@@ -1070,9 +2580,7 @@ As well as the text response, followup questions, and backend LLM prompt of all
 <dd>
 
 ```typescript
-await client.conversation.delete("conversation-0", {
-    reason: "GDPR deletion request 1234.",
-});
+await client.conversation.search({});
 ```
 
 </dd>
@@ -1088,15 +2596,7 @@ await client.conversation.delete("conversation-0", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of the conversation to delete
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.ConversationDeleteRequest`
+**request:** `MavenAGI.ConversationsSearchRequest`
 
 </dd>
 </dl>
@@ -1115,7 +2615,7 @@ await client.conversation.delete("conversation-0", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">appendNewMessages</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">deliverMessage</a>({ ...params }) -> MavenAGI.DeliverMessageResponse</code></summary>
 <dl>
 <dd>
 
@@ -1127,8 +2627,12 @@ await client.conversation.delete("conversation-0", {
 <dl>
 <dd>
 
-Append messages to an existing conversation. The conversation must be initialized first. If a message with the same ID already exists, it will be ignored. Messages do not allow modification.
+Deliver a message to a user or conversation.
 
+<Warning>
+Currently, messages can only be successfully delivered to conversations with the `ASYNC` capability that are `open`. 
+User message delivery is not yet supported.
+</Warning>
 </dd>
 </dl>
 </dd>
@@ -1143,18 +2647,14 @@ Append messages to an existing conversation. The conversation must be initialize
 <dd>
 
 ```typescript
-await client.conversation.appendNewMessages("conversationId", [
-    {
-        conversationMessageId: {
-            referenceId: "referenceId",
-        },
-        userId: {
-            referenceId: "referenceId",
-        },
-        text: "text",
-        userMessageType: "USER",
+await client.conversation.deliverMessage({
+    type: "user",
+    userId: {
+        type: "AGENT",
+        appId: "appId",
+        referenceId: "referenceId",
     },
-    {
+    message: {
         conversationMessageId: {
             referenceId: "referenceId",
         },
@@ -1164,7 +2664,7 @@ await client.conversation.appendNewMessages("conversationId", [
         text: "text",
         userMessageType: "USER",
     },
-]);
+});
 ```
 
 </dd>
@@ -1180,15 +2680,7 @@ await client.conversation.appendNewMessages("conversationId", [
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of the conversation to append messages to
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.ConversationMessageRequest[]`
+**request:** `MavenAGI.DeliverMessageRequest`
 
 </dd>
 </dl>
@@ -1207,7 +2699,9 @@ await client.conversation.appendNewMessages("conversationId", [
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">ask</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+## Events
+
+<details><summary><code>client.events.<a href="/src/api/resources/events/client/Client.ts">search</a>({ ...params }) -> MavenAGI.EventsSearchResponse</code></summary>
 <dl>
 <dd>
 
@@ -1219,21 +2713,12 @@ await client.conversation.appendNewMessages("conversationId", [
 <dl>
 <dd>
 
-Get an answer from Maven for a given user question. If the user question or its answer already exists,
-they will be reused and will not be updated. Messages do not allow modification once generated.
-
-Concurrency Behavior:
-
-- If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
-- The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
-
-Known Limitation:
+Search events
 
-- The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
-  </dd>
-  </dl>
-  </dd>
-  </dl>
+</dd>
+</dl>
+</dd>
+</dl>
 
 #### 🔌 Usage
 
@@ -1244,26 +2729,7 @@ Known Limitation:
 <dd>
 
 ```typescript
-await client.conversation.ask("conversation-0", {
-    conversationMessageId: {
-        referenceId: "message-0",
-    },
-    userId: {
-        referenceId: "user-0",
-    },
-    text: "How do I reset my password?",
-    attachments: [
-        {
-            type: "image/png",
-            content: "iVBORw0KGgo...",
-        },
-    ],
-    transientData: {
-        userToken: "abcdef123",
-        queryApiKey: "foobar456",
-    },
-    timezone: "America/New_York",
-});
+await client.events.search({});
 ```
 
 </dd>
@@ -1279,15 +2745,7 @@ await client.conversation.ask("conversation-0", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.AskRequest`
+**request:** `MavenAGI.EventsSearchRequest`
 
 </dd>
 </dl>
@@ -1295,7 +2753,7 @@ await client.conversation.ask("conversation-0", {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Events.RequestOptions`
 
 </dd>
 </dl>
@@ -1306,39 +2764,13 @@ await client.conversation.ask("conversation-0", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">askStream</a>(conversationId, { ...params }) -> core.Stream<MavenAGI.StreamResponse></code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Get an answer from Maven for a given user question with a streaming response. The response will be sent as a stream of events.
-The text portions of stream responses should be concatenated to form the full response text.
-Action and metadata events should overwrite past data and do not need concatenation.
-
-If the user question or its answer already exists, they will be reused and will not be updated.
-Messages do not allow modification once generated.
-
-Concurrency Behavior:
-
-- If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
-- The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
-
-Known Limitation:
+## Inbox
 
-- The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
-  </dd>
-  </dl>
-  </dd>
-  </dl>
+<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">search</a>({ ...params }) -> MavenAGI.InboxSearchResponse</code></summary>
+<dl>
+<dd>
 
-#### 🔌 Usage
+#### 📝 Description
 
 <dl>
 <dd>
@@ -1346,38 +2778,14 @@ Known Limitation:
 <dl>
 <dd>
 
-```typescript
-const response = await client.conversation.askStream("conversation-0", {
-    conversationMessageId: {
-        referenceId: "message-0",
-    },
-    userId: {
-        referenceId: "user-0",
-    },
-    text: "How do I reset my password?",
-    attachments: [
-        {
-            type: "image/png",
-            content: "iVBORw0KGgo...",
-        },
-    ],
-    transientData: {
-        userToken: "abcdef123",
-        queryApiKey: "foobar456",
-    },
-    timezone: "America/New_York",
-});
-for await (const item of response) {
-    console.log(item);
-}
-```
+Retrieve a paginated list of inbox items for an agent.
 
 </dd>
 </dl>
 </dd>
 </dl>
 
-#### ⚙️ Parameters
+#### 🔌 Usage
 
 <dl>
 <dd>
@@ -1385,15 +2793,24 @@ for await (const item of response) {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
+```typescript
+await client.inbox.search({});
+```
 
+</dd>
+</dl>
 </dd>
 </dl>
 
+#### ⚙️ Parameters
+
 <dl>
 <dd>
 
-**request:** `MavenAGI.AskRequest`
+<dl>
+<dd>
+
+**request:** `MavenAGI.InboxSearchRequest`
 
 </dd>
 </dl>
@@ -1401,7 +2818,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Inbox.RequestOptions`
 
 </dd>
 </dl>
@@ -1412,7 +2829,7 @@ for await (const item of response) {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">generateMavenSuggestions</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">get</a>(inboxItemId, { ...params }) -> MavenAGI.InboxItem</code></summary>
 <dl>
 <dd>
 
@@ -1424,7 +2841,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-This method is deprecated and will be removed in a future release. Use either `ask` or `askStream` instead.
+Retrieve details of a specific inbox item by its ID.
 
 </dd>
 </dl>
@@ -1440,15 +2857,8 @@ This method is deprecated and will be removed in a future release. Use either `a
 <dd>
 
 ```typescript
-await client.conversation.generateMavenSuggestions("conversationId", {
-    conversationMessageIds: [
-        {
-            referenceId: "referenceId",
-        },
-        {
-            referenceId: "referenceId",
-        },
-    ],
+await client.inbox.get("inboxItemId", {
+    appId: "appId",
 });
 ```
 
@@ -1465,7 +2875,7 @@ await client.conversation.generateMavenSuggestions("conversationId", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of a conversation the messages belong to
+**inboxItemId:** `string` — The ID of the inbox item to get. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -1473,7 +2883,7 @@ await client.conversation.generateMavenSuggestions("conversationId", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.GenerateMavenSuggestionsRequest`
+**request:** `MavenAGI.InboxItemRequest`
 
 </dd>
 </dl>
@@ -1481,7 +2891,7 @@ await client.conversation.generateMavenSuggestions("conversationId", {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Inbox.RequestOptions`
 
 </dd>
 </dl>
@@ -1492,7 +2902,7 @@ await client.conversation.generateMavenSuggestions("conversationId", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">categorize</a>(conversationId) -> MavenAGI.CategorizationResponse</code></summary>
+<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">getFix</a>(inboxItemFixId, { ...params }) -> MavenAGI.InboxItemFix</code></summary>
 <dl>
 <dd>
 
@@ -1504,7 +2914,7 @@ await client.conversation.generateMavenSuggestions("conversationId", {
 <dl>
 <dd>
 
-Uses an LLM flow to categorize the conversation. Experimental.
+Retrieve a suggested fix. Includes document information if the fix is a Missing Knowledge suggestion.
 
 </dd>
 </dl>
@@ -1520,7 +2930,9 @@ Uses an LLM flow to categorize the conversation. Experimental.
 <dd>
 
 ```typescript
-await client.conversation.categorize("conversationId");
+await client.inbox.getFix("inboxItemFixId", {
+    appId: "appId",
+});
 ```
 
 </dd>
@@ -1536,7 +2948,7 @@ await client.conversation.categorize("conversationId");
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of the conversation to categorize
+**inboxItemFixId:** `string` — Unique identifier for the inbox fix.
 
 </dd>
 </dl>
@@ -1544,7 +2956,15 @@ await client.conversation.categorize("conversationId");
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**request:** `MavenAGI.InboxItemFixRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Inbox.RequestOptions`
 
 </dd>
 </dl>
@@ -1555,7 +2975,7 @@ await client.conversation.categorize("conversationId");
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">createFeedback</a>({ ...params }) -> MavenAGI.Feedback</code></summary>
+<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">applyFixes</a>(inboxItemId, { ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1567,7 +2987,7 @@ await client.conversation.categorize("conversationId");
 <dl>
 <dd>
 
-Update feedback or create it if it doesn't exist
+Apply a list of fixes belonging to an inbox item.
 
 </dd>
 </dl>
@@ -1583,21 +3003,9 @@ Update feedback or create it if it doesn't exist
 <dd>
 
 ```typescript
-await client.conversation.createFeedback({
-    feedbackId: {
-        referenceId: "feedback-0",
-    },
-    userId: {
-        referenceId: "user-0",
-    },
-    conversationId: {
-        referenceId: "conversation-0",
-    },
-    conversationMessageId: {
-        referenceId: "message-1",
-    },
-    type: "THUMBS_UP",
-    text: "Great answer!",
+await client.inbox.applyFixes("inboxItemId", {
+    appId: "appId",
+    fixReferenceIds: ["fixReferenceIds", "fixReferenceIds"],
 });
 ```
 
@@ -1614,7 +3022,7 @@ await client.conversation.createFeedback({
 <dl>
 <dd>
 
-**request:** `MavenAGI.FeedbackRequest`
+**inboxItemId:** `string` — Unique identifier for the inbox item.
 
 </dd>
 </dl>
@@ -1622,7 +3030,15 @@ await client.conversation.createFeedback({
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**request:** `MavenAGI.ApplyFixesRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Inbox.RequestOptions`
 
 </dd>
 </dl>
@@ -1633,7 +3049,7 @@ await client.conversation.createFeedback({
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">submitActionForm</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">ignore</a>(inboxItemId, { ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1645,7 +3061,7 @@ await client.conversation.createFeedback({
 <dl>
 <dd>
 
-Submit a filled out action form
+Ignore a specific inbox item by its ID.
 
 </dd>
 </dl>
@@ -1661,13 +3077,8 @@ Submit a filled out action form
 <dd>
 
 ```typescript
-await client.conversation.submitActionForm("conversationId", {
-    actionFormId: "actionFormId",
-    parameters: {
-        parameters: {
-            key: "value",
-        },
-    },
+await client.inbox.ignore("inboxItemId", {
+    appId: "appId",
 });
 ```
 
@@ -1684,7 +3095,7 @@ await client.conversation.submitActionForm("conversationId", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of a conversation the form being submitted belongs to
+**inboxItemId:** `string` — Unique identifier for the inbox item.
 
 </dd>
 </dl>
@@ -1692,7 +3103,7 @@ await client.conversation.submitActionForm("conversationId", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.SubmitActionFormRequest`
+**request:** `MavenAGI.InboxItemIgnoreRequest`
 
 </dd>
 </dl>
@@ -1700,7 +3111,7 @@ await client.conversation.submitActionForm("conversationId", {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Inbox.RequestOptions`
 
 </dd>
 </dl>
@@ -1711,7 +3122,9 @@ await client.conversation.submitActionForm("conversationId", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">addConversationMetadata</a>(conversationId, { ...params }) -> Record<string, string></code></summary>
+## Knowledge
+
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">searchKnowledgeBases</a>({ ...params }) -> MavenAGI.KnowledgeBasesResponse</code></summary>
 <dl>
 <dd>
 
@@ -1723,9 +3136,7 @@ await client.conversation.submitActionForm("conversationId", {
 <dl>
 <dd>
 
-Replaced by `updateConversationMetadata`.
-
-Adds metadata to an existing conversation. If a metadata field already exists, it will be overwritten.
+Search knowledge bases
 
 </dd>
 </dl>
@@ -1741,9 +3152,7 @@ Adds metadata to an existing conversation. If a metadata field already exists, i
 <dd>
 
 ```typescript
-await client.conversation.addConversationMetadata("conversationId", {
-    string: "string",
-});
+await client.knowledge.searchKnowledgeBases({});
 ```
 
 </dd>
@@ -1759,15 +3168,7 @@ await client.conversation.addConversationMetadata("conversationId", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of a conversation the metadata being added belongs to
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Record<string, string>`
+**request:** `MavenAGI.KnowledgeBaseSearchRequest`
 
 </dd>
 </dl>
@@ -1775,7 +3176,7 @@ await client.conversation.addConversationMetadata("conversationId", {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -1786,7 +3187,7 @@ await client.conversation.addConversationMetadata("conversationId", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">updateConversationMetadata</a>(conversationId, { ...params }) -> MavenAGI.ConversationMetadata</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createOrUpdateKnowledgeBase</a>({ ...params }) -> MavenAGI.KnowledgeBaseResponse</code></summary>
 <dl>
 <dd>
 
@@ -1798,13 +3199,7 @@ await client.conversation.addConversationMetadata("conversationId", {
 <dl>
 <dd>
 
-Update metadata supplied by the calling application for an existing conversation.
-Does not modify metadata saved by other apps.
-
-If a metadata field already exists for the calling app, it will be overwritten.
-If it does not exist, it will be added. Will not remove metadata fields.
-
-Returns all metadata saved by any app on the conversation.
+Update a knowledge base or create it if it doesn't exist.
 
 </dd>
 </dl>
@@ -1820,11 +3215,11 @@ Returns all metadata saved by any app on the conversation.
 <dd>
 
 ```typescript
-await client.conversation.updateConversationMetadata("conversation-0", {
-    appId: "conversation-owning-app",
-    values: {
-        key: "newValue",
+await client.knowledge.createOrUpdateKnowledgeBase({
+    knowledgeBaseId: {
+        referenceId: "help-center",
     },
+    name: "Help center",
 });
 ```
 
@@ -1841,15 +3236,7 @@ await client.conversation.updateConversationMetadata("conversation-0", {
 <dl>
 <dd>
 
-**conversationId:** `string` — The ID of the conversation to modify metadata for
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.UpdateMetadataRequest`
+**request:** `MavenAGI.KnowledgeBaseRequest`
 
 </dd>
 </dl>
@@ -1857,7 +3244,7 @@ await client.conversation.updateConversationMetadata("conversation-0", {
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -1868,7 +3255,7 @@ await client.conversation.updateConversationMetadata("conversation-0", {
 </dl>
 </details>
 
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">search</a>({ ...params }) -> MavenAGI.ConversationsResponse</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">getKnowledgeBase</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseResponse</code></summary>
 <dl>
 <dd>
 
@@ -1880,7 +3267,7 @@ await client.conversation.updateConversationMetadata("conversation-0", {
 <dl>
 <dd>
 
-Search conversations
+Get an existing knowledge base by its supplied ID
 
 </dd>
 </dl>
@@ -1896,7 +3283,7 @@ Search conversations
 <dd>
 
 ```typescript
-await client.conversation.search({});
+await client.knowledge.getKnowledgeBase("help-center");
 ```
 
 </dd>
@@ -1912,7 +3299,7 @@ await client.conversation.search({});
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationsSearchRequest`
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to get. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -1920,7 +3307,15 @@ await client.conversation.search({});
 <dl>
 <dd>
 
-**requestOptions:** `Conversation.RequestOptions`
+**request:** `MavenAGI.KnowledgeBaseGetRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -1931,9 +3326,7 @@ await client.conversation.search({});
 </dl>
 </details>
 
-## Events
-
-<details><summary><code>client.events.<a href="/src/api/resources/events/client/Client.ts">search</a>({ ...params }) -> MavenAGI.EventsSearchResponse</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">patchKnowledgeBase</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseResponse</code></summary>
 <dl>
 <dd>
 
@@ -1945,7 +3338,10 @@ await client.conversation.search({});
 <dl>
 <dd>
 
-Search events
+Update mutable knowledge base fields
+
+The `appId` field can be provided to update a knowledge base owned by a different app.
+All other fields will overwrite the existing value on the knowledge base only if provided.
 
 </dd>
 </dl>
@@ -1961,7 +3357,7 @@ Search events
 <dd>
 
 ```typescript
-await client.events.search({});
+await client.knowledge.patchKnowledgeBase("knowledgeBaseReferenceId", {});
 ```
 
 </dd>
@@ -1977,7 +3373,7 @@ await client.events.search({});
 <dl>
 <dd>
 
-**request:** `MavenAGI.EventsSearchRequest`
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to patch.
 
 </dd>
 </dl>
@@ -1985,7 +3381,15 @@ await client.events.search({});
 <dl>
 <dd>
 
-**requestOptions:** `Events.RequestOptions`
+**request:** `MavenAGI.KnowledgeBasePatchRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -1996,9 +3400,7 @@ await client.events.search({});
 </dl>
 </details>
 
-## Inbox
-
-<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">search</a>({ ...params }) -> MavenAGI.InboxSearchResponse</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeBaseVersion</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseVersion</code></summary>
 <dl>
 <dd>
 
@@ -2010,14 +3412,43 @@ await client.events.search({});
 <dl>
 <dd>
 
-Retrieve a paginated list of inbox items for an agent.
+Create a new knowledge base version.
+
+If an existing version is in progress, then that version will be finalized in an error state.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.knowledge.createKnowledgeBaseVersion("help-center", {
+    versionId: {
+        type: "KNOWLEDGE_BASE_VERSION",
+        referenceId: "versionId",
+        appId: "maven",
+        organizationId: "acme",
+        agentId: "support",
+    },
+    type: "FULL",
+    status: "IN_PROGRESS",
+});
+```
 
 </dd>
 </dl>
 </dd>
 </dl>
 
-#### 🔌 Usage
+#### ⚙️ Parameters
 
 <dl>
 <dd>
@@ -2025,24 +3456,15 @@ Retrieve a paginated list of inbox items for an agent.
 <dl>
 <dd>
 
-```typescript
-await client.inbox.search({});
-```
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a version for. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
 
 <dl>
 <dd>
 
-**request:** `MavenAGI.InboxSearchRequest`
+**request:** `MavenAGI.KnowledgeBaseVersion`
 
 </dd>
 </dl>
@@ -2050,7 +3472,7 @@ await client.inbox.search({});
 <dl>
 <dd>
 
-**requestOptions:** `Inbox.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -2061,7 +3483,7 @@ await client.inbox.search({});
 </dl>
 </details>
 
-<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">get</a>(inboxItemId, { ...params }) -> MavenAGI.InboxItem</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">finalizeKnowledgeBaseVersion</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseVersion</code></summary>
 <dl>
 <dd>
 
@@ -2073,7 +3495,7 @@ await client.inbox.search({});
 <dl>
 <dd>
 
-Retrieve details of a specific inbox item by its ID.
+Finalize the latest knowledge base version. Required to indicate the version is complete. Will throw an exception if the latest version is not in progress.
 
 </dd>
 </dl>
@@ -2089,9 +3511,13 @@ Retrieve details of a specific inbox item by its ID.
 <dd>
 
 ```typescript
-await client.inbox.get("inboxItemId", {
-    appId: "appId",
-    itemType: "DUPLICATE_DOCUMENT",
+await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
+    versionId: {
+        type: "KNOWLEDGE_BASE_VERSION",
+        referenceId: "versionId",
+        appId: "maven",
+    },
+    status: "SUCCEEDED",
 });
 ```
 
@@ -2108,7 +3534,7 @@ await client.inbox.get("inboxItemId", {
 <dl>
 <dd>
 
-**inboxItemId:** `string` — The ID of the inbox item to get. All other entity ID fields are inferred from the request.
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to finalize a version for. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2116,7 +3542,7 @@ await client.inbox.get("inboxItemId", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.InboxItemRequest`
+**request:** `MavenAGI.FinalizeKnowledgeBaseVersionRequest`
 
 </dd>
 </dl>
@@ -2124,7 +3550,7 @@ await client.inbox.get("inboxItemId", {
 <dl>
 <dd>
 
-**requestOptions:** `Inbox.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -2135,7 +3561,7 @@ await client.inbox.get("inboxItemId", {
 </dl>
 </details>
 
-<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">getFix</a>(inboxItemFixId, { ...params }) -> MavenAGI.InboxItemFix</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">searchKnowledgeDocuments</a>({ ...params }) -> MavenAGI.KnowledgeDocumentsResponse</code></summary>
 <dl>
 <dd>
 
@@ -2147,7 +3573,7 @@ await client.inbox.get("inboxItemId", {
 <dl>
 <dd>
 
-Retrieve a suggested fix. Includes document information if the fix is a Missing Knowledge suggestion.
+Search knowledge documents
 
 </dd>
 </dl>
@@ -2163,10 +3589,7 @@ Retrieve a suggested fix. Includes document information if the fix is a Missing
 <dd>
 
 ```typescript
-await client.inbox.getFix("inboxItemFixId", {
-    appId: "appId",
-    fixType: "REMOVE_DOCUMENT",
-});
+await client.knowledge.searchKnowledgeDocuments({});
 ```
 
 </dd>
@@ -2182,15 +3605,7 @@ await client.inbox.getFix("inboxItemFixId", {
 <dl>
 <dd>
 
-**inboxItemFixId:** `string` — Unique identifier for the inbox fix.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.InboxItemFixRequest`
+**request:** `MavenAGI.KnowledgeDocumentSearchRequest`
 
 </dd>
 </dl>
@@ -2198,7 +3613,7 @@ await client.inbox.getFix("inboxItemFixId", {
 <dl>
 <dd>
 
-**requestOptions:** `Inbox.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -2209,7 +3624,7 @@ await client.inbox.getFix("inboxItemFixId", {
 </dl>
 </details>
 
-<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">applyFix</a>(inboxItemFixId, { ...params }) -> void</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
 <dl>
 <dd>
 
@@ -2221,8 +3636,12 @@ await client.inbox.getFix("inboxItemFixId", {
 <dl>
 <dd>
 
-Apply a fix to an inbox item with a specific document.
+Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
 
+<Tip>
+This API maintains document version history. If for the same reference ID neither the `title` nor `text` fields 
+have changed, a new document version will not be created. The existing version will be reused.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -2237,9 +3656,21 @@ Apply a fix to an inbox item with a specific document.
 <dd>
 
 ```typescript
-await client.inbox.applyFix("inboxItemFixId", {
-    appId: "appId",
-    fixType: "REMOVE_DOCUMENT",
+await client.knowledge.createKnowledgeDocument("help-center", {
+    knowledgeDocumentId: {
+        referenceId: "getting-started",
+    },
+    versionId: {
+        type: "KNOWLEDGE_BASE_VERSION",
+        referenceId: "versionId",
+        appId: "maven",
+    },
+    contentType: "MARKDOWN",
+    content: "## Getting started\\nThis is a getting started guide for the help center.",
+    title: "Getting started",
+    metadata: {
+        category: "getting-started",
+    },
 });
 ```
 
@@ -2256,7 +3687,7 @@ await client.inbox.applyFix("inboxItemFixId", {
 <dl>
 <dd>
 
-**inboxItemFixId:** `string` — Unique identifier for the inbox fix.
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a document for. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2264,7 +3695,7 @@ await client.inbox.applyFix("inboxItemFixId", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.ApplyInboxItemFixRequest`
+**request:** `MavenAGI.KnowledgeDocumentRequest`
 
 </dd>
 </dl>
@@ -2272,7 +3703,7 @@ await client.inbox.applyFix("inboxItemFixId", {
 <dl>
 <dd>
 
-**requestOptions:** `Inbox.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -2283,7 +3714,7 @@ await client.inbox.applyFix("inboxItemFixId", {
 </dl>
 </details>
 
-<details><summary><code>client.inbox.<a href="/src/api/resources/inbox/client/Client.ts">ignore</a>(inboxItemId, { ...params }) -> void</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">updateKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
 <dl>
 <dd>
 
@@ -2295,7 +3726,7 @@ await client.inbox.applyFix("inboxItemFixId", {
 <dl>
 <dd>
 
-Ignore a specific inbox item by its ID.
+Not yet implemented. Update knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
 
 </dd>
 </dl>
@@ -2311,9 +3742,21 @@ Ignore a specific inbox item by its ID.
 <dd>
 
 ```typescript
-await client.inbox.ignore("inboxItemId", {
-    appId: "appId",
-    itemType: "DUPLICATE_DOCUMENT",
+await client.knowledge.updateKnowledgeDocument("help-center", {
+    knowledgeDocumentId: {
+        referenceId: "getting-started",
+    },
+    versionId: {
+        type: "KNOWLEDGE_BASE_VERSION",
+        referenceId: "versionId",
+        appId: "maven",
+    },
+    contentType: "MARKDOWN",
+    content: "## Getting started\\nThis is a getting started guide for the help center.",
+    title: "Getting started",
+    metadata: {
+        category: "getting-started",
+    },
 });
 ```
 
@@ -2330,7 +3773,7 @@ await client.inbox.ignore("inboxItemId", {
 <dl>
 <dd>
 
-**inboxItemId:** `string` — Unique identifier for the inbox item.
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to update. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2338,7 +3781,7 @@ await client.inbox.ignore("inboxItemId", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.InboxItemIgnoreRequest`
+**request:** `MavenAGI.KnowledgeDocumentRequest`
 
 </dd>
 </dl>
@@ -2346,7 +3789,7 @@ await client.inbox.ignore("inboxItemId", {
 <dl>
 <dd>
 
-**requestOptions:** `Inbox.RequestOptions`
+**requestOptions:** `Knowledge.RequestOptions`
 
 </dd>
 </dl>
@@ -2357,9 +3800,7 @@ await client.inbox.ignore("inboxItemId", {
 </dl>
 </details>
 
-## Knowledge
-
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createOrUpdateKnowledgeBase</a>({ ...params }) -> MavenAGI.KnowledgeBaseResponse</code></summary>
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">deleteKnowledgeDocument</a>(knowledgeBaseReferenceId, knowledgeDocumentReferenceId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -2371,7 +3812,7 @@ await client.inbox.ignore("inboxItemId", {
 <dl>
 <dd>
 
-Update a knowledge base or create it if it doesn't exist.
+Not yet implemented. Delete knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
 
 </dd>
 </dl>
@@ -2387,12 +3828,7 @@ Update a knowledge base or create it if it doesn't exist.
 <dd>
 
 ```typescript
-await client.knowledge.createOrUpdateKnowledgeBase({
-    knowledgeBaseId: {
-        referenceId: "help-center",
-    },
-    name: "Help center",
-});
+await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started");
 ```
 
 </dd>
@@ -2408,7 +3844,15 @@ await client.knowledge.createOrUpdateKnowledgeBase({
 <dl>
 <dd>
 
-**request:** `MavenAGI.KnowledgeBaseRequest`
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to delete. All other entity ID fields are inferred from the request
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**knowledgeDocumentReferenceId:** `string` — The reference ID of the knowledge document to delete. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2427,7 +3871,9 @@ await client.knowledge.createOrUpdateKnowledgeBase({
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">getKnowledgeBase</a>(knowledgeBaseReferenceId) -> MavenAGI.KnowledgeBaseResponse</code></summary>
+## Organizations
+
+<details><summary><code>client.organizations.<a href="/src/api/resources/organizations/client/Client.ts">getConversationTable</a>({ ...params }) -> MavenAGI.ConversationTableResponse</code></summary>
 <dl>
 <dd>
 
@@ -2439,8 +3885,12 @@ await client.knowledge.createOrUpdateKnowledgeBase({
 <dl>
 <dd>
 
-Get an existing knowledge base by its supplied ID
+Retrieves structured conversation data across all organizations, formatted as a table,
+allowing users to group, filter, and define specific metrics to display as columns.
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -2455,7 +3905,40 @@ Get an existing knowledge base by its supplied ID
 <dd>
 
 ```typescript
-await client.knowledge.getKnowledgeBase("help-center");
+await client.organizations.getConversationTable({
+    conversationFilter: {
+        languages: ["en", "es"],
+    },
+    timeGrouping: "DAY",
+    fieldGroupings: [
+        {
+            field: "Category",
+        },
+    ],
+    columnDefinitions: [
+        {
+            header: "count",
+            metric: {
+                type: "count",
+            },
+        },
+        {
+            header: "avg_first_response_time",
+            metric: {
+                type: "average",
+                targetField: "FirstResponseTime",
+            },
+        },
+        {
+            header: "percentile_handle_time",
+            metric: {
+                type: "percentile",
+                targetField: "HandleTime",
+                percentile: 25,
+            },
+        },
+    ],
+});
 ```
 
 </dd>
@@ -2471,7 +3954,7 @@ await client.knowledge.getKnowledgeBase("help-center");
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to get. All other entity ID fields are inferred from the request.
+**request:** `MavenAGI.ConversationTableRequest`
 
 </dd>
 </dl>
@@ -2479,7 +3962,7 @@ await client.knowledge.getKnowledgeBase("help-center");
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Organizations.RequestOptions`
 
 </dd>
 </dl>
@@ -2490,7 +3973,7 @@ await client.knowledge.getKnowledgeBase("help-center");
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeBaseVersion</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseVersion</code></summary>
+<details><summary><code>client.organizations.<a href="/src/api/resources/organizations/client/Client.ts">getConversationChart</a>({ ...params }) -> MavenAGI.ChartResponse</code></summary>
 <dl>
 <dd>
 
@@ -2502,10 +3985,12 @@ await client.knowledge.getKnowledgeBase("help-center");
 <dl>
 <dd>
 
-Create a new knowledge base version.
-
-If an existing version is in progress, then that version will be finalized in an error state.
+Fetches conversation data across all organizations, visualized in a chart format.
+Supported chart types include pie chart, date histogram, and stacked bar charts.
 
+<Tip>
+This endpoint requires additional permissions. Contact support to request access.
+</Tip>
 </dd>
 </dl>
 </dd>
@@ -2520,16 +4005,17 @@ If an existing version is in progress, then that version will be finalized in an
 <dd>
 
 ```typescript
-await client.knowledge.createKnowledgeBaseVersion("help-center", {
-    versionId: {
-        type: "KNOWLEDGE_BASE_VERSION",
-        referenceId: "versionId",
-        appId: "maven",
-        organizationId: "acme",
-        agentId: "support",
+await client.organizations.getConversationChart({
+    type: "pieChart",
+    conversationFilter: {
+        languages: ["en", "es"],
+    },
+    groupBy: {
+        field: "Category",
+    },
+    metric: {
+        type: "count",
     },
-    type: "FULL",
-    status: "IN_PROGRESS",
 });
 ```
 
@@ -2546,15 +4032,7 @@ await client.knowledge.createKnowledgeBaseVersion("help-center", {
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a version for. All other entity ID fields are inferred from the request.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.KnowledgeBaseVersion`
+**request:** `MavenAGI.ConversationChartRequest`
 
 </dd>
 </dl>
@@ -2562,7 +4040,7 @@ await client.knowledge.createKnowledgeBaseVersion("help-center", {
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Organizations.RequestOptions`
 
 </dd>
 </dl>
@@ -2573,25 +4051,12 @@ await client.knowledge.createKnowledgeBaseVersion("help-center", {
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">finalizeKnowledgeBaseVersion</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseVersion</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
+## Segments
 
+<details><summary><code>client.segments.<a href="/src/api/resources/segments/client/Client.ts">search</a>({ ...params }) -> MavenAGI.SegmentsSearchResponse</code></summary>
 <dl>
 <dd>
 
-Finalize the latest knowledge base version. Required to indicate the version is complete. Will throw an exception if the latest version is not in progress.
-
-</dd>
-</dl>
-</dd>
-</dl>
-
 #### 🔌 Usage
 
 <dl>
@@ -2601,14 +4066,7 @@ Finalize the latest knowledge base version. Required to indicate the version is
 <dd>
 
 ```typescript
-await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
-    versionId: {
-        type: "KNOWLEDGE_BASE_VERSION",
-        referenceId: "versionId",
-        appId: "maven",
-    },
-    status: "SUCCEEDED",
-});
+await client.segments.search({});
 ```
 
 </dd>
@@ -2624,15 +4082,7 @@ await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to finalize a version for. All other entity ID fields are inferred from the request.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.FinalizeKnowledgeBaseVersionRequest`
+**request:** `MavenAGI.SegmentsSearchRequest`
 
 </dd>
 </dl>
@@ -2640,7 +4090,7 @@ await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Segments.RequestOptions`
 
 </dd>
 </dl>
@@ -2651,7 +4101,7 @@ await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
+<details><summary><code>client.segments.<a href="/src/api/resources/segments/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.SegmentResponse</code></summary>
 <dl>
 <dd>
 
@@ -2663,12 +4113,8 @@ await client.knowledge.finalizeKnowledgeBaseVersion("help-center", {
 <dl>
 <dd>
 
-Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
+Update a segment or create it if it doesn't exist.
 
-<Tip>
-This API maintains document version history. If for the same reference ID neither the `title` nor `text` fields 
-have changed, a new document version will not be created. The existing version will be reused.
-</Tip>
 </dd>
 </dl>
 </dd>
@@ -2683,20 +4129,24 @@ have changed, a new document version will not be created. The existing version w
 <dd>
 
 ```typescript
-await client.knowledge.createKnowledgeDocument("help-center", {
-    knowledgeDocumentId: {
-        referenceId: "getting-started",
-    },
-    versionId: {
-        type: "KNOWLEDGE_BASE_VERSION",
-        referenceId: "versionId",
-        appId: "maven",
+await client.segments.createOrUpdate({
+    segmentId: {
+        referenceId: "admin-users",
     },
-    contentType: "MARKDOWN",
-    content: "## Getting started\\nThis is a getting started guide for the help center.",
-    title: "Getting started",
-    metadata: {
-        category: "getting-started",
+    name: "Admin users",
+    precondition: {
+        preconditionType: "group",
+        operator: "AND",
+        preconditions: [
+            {
+                preconditionType: "user",
+                key: "userKey",
+            },
+            {
+                preconditionType: "user",
+                key: "userKey2",
+            },
+        ],
     },
 });
 ```
@@ -2714,15 +4164,7 @@ await client.knowledge.createKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a document for. All other entity ID fields are inferred from the request.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.KnowledgeDocumentRequest`
+**request:** `MavenAGI.SegmentRequest`
 
 </dd>
 </dl>
@@ -2730,7 +4172,7 @@ await client.knowledge.createKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Segments.RequestOptions`
 
 </dd>
 </dl>
@@ -2741,7 +4183,7 @@ await client.knowledge.createKnowledgeDocument("help-center", {
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">updateKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
+<details><summary><code>client.segments.<a href="/src/api/resources/segments/client/Client.ts">get</a>(segmentReferenceId, { ...params }) -> MavenAGI.SegmentResponse</code></summary>
 <dl>
 <dd>
 
@@ -2753,7 +4195,7 @@ await client.knowledge.createKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-Not yet implemented. Update knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
+Get a segment by its supplied ID
 
 </dd>
 </dl>
@@ -2769,22 +4211,7 @@ Not yet implemented. Update knowledge document. Requires an existing knowledge b
 <dd>
 
 ```typescript
-await client.knowledge.updateKnowledgeDocument("help-center", {
-    knowledgeDocumentId: {
-        referenceId: "getting-started",
-    },
-    versionId: {
-        type: "KNOWLEDGE_BASE_VERSION",
-        referenceId: "versionId",
-        appId: "maven",
-    },
-    contentType: "MARKDOWN",
-    content: "## Getting started\\nThis is a getting started guide for the help center.",
-    title: "Getting started",
-    metadata: {
-        category: "getting-started",
-    },
-});
+await client.segments.get("admin-users");
 ```
 
 </dd>
@@ -2800,7 +4227,7 @@ await client.knowledge.updateKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to update. All other entity ID fields are inferred from the request.
+**segmentReferenceId:** `string` — The reference ID of the segment to get. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2808,7 +4235,7 @@ await client.knowledge.updateKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-**request:** `MavenAGI.KnowledgeDocumentRequest`
+**request:** `MavenAGI.SegmentGetRequest`
 
 </dd>
 </dl>
@@ -2816,7 +4243,7 @@ await client.knowledge.updateKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Segments.RequestOptions`
 
 </dd>
 </dl>
@@ -2827,7 +4254,7 @@ await client.knowledge.updateKnowledgeDocument("help-center", {
 </dl>
 </details>
 
-<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">deleteKnowledgeDocument</a>(knowledgeBaseReferenceId, knowledgeDocumentReferenceId) -> void</code></summary>
+<details><summary><code>client.segments.<a href="/src/api/resources/segments/client/Client.ts">patch</a>(segmentReferenceId, { ...params }) -> MavenAGI.SegmentResponse</code></summary>
 <dl>
 <dd>
 
@@ -2839,7 +4266,10 @@ await client.knowledge.updateKnowledgeDocument("help-center", {
 <dl>
 <dd>
 
-Not yet implemented. Delete knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
+Update mutable segment fields
+
+The `appId` field can be provided to update a segment owned by a different app.
+All other fields will overwrite the existing value on the segment only if provided.
 
 </dd>
 </dl>
@@ -2855,7 +4285,7 @@ Not yet implemented. Delete knowledge document. Requires an existing knowledge b
 <dd>
 
 ```typescript
-await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started");
+await client.segments.patch("segmentReferenceId", {});
 ```
 
 </dd>
@@ -2871,7 +4301,7 @@ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started")
 <dl>
 <dd>
 
-**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to delete. All other entity ID fields are inferred from the request
+**segmentReferenceId:** `string` — The reference ID of the segment to update. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -2879,7 +4309,7 @@ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started")
 <dl>
 <dd>
 
-**knowledgeDocumentReferenceId:** `string` — The reference ID of the knowledge document to delete. All other entity ID fields are inferred from the request.
+**request:** `MavenAGI.SegmentPatchRequest`
 
 </dd>
 </dl>
@@ -2887,7 +4317,7 @@ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started")
 <dl>
 <dd>
 
-**requestOptions:** `Knowledge.RequestOptions`
+**requestOptions:** `Segments.RequestOptions`
 
 </dd>
 </dl>
@@ -2898,9 +4328,9 @@ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started")
 </dl>
 </details>
 
-## Organizations
+## Translations
 
-<details><summary><code>client.organizations.<a href="/src/api/resources/organizations/client/Client.ts">getConversationTable</a>({ ...params }) -> MavenAGI.ConversationTableResponse</code></summary>
+<details><summary><code>client.translations.<a href="/src/api/resources/translations/client/Client.ts">translate</a>({ ...params }) -> MavenAGI.TranslationResponse</code></summary>
 <dl>
 <dd>
 
@@ -2912,12 +4342,8 @@ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started")
 <dl>
 <dd>
 
-Retrieves structured conversation data across all organizations, formatted as a table,
-allowing users to group, filter, and define specific metrics to display as columns.
+Translate text from one language to another
 
-<Tip>
-This endpoint requires additional permissions. Contact support to request access.
-</Tip>
 </dd>
 </dl>
 </dd>
@@ -2932,39 +4358,9 @@ This endpoint requires additional permissions. Contact support to request access
 <dd>
 
 ```typescript
-await client.organizations.getConversationTable({
-    conversationFilter: {
-        languages: ["en", "es"],
-    },
-    timeGrouping: "DAY",
-    fieldGroupings: [
-        {
-            field: "Category",
-        },
-    ],
-    columnDefinitions: [
-        {
-            header: "count",
-            metric: {
-                type: "count",
-            },
-        },
-        {
-            header: "avg_first_response_time",
-            metric: {
-                type: "average",
-                targetField: "FirstResponseTime",
-            },
-        },
-        {
-            header: "percentile_handle_time",
-            metric: {
-                type: "percentile",
-                targetField: "HandleTime",
-                percentile: 25,
-            },
-        },
-    ],
+await client.translations.translate({
+    text: "Hello world",
+    targetLanguage: "es",
 });
 ```
 
@@ -2981,7 +4377,7 @@ await client.organizations.getConversationTable({
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationTableRequest`
+**request:** `MavenAGI.TranslationRequest`
 
 </dd>
 </dl>
@@ -2989,7 +4385,7 @@ await client.organizations.getConversationTable({
 <dl>
 <dd>
 
-**requestOptions:** `Organizations.RequestOptions`
+**requestOptions:** `Translations.RequestOptions`
 
 </dd>
 </dl>
@@ -3000,29 +4396,12 @@ await client.organizations.getConversationTable({
 </dl>
 </details>
 
-<details><summary><code>client.organizations.<a href="/src/api/resources/organizations/client/Client.ts">getConversationChart</a>({ ...params }) -> MavenAGI.ChartResponse</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
+## Triggers
 
+<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">search</a>({ ...params }) -> MavenAGI.EventTriggersSearchResponse</code></summary>
 <dl>
 <dd>
 
-Fetches conversation data across all organizations, visualized in a chart format.
-Supported chart types include pie chart, date histogram, and stacked bar charts.
-
-<Tip>
-This endpoint requires additional permissions. Contact support to request access.
-</Tip>
-</dd>
-</dl>
-</dd>
-</dl>
-
 #### 🔌 Usage
 
 <dl>
@@ -3032,18 +4411,7 @@ This endpoint requires additional permissions. Contact support to request access
 <dd>
 
 ```typescript
-await client.organizations.getConversationChart({
-    type: "pieChart",
-    conversationFilter: {
-        languages: ["en", "es"],
-    },
-    groupBy: {
-        field: "Category",
-    },
-    metric: {
-        type: "count",
-    },
-});
+await client.triggers.search({});
 ```
 
 </dd>
@@ -3059,7 +4427,7 @@ await client.organizations.getConversationChart({
 <dl>
 <dd>
 
-**request:** `MavenAGI.ConversationChartRequest`
+**request:** `MavenAGI.EventTriggersSearchRequest`
 
 </dd>
 </dl>
@@ -3067,7 +4435,7 @@ await client.organizations.getConversationChart({
 <dl>
 <dd>
 
-**requestOptions:** `Organizations.RequestOptions`
+**requestOptions:** `Triggers.RequestOptions`
 
 </dd>
 </dl>
@@ -3078,9 +4446,7 @@ await client.organizations.getConversationChart({
 </dl>
 </details>
 
-## Translations
-
-<details><summary><code>client.translations.<a href="/src/api/resources/translations/client/Client.ts">translate</a>({ ...params }) -> MavenAGI.TranslationResponse</code></summary>
+<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.EventTriggerResponse</code></summary>
 <dl>
 <dd>
 
@@ -3092,7 +4458,7 @@ await client.organizations.getConversationChart({
 <dl>
 <dd>
 
-Translate text from one language to another
+Update an event trigger or create it if it doesn't exist.
 
 </dd>
 </dl>
@@ -3108,9 +4474,12 @@ Translate text from one language to another
 <dd>
 
 ```typescript
-await client.translations.translate({
-    text: "Hello world",
-    targetLanguage: "es",
+await client.triggers.createOrUpdate({
+    triggerId: {
+        referenceId: "store-in-snowflake",
+    },
+    description: "Stores conversation data in Snowflake",
+    type: "CONVERSATION_CREATED",
 });
 ```
 
@@ -3127,7 +4496,7 @@ await client.translations.translate({
 <dl>
 <dd>
 
-**request:** `MavenAGI.TranslationRequest`
+**request:** `MavenAGI.EventTriggerRequest`
 
 </dd>
 </dl>
@@ -3135,7 +4504,7 @@ await client.translations.translate({
 <dl>
 <dd>
 
-**requestOptions:** `Translations.RequestOptions`
+**requestOptions:** `Triggers.RequestOptions`
 
 </dd>
 </dl>
@@ -3146,12 +4515,25 @@ await client.translations.translate({
 </dl>
 </details>
 
-## Triggers
+<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">get</a>(triggerReferenceId) -> MavenAGI.EventTriggerResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
 
-<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">search</a>({ ...params }) -> MavenAGI.EventTriggersSearchResponse</code></summary>
 <dl>
 <dd>
 
+Get an event trigger by its supplied ID
+
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -3161,7 +4543,7 @@ await client.translations.translate({
 <dd>
 
 ```typescript
-await client.triggers.search({});
+await client.triggers.get("store-in-snowflake");
 ```
 
 </dd>
@@ -3177,7 +4559,7 @@ await client.triggers.search({});
 <dl>
 <dd>
 
-**request:** `MavenAGI.EventTriggersSearchRequest`
+**triggerReferenceId:** `string` — The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -3196,7 +4578,7 @@ await client.triggers.search({});
 </dl>
 </details>
 
-<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.EventTriggerResponse</code></summary>
+<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">delete</a>(triggerReferenceId) -> void</code></summary>
 <dl>
 <dd>
 
@@ -3208,7 +4590,7 @@ await client.triggers.search({});
 <dl>
 <dd>
 
-Update an event trigger or create it if it doesn't exist.
+Delete an event trigger
 
 </dd>
 </dl>
@@ -3224,13 +4606,7 @@ Update an event trigger or create it if it doesn't exist.
 <dd>
 
 ```typescript
-await client.triggers.createOrUpdate({
-    triggerId: {
-        referenceId: "store-in-snowflake",
-    },
-    description: "Stores conversation data in Snowflake",
-    type: "CONVERSATION_CREATED",
-});
+await client.triggers.delete("store-in-snowflake");
 ```
 
 </dd>
@@ -3246,7 +4622,7 @@ await client.triggers.createOrUpdate({
 <dl>
 <dd>
 
-**request:** `MavenAGI.EventTriggerRequest`
+**triggerReferenceId:** `string` — The reference ID of the event trigger to delete. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -3265,7 +4641,7 @@ await client.triggers.createOrUpdate({
 </dl>
 </details>
 
-<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">get</a>(triggerReferenceId) -> MavenAGI.EventTriggerResponse</code></summary>
+<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">partialUpdate</a>(triggerReferenceId, { ...params }) -> MavenAGI.EventTriggerResponse</code></summary>
 <dl>
 <dd>
 
@@ -3277,7 +4653,7 @@ await client.triggers.createOrUpdate({
 <dl>
 <dd>
 
-Get an event trigger by its supplied ID
+Updates an event trigger. Only the enabled field is editable.
 
 </dd>
 </dl>
@@ -3293,7 +4669,9 @@ Get an event trigger by its supplied ID
 <dd>
 
 ```typescript
-await client.triggers.get("store-in-snowflake");
+await client.triggers.partialUpdate("triggerReferenceId", {
+    body: {},
+});
 ```
 
 </dd>
@@ -3309,7 +4687,15 @@ await client.triggers.get("store-in-snowflake");
 <dl>
 <dd>
 
-**triggerReferenceId:** `string` — The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
+**triggerReferenceId:** `string` — The reference ID of the event trigger to update. All other entity ID fields are inferred from the request.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.PartialUpdateRequest`
 
 </dd>
 </dl>
@@ -3328,7 +4714,9 @@ await client.triggers.get("store-in-snowflake");
 </dl>
 </details>
 
-<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">delete</a>(triggerReferenceId) -> void</code></summary>
+## Users
+
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">search</a>({ ...params }) -> MavenAGI.AgentUserSearchResponse</code></summary>
 <dl>
 <dd>
 
@@ -3340,7 +4728,9 @@ await client.triggers.get("store-in-snowflake");
 <dl>
 <dd>
 
-Delete an event trigger
+Search across all agent users on an agent.
+
+Agent users are a merged view of the users created by individual apps.
 
 </dd>
 </dl>
@@ -3356,7 +4746,7 @@ Delete an event trigger
 <dd>
 
 ```typescript
-await client.triggers.delete("store-in-snowflake");
+await client.users.search({});
 ```
 
 </dd>
@@ -3372,7 +4762,7 @@ await client.triggers.delete("store-in-snowflake");
 <dl>
 <dd>
 
-**triggerReferenceId:** `string` — The reference ID of the event trigger to delete. All other entity ID fields are inferred from the request.
+**request:** `MavenAGI.AgentUserSearchRequest`
 
 </dd>
 </dl>
@@ -3380,7 +4770,7 @@ await client.triggers.delete("store-in-snowflake");
 <dl>
 <dd>
 
-**requestOptions:** `Triggers.RequestOptions`
+**requestOptions:** `Users.RequestOptions`
 
 </dd>
 </dl>
@@ -3391,7 +4781,7 @@ await client.triggers.delete("store-in-snowflake");
 </dl>
 </details>
 
-<details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">partialUpdate</a>(triggerReferenceId, { ...params }) -> MavenAGI.EventTriggerResponse</code></summary>
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">getAgentUser</a>(userId) -> MavenAGI.AgentUser</code></summary>
 <dl>
 <dd>
 
@@ -3403,7 +4793,9 @@ await client.triggers.delete("store-in-snowflake");
 <dl>
 <dd>
 
-Updates an event trigger. Only the enabled field is editable.
+Get an agent user by its supplied ID.
+
+Agent users are a merged view of the users created by individual apps.
 
 </dd>
 </dl>
@@ -3419,9 +4811,7 @@ Updates an event trigger. Only the enabled field is editable.
 <dd>
 
 ```typescript
-await client.triggers.partialUpdate("triggerReferenceId", {
-    body: {},
-});
+await client.users.getAgentUser("userId");
 ```
 
 </dd>
@@ -3437,15 +4827,7 @@ await client.triggers.partialUpdate("triggerReferenceId", {
 <dl>
 <dd>
 
-**triggerReferenceId:** `string` — The reference ID of the event trigger to update. All other entity ID fields are inferred from the request.
-
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `MavenAGI.PartialUpdateRequest`
+**userId:** `string` — The ID of the agent user to get.
 
 </dd>
 </dl>
@@ -3453,7 +4835,7 @@ await client.triggers.partialUpdate("triggerReferenceId", {
 <dl>
 <dd>
 
-**requestOptions:** `Triggers.RequestOptions`
+**requestOptions:** `Users.RequestOptions`
 
 </dd>
 </dl>
@@ -3464,8 +4846,6 @@ await client.triggers.partialUpdate("triggerReferenceId", {
 </dl>
 </details>
 
-## Users
-
 <details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.AppUserResponse</code></summary>
 <dl>
 <dd>
@@ -3478,7 +4858,7 @@ await client.triggers.partialUpdate("triggerReferenceId", {
 <dl>
 <dd>
 
-Update a user or create it if it doesn't exist.
+Update an app user or create it if it doesn't exist.
 
 </dd>
 </dl>
@@ -3557,7 +4937,7 @@ await client.users.createOrUpdate({
 <dl>
 <dd>
 
-Get a user by its supplied ID
+Get an app user by its supplied ID
 
 </dd>
 </dl>
@@ -3589,7 +4969,7 @@ await client.users.get("user-0");
 <dl>
 <dd>
 
-**userId:** `string` — The reference ID of the user to get. All other entity ID fields are inferred from the request.
+**userId:** `string` — The reference ID of the app user to get. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>
@@ -3665,7 +5045,7 @@ await client.users.delete("user-0");
 <dl>
 <dd>
 
-**userId:** `string` — The reference ID of the user to delete. All other entity ID fields are inferred from the request.
+**userId:** `string` — The reference ID of the app user to delete. All other entity ID fields are inferred from the request.
 
 </dd>
 </dl>