featurebase-node 0.12.0 → 0.14.0

package/resources/support/conversations/conversations.js

@@ -17,6 +17,91 @@ class Conversations extends resource_1.APIResource {
         super(...arguments);
         this.participants = new ParticipantsAPI.Participants(this._client);
     }
+    /**
+     * Returns a list of conversations in your organization using cursor-based
+     * pagination.
+     *
+     * ### Query Parameters
+     *
+     * - `limit` - Number of conversations to return (1-100, default 10)
+     * - `cursor` - Cursor from previous response for pagination
+     * - `tagIds` - Optional tag filter as a comma-separated list of tag IDs. Matches
+     *   conversations that contain all of the provided tags.
+     *
+     * ### Response Format
+     *
+     * Returns a list object with:
+     *
+     * - `object` - Always "list"
+     * - `data` - Array of conversation objects
+     * - `nextCursor` - Cursor for the next page, or null if no more results
+     *
+     * ### Conversation Object
+     *
+     * Each conversation includes:
+     *
+     * - `id` - Unique conversation identifier (short ID)
+     * - `title` - Conversation title
+     * - `state` - Current state ("open", "closed", or "snoozed")
+     * - `priority` - Whether the conversation is marked as priority
+     * - `adminAssigneeId` - ID of assigned admin (if any)
+     * - `teamAssigneeId` - ID of assigned team (if any)
+     * - `tags` - Current tags applied anywhere in the conversation
+     * - `participants` - Array of participants
+     * - `source` - Information about the first message
+     * - `createdAt` - Creation timestamp
+     * - `updatedAt` - Last update timestamp
+     *
+     * ### Example
+     *
+     * ```json
+     * {
+     *   "object": "list",
+     *   "data": [
+     *     {
+     *       "object": "conversation",
+     *       "id": "12345",
+     *       "title": "Question about pricing",
+     *       "state": "open",
+     *       "priority": false,
+     *       "adminAssigneeId": null,
+     *       "participants": [
+     *         { "type": "customer", "id": "676f0f6765bdaa7d7d760f88" }
+     *       ],
+     *       ...
+     *     }
+     *   ],
+     *   "nextCursor": "eyJpZCI6IjEyMzQ1In0="
+     * }
+     * ```
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const conversation of client.support.conversations.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+        return this._client.getAPIList('/v2/conversations', (pagination_1.CursorPage), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(featurebaseVersion?.toString() != null ?
+                        { 'Featurebase-Version': featurebaseVersion?.toString() }
+                        : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
     /**
      * Creates a new conversation. Supports both contact-initiated (customer/lead) and
      * admin-initiated (outreach) conversations.
@@ -270,8 +355,57 @@ class Conversations extends resource_1.APIResource {
      * ```
      */
     retrieve(id, params = {}, options) {
-        const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+        const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
         return this._client.get((0, path_1.path) `/v2/conversations/${id}`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(featurebaseVersion?.toString() != null ?
+                        { 'Featurebase-Version': featurebaseVersion?.toString() }
+                        : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Permanently deletes a conversation by its short ID.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The conversation short ID (numeric)
+     *
+     * ### Response
+     *
+     * Returns a deletion confirmation object:
+     *
+     * ```json
+     * {
+     *   "id": "12345",
+     *   "object": "conversation",
+     *   "deleted": true
+     * }
+     * ```
+     *
+     * ### Caution
+     *
+     * This operation is **irreversible**. The conversation and all its messages will
+     * be permanently deleted.
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const conversation =
+     *   await client.support.conversations.delete('12345');
+     * ```
+     */
+    delete(id, params = {}, options) {
+        const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+        return this._client.delete((0, path_1.path) `/v2/conversations/${id}`, {
             ...options,
             headers: (0, headers_1.buildHeaders)([
                 {
@@ -303,7 +437,7 @@ class Conversations extends resource_1.APIResource {
      * | `adminAssigneeId`  | string/null | Admin ID to assign, or null to unassign                                                                                         |
      * | `teamAssigneeId`   | string/null | Team ID to assign, or null to unassign                                                                                          |
      * | `title`            | string      | Conversation title                                                                                                              |
-     * | `customAttributes` | object      | Custom attributes to set on the conversation                                                                                    |
+     * | `customAttributes` | object      | Custom attributes to set on the conversation, keyed by conversation custom attribute ID                                         |
      * | `markAsRead`       | object      | Mark conversation as read for specific users                                                                                    |
      *
      * ### markAsRead Object
@@ -363,8 +497,8 @@ class Conversations extends resource_1.APIResource {
      * {
      *   "title": "Billing Issue - Priority",
      *   "customAttributes": {
-     *     "priority_level": "high",
-     *     "category": "billing"
+     *     "507f1f77bcf86cd799439011": 10,
+     *     "507f1f77bcf86cd799439012": true
      *   }
      * }
      * ```
@@ -426,172 +560,97 @@ class Conversations extends resource_1.APIResource {
         });
     }
     /**
-     * Returns a list of conversations in your organization using cursor-based
-     * pagination.
+     * Adds a reply to an existing conversation. Supports both contact (customer/lead)
+     * and admin replies.
      *
-     * ### Query Parameters
+     * ### Path Parameters
      *
-     * - `limit` - Number of conversations to return (1-100, default 10)
-     * - `cursor` - Cursor from previous response for pagination
-     * - `tagIds` - Optional tag filter as a comma-separated list of tag IDs. Matches
-     *   conversations that contain all of the provided tags.
+     * - `id` - The conversation ID (short ID)
      *
-     * ### Response Format
+     * ### Request Body
      *
-     * Returns a list object with:
+     * The request body varies based on who is sending the reply:
      *
-     * - `object` - Always "list"
-     * - `data` - Array of conversation objects
-     * - `nextCursor` - Cursor for the next page, or null if no more results
+     * #### Contact Reply (customer/lead)
      *
-     * ### Conversation Object
+     * | Field               | Type    | Required | Description                                                                                                                        |
+     * | ------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+     * | `type`              | string  | Yes      | Must be "contact"                                                                                                                  |
+     * | `userId`            | string  | No\*     | External user ID from your system                                                                                                  |
+     * | `id`                | string  | No\*     | Featurebase contact ID (24-character ObjectId)                                                                                     |
+     * | `bodyMarkdown`      | string  | Yes      | The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. |
+     * | `messageType`       | string  | Yes      | Must be "reply"                                                                                                                    |
+     * | `skipNotifications` | boolean | No       | Skip sending notifications (default: false). Useful for bulk imports.                                                              |
      *
-     * Each conversation includes:
+     * \*At least one of `userId` or `id` is required.
      *
-     * - `id` - Unique conversation identifier (short ID)
-     * - `title` - Conversation title
-     * - `state` - Current state ("open", "closed", or "snoozed")
-     * - `priority` - Whether the conversation is marked as priority
-     * - `adminAssigneeId` - ID of assigned admin (if any)
-     * - `teamAssigneeId` - ID of assigned team (if any)
-     * - `tags` - Current tags applied anywhere in the conversation
-     * - `participants` - Array of participants
-     * - `source` - Information about the first message
-     * - `createdAt` - Creation timestamp
-     * - `updatedAt` - Last update timestamp
+     * #### Admin Reply
      *
-     * ### Example
+     * | Field               | Type    | Required | Description                                                                                                                        |
+     * | ------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+     * | `type`              | string  | Yes      | Must be "admin"                                                                                                                    |
+     * | `id`                | string  | Yes      | Featurebase admin ID (24-character ObjectId)                                                                                       |
+     * | `bodyMarkdown`      | string  | Yes      | The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. |
+     * | `messageType`       | string  | Yes      | "reply" for customer-visible reply, "note" for internal note                                                                       |
+     * | `skipNotifications` | boolean | No       | Skip sending notifications (default: false). Useful for bulk imports.                                                              |
+     *
+     * ### Response
+     *
+     * Returns the created conversation part object with a **201 Created** status. The
+     * response includes both `bodyHtml` (with signed image URLs) and `bodyMarkdown`
+     * fields.
+     *
+     * ### Example Contact Reply
      *
      * ```json
      * {
-     *   "object": "list",
-     *   "data": [
-     *     {
-     *       "object": "conversation",
-     *       "id": "12345",
-     *       "title": "Question about pricing",
-     *       "state": "open",
-     *       "priority": false,
-     *       "adminAssigneeId": null,
-     *       "participants": [
-     *         { "type": "customer", "id": "676f0f6765bdaa7d7d760f88" }
-     *       ],
-     *       ...
-     *     }
-     *   ],
-     *   "nextCursor": "eyJpZCI6IjEyMzQ1In0="
+     *   "type": "contact",
+     *   "userId": "user_123",
+     *   "bodyMarkdown": "Thank you for your help!",
+     *   "messageType": "reply"
      * }
      * ```
      *
-     * ### Version Availability
-     *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     * ### Example Admin Reply
      *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const conversation of client.support.conversations.list()) {
-     *   // ...
+     * ```json
+     * {
+     *   "type": "admin",
+     *   "id": "507f1f77bcf86cd799439011",
+     *   "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
+     *   "messageType": "reply"
      * }
      * ```
-     */
-    list(params = {}, options) {
-        const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-        return this._client.getAPIList('/v2/conversations', (pagination_1.CursorPage), {
-            query,
-            ...options,
-            headers: (0, headers_1.buildHeaders)([
-                {
-                    ...(featurebaseVersion?.toString() != null ?
-                        { 'Featurebase-Version': featurebaseVersion?.toString() }
-                        : undefined),
-                },
-                options?.headers,
-            ]),
-        });
-    }
-    /**
-     * Permanently deletes a conversation by its short ID.
-     *
-     * ### Path Parameters
-     *
-     * - `id` - The conversation short ID (numeric)
-     *
-     * ### Response
      *
-     * Returns a deletion confirmation object:
+     * ### Example Admin Note (Internal)
      *
      * ```json
      * {
-     *   "id": "12345",
-     *   "object": "conversation",
-     *   "deleted": true
+     *   "type": "admin",
+     *   "id": "507f1f77bcf86cd799439011",
+     *   "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
+     *   "messageType": "note"
      * }
      * ```
      *
-     * ### Caution
-     *
-     * This operation is **irreversible**. The conversation and all its messages will
-     * be permanently deleted.
-     *
-     * ### Version Availability
-     *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
-     *
-     * @example
-     * ```ts
-     * const conversation =
-     *   await client.support.conversations.delete('12345');
-     * ```
-     */
-    delete(id, params = {}, options) {
-        const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-        return this._client.delete((0, path_1.path) `/v2/conversations/${id}`, {
-            ...options,
-            headers: (0, headers_1.buildHeaders)([
-                {
-                    ...(featurebaseVersion?.toString() != null ?
-                        { 'Featurebase-Version': featurebaseVersion?.toString() }
-                        : undefined),
-                },
-                options?.headers,
-            ]),
-        });
-    }
-    /**
-     * Attaches a workspace tag to a conversation.
-     *
-     * This endpoint requires both the tag ID to attach and the `actingAdminId` of the
-     * admin on whose behalf the mutation is recorded.
-     *
-     * ### Path Parameters
-     *
-     * - `id` - The conversation ID (short ID)
-     *
-     * ### Request Body
-     *
-     * | Field           | Type   | Required | Description                                                              |
-     * | --------------- | ------ | -------- | ------------------------------------------------------------------------ |
-     * | `tagId`         | string | Yes      | The Featurebase tag ID to attach                                         |
-     * | `actingAdminId` | string | Yes      | The admin performing the mutation. Must be a member of the organization. |
-     *
-     * ### Behavior
-     *
-     * Featurebase resolves the latest taggable reply/message in the conversation and
-     * records the tag attachment against that part so audit metadata remains
-     * deterministic.
-     *
-     * ### Response
-     *
-     * Returns the affected tag plus attachment metadata such as `targetPartId`,
-     * `appliedAt`, and `appliedBy`.
-     *
-     * ### Example Request
+     * ### Example Response
      *
      * ```json
      * {
-     *   "tagId": "67ec1234abcd5678ef901234",
-     *   "actingAdminId": "507f1f77bcf86cd799439011"
+     *   "object": "conversation_part",
+     *   "id": "3",
+     *   "partType": "user_msg",
+     *   "bodyHtml": "<p>Thank you for your help!</p>",
+     *   "bodyMarkdown": "Thank you for your help!",
+     *   "author": {
+     *     "type": "customer",
+     *     "id": "676f0f6765bdaa7d7d760f88",
+     *     "name": "John Doe",
+     *     "email": "john@example.com"
+     *   },
+     *   "channel": "desktop",
+     *   "createdAt": "2025-01-15T10:40:00.000Z",
+     *   "updatedAt": "2025-01-15T10:40:00.000Z"
      * }
      * ```
      *
@@ -601,83 +660,17 @@ class Conversations extends resource_1.APIResource {
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.support.conversations.attachTag('12345', {
-     *     actingAdminId: '507f1f77bcf86cd799439011',
-     *     tagId: '67ec1234abcd5678ef901234',
+     * const conversationPart =
+     *   await client.support.conversations.reply('12345', {
+     *     bodyMarkdown: 'Thank you for your help!',
+     *     messageType: 'reply',
+     *     type: 'contact',
      *   });
      * ```
      */
-    attachTag(id, params, options) {
+    reply(id, params, options) {
         const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-        return this._client.post((0, path_1.path) `/v2/conversations/${id}/tags`, {
-            body,
-            ...options,
-            headers: (0, headers_1.buildHeaders)([
-                {
-                    ...(featurebaseVersion?.toString() != null ?
-                        { 'Featurebase-Version': featurebaseVersion?.toString() }
-                        : undefined),
-                },
-                options?.headers,
-            ]),
-        });
-    }
-    /**
-     * Removes a workspace tag from a conversation.
-     *
-     * This endpoint requires the `actingAdminId` of the admin on whose behalf the
-     * mutation is recorded.
-     *
-     * ### Path Parameters
-     *
-     * - `id` - The conversation ID (short ID)
-     * - `tagId` - The Featurebase tag ID to remove
-     *
-     * ### Request Body
-     *
-     * | Field           | Type   | Required | Description                                                              |
-     * | --------------- | ------ | -------- | ------------------------------------------------------------------------ |
-     * | `actingAdminId` | string | Yes      | The admin performing the mutation. Must be a member of the organization. |
-     *
-     * ### Behavior
-     *
-     * Featurebase resolves the latest taggable reply/message in the conversation and
-     * records the tag removal against that part so audit metadata remains
-     * deterministic.
-     *
-     * ### Response
-     *
-     * Returns the affected tag payload with the most relevant attachment metadata
-     * available for that relationship.
-     *
-     * ### Example Request
-     *
-     * ```json
-     * {
-     *   "actingAdminId": "507f1f77bcf86cd799439011"
-     * }
-     * ```
-     *
-     * ### Version Availability
-     *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
-     *
-     * @example
-     * ```ts
-     * const response =
-     *   await client.support.conversations.detachTag(
-     *     '67ec1234abcd5678ef901234',
-     *     {
-     *       id: '12345',
-     *       actingAdminId: '507f1f77bcf86cd799439011',
-     *     },
-     *   );
-     * ```
-     */
-    detachTag(tagID, params, options) {
-        const { id, 'Featurebase-Version': featurebaseVersion, ...body } = params;
-        return this._client.delete((0, path_1.path) `/v2/conversations/${id}/tags/${tagID}`, {
+        return this._client.post((0, path_1.path) `/v2/conversations/${id}/reply`, {
             body,
             ...options,
             headers: (0, headers_1.buildHeaders)([
@@ -784,8 +777,10 @@ class Conversations extends resource_1.APIResource {
         });
     }
     /**
-     * Adds a reply to an existing conversation. Supports both contact (customer/lead)
-     * and admin replies.
+     * Attaches a workspace tag to a conversation.
+     *
+     * This endpoint requires both the tag ID to attach and the `actingAdminId` of the
+     * admin on whose behalf the mutation is recorded.
      *
      * ### Path Parameters
      *
@@ -793,88 +788,92 @@ class Conversations extends resource_1.APIResource {
      *
      * ### Request Body
      *
-     * The request body varies based on who is sending the reply:
-     *
-     * #### Contact Reply (customer/lead)
-     *
-     * | Field               | Type    | Required | Description                                                                                                                        |
-     * | ------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-     * | `type`              | string  | Yes      | Must be "contact"                                                                                                                  |
-     * | `userId`            | string  | No\*     | External user ID from your system                                                                                                  |
-     * | `id`                | string  | No\*     | Featurebase contact ID (24-character ObjectId)                                                                                     |
-     * | `bodyMarkdown`      | string  | Yes      | The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. |
-     * | `messageType`       | string  | Yes      | Must be "reply"                                                                                                                    |
-     * | `skipNotifications` | boolean | No       | Skip sending notifications (default: false). Useful for bulk imports.                                                              |
-     *
-     * \*At least one of `userId` or `id` is required.
+     * | Field           | Type   | Required | Description                                                              |
+     * | --------------- | ------ | -------- | ------------------------------------------------------------------------ |
+     * | `tagId`         | string | Yes      | The Featurebase tag ID to attach                                         |
+     * | `actingAdminId` | string | Yes      | The admin performing the mutation. Must be a member of the organization. |
      *
-     * #### Admin Reply
+     * ### Behavior
      *
-     * | Field               | Type    | Required | Description                                                                                                                        |
-     * | ------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-     * | `type`              | string  | Yes      | Must be "admin"                                                                                                                    |
-     * | `id`                | string  | Yes      | Featurebase admin ID (24-character ObjectId)                                                                                       |
-     * | `bodyMarkdown`      | string  | Yes      | The message content in markdown format. Images referenced by URL or as base64 data URIs will be automatically uploaded and stored. |
-     * | `messageType`       | string  | Yes      | "reply" for customer-visible reply, "note" for internal note                                                                       |
-     * | `skipNotifications` | boolean | No       | Skip sending notifications (default: false). Useful for bulk imports.                                                              |
+     * Featurebase resolves the latest taggable reply/message in the conversation and
+     * records the tag attachment against that part so audit metadata remains
+     * deterministic.
      *
      * ### Response
      *
-     * Returns the created conversation part object with a **201 Created** status. The
-     * response includes both `bodyHtml` (with signed image URLs) and `bodyMarkdown`
-     * fields.
+     * Returns the affected tag plus attachment metadata such as `targetPartId`,
+     * `appliedAt`, and `appliedBy`.
      *
-     * ### Example Contact Reply
+     * ### Example Request
      *
      * ```json
      * {
-     *   "type": "contact",
-     *   "userId": "user_123",
-     *   "bodyMarkdown": "Thank you for your help!",
-     *   "messageType": "reply"
+     *   "tagId": "67ec1234abcd5678ef901234",
+     *   "actingAdminId": "507f1f77bcf86cd799439011"
      * }
      * ```
      *
-     * ### Example Admin Reply
+     * ### Version Availability
      *
-     * ```json
-     * {
-     *   "type": "admin",
-     *   "id": "507f1f77bcf86cd799439011",
-     *   "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
-     *   "messageType": "reply"
-     * }
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const attachedConversationTag =
+     *   await client.support.conversations.attachTag('12345', {
+     *     actingAdminId: '507f1f77bcf86cd799439011',
+     *     tagId: '67ec1234abcd5678ef901234',
+     *   });
      * ```
+     */
+    attachTag(id, params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.post((0, path_1.path) `/v2/conversations/${id}/tags`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(featurebaseVersion?.toString() != null ?
+                        { 'Featurebase-Version': featurebaseVersion?.toString() }
+                        : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Removes a workspace tag from a conversation.
      *
-     * ### Example Admin Note (Internal)
+     * This endpoint requires the `actingAdminId` of the admin on whose behalf the
+     * mutation is recorded.
      *
-     * ```json
-     * {
-     *   "type": "admin",
-     *   "id": "507f1f77bcf86cd799439011",
-     *   "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
-     *   "messageType": "note"
-     * }
-     * ```
+     * ### Path Parameters
      *
-     * ### Example Response
+     * - `id` - The conversation ID (short ID)
+     * - `tagId` - The Featurebase tag ID to remove
+     *
+     * ### Request Body
+     *
+     * | Field           | Type   | Required | Description                                                              |
+     * | --------------- | ------ | -------- | ------------------------------------------------------------------------ |
+     * | `actingAdminId` | string | Yes      | The admin performing the mutation. Must be a member of the organization. |
+     *
+     * ### Behavior
+     *
+     * Featurebase resolves the latest taggable reply/message in the conversation and
+     * records the tag removal against that part so audit metadata remains
+     * deterministic.
+     *
+     * ### Response
+     *
+     * Returns the affected tag payload with the most relevant attachment metadata
+     * available for that relationship.
+     *
+     * ### Example Request
      *
      * ```json
      * {
-     *   "object": "conversation_part",
-     *   "id": "3",
-     *   "partType": "user_msg",
-     *   "bodyHtml": "<p>Thank you for your help!</p>",
-     *   "bodyMarkdown": "Thank you for your help!",
-     *   "author": {
-     *     "type": "customer",
-     *     "id": "676f0f6765bdaa7d7d760f88",
-     *     "name": "John Doe",
-     *     "email": "john@example.com"
-     *   },
-     *   "channel": "desktop",
-     *   "createdAt": "2025-01-15T10:40:00.000Z",
-     *   "updatedAt": "2025-01-15T10:40:00.000Z"
+     *   "actingAdminId": "507f1f77bcf86cd799439011"
      * }
      * ```
      *
@@ -884,17 +883,19 @@ class Conversations extends resource_1.APIResource {
      *
      * @example
      * ```ts
-     * const conversationPart =
-     *   await client.support.conversations.reply('12345', {
-     *     bodyMarkdown: 'Thank you for your help!',
-     *     messageType: 'reply',
-     *     type: 'contact',
-     *   });
+     * const attachedConversationTag =
+     *   await client.support.conversations.detachTag(
+     *     '67ec1234abcd5678ef901234',
+     *     {
+     *       id: '12345',
+     *       actingAdminId: '507f1f77bcf86cd799439011',
+     *     },
+     *   );
      * ```
      */
-    reply(id, params, options) {
-        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-        return this._client.post((0, path_1.path) `/v2/conversations/${id}/reply`, {
+    detachTag(tagID, params, options) {
+        const { id, 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.delete((0, path_1.path) `/v2/conversations/${id}/tags/${tagID}`, {
             body,
             ...options,
             headers: (0, headers_1.buildHeaders)([
@@ -915,7 +916,7 @@ class Conversations extends resource_1.APIResource {
      *
      * - **Filter mode** (`query` set, `search` omitted): structured filtering against
      *   indexed conversation fields. Sorted by `lastActivityAt` desc by default; set
-     *   `sort` to `last_activity_at:asc` for the inverse.
+     *   `sort` to `lastActivityAt:asc` for the inverse.
      * - **Search mode** (`search` set, `query` optional): full-text search across
      *   conversation messages, then narrowed by the same `query` AST so the same
      *   filters apply. Results are ranked by relevance by default; set `sort` to order
@@ -934,7 +935,7 @@ class Conversations extends resource_1.APIResource {
      *     "value": [
      *       { "field": "state", "operator": "=", "value": "open" },
      *       {
-     *         "field": "admin_assignee_id",
+     *         "field": "adminAssigneeId",
      *         "operator": "=",
      *         "value": "507f1f77bcf86cd799439011"
      *       }
@@ -947,18 +948,24 @@ class Conversations extends resource_1.APIResource {
      *
      * ### Supported fields and operators
      *
-     * | Field                        | Type                                                                        | Operators              |
-     * | ---------------------------- | --------------------------------------------------------------------------- | ---------------------- |
-     * | `state`                      | enum (`open` / `closed` / `snoozed`)                                        | `=`, `!=`, `IN`, `NIN` |
-     * | `priority`                   | boolean                                                                     | `=`, `!=`              |
-     * | `admin_assignee_id`          | id or null (unassigned)                                                     | `=`, `!=`, `IN`, `NIN` |
-     * | `team_assignee_id`           | id or null (unassigned)                                                     | `=`, `!=`, `IN`, `NIN` |
-     * | `brand_id`                   | id or null                                                                  | `=`, `!=`, `IN`, `NIN` |
-     * | `tag_ids`                    | id (matches any conversation containing this tag)                           | `=`, `!=`, `IN`, `NIN` |
-     * | `user_id` / `participant_id` | id of a conversation participant                                            | `=`, `!=`, `IN`, `NIN` |
-     * | `company_id`                 | company id (matches conversations whose participants belong to the company) | `=`, `!=`, `IN`, `NIN` |
-     * | `mentioned_admin_ids`        | admin id                                                                    | `=`, `!=`, `IN`, `NIN` |
-     * | `created_at`                 | unix seconds                                                                | `=`, `>`, `<`          |
+     * Field names are camelCase, matching the rest of the v2 public API. Snake_case
+     * names that this endpoint originally shipped with (`admin_assignee_id`,
+     * `team_assignee_id`, `brand_id`, `tag_ids`, `mentioned_admin_ids`, `user_id`,
+     * `participant_id`, `company_id`, `created_at`) are still accepted for back-compat
+     * but are deprecated — please migrate to camelCase in new code.
+     *
+     * | Field                      | Type                                                                        | Operators              |
+     * | -------------------------- | --------------------------------------------------------------------------- | ---------------------- |
+     * | `state`                    | enum (`open` / `closed` / `snoozed`)                                        | `=`, `!=`, `IN`, `NIN` |
+     * | `priority`                 | boolean                                                                     | `=`, `!=`              |
+     * | `adminAssigneeId`          | id or null (unassigned)                                                     | `=`, `!=`, `IN`, `NIN` |
+     * | `teamAssigneeId`           | id or null (unassigned)                                                     | `=`, `!=`, `IN`, `NIN` |
+     * | `brandId`                  | id or null                                                                  | `=`, `!=`, `IN`, `NIN` |
+     * | `tagIds`                   | id (matches any conversation containing this tag)                           | `=`, `!=`, `IN`, `NIN` |
+     * | `userId` / `participantId` | id of a conversation participant                                            | `=`, `!=`, `IN`, `NIN` |
+     * | `companyId`                | company id (matches conversations whose participants belong to the company) | `=`, `!=`, `IN`, `NIN` |
+     * | `mentionedAdminIds`        | admin id                                                                    | `=`, `!=`, `IN`, `NIN` |
+     * | `createdAt`                | unix seconds                                                                | `=`, `>`, `<`          |
      *
      * For unbounded fields a query consisting only of `!=` or `NIN` clauses is
      * rejected with `query_too_broad` to prevent full-org scans. Combine the negation