featurebase-node 0.13.0 → 0.14.0

package/src/resources/support/conversations/conversations.ts

@@ -2,7 +2,9 @@
 
 import { APIResource } from '../../../core/resource';
 import * as ConversationsAPI from './conversations';
+import * as ConversationAttributesAPI from '../../conversation-attributes';
 import * as ConversationTagsAPI from '../conversation-tags';
+import * as PostsAPI from '../../feedback/posts/posts';
 import * as ParticipantsAPI from './participants';
 import { ParticipantAddParams, ParticipantRemoveParams, Participants } from './participants';
 import { APIPromise } from '../../../core/api-promise';
@@ -17,6 +19,95 @@ import { path } from '../../../internal/utils/path';
 export class Conversations extends APIResource {
   participants: ParticipantsAPI.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: ConversationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ConversationsCursorPage, Conversation> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.getAPIList('/v2/conversations', CursorPage<Conversation>, {
+      query,
+      ...options,
+      headers: 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.
@@ -275,8 +366,62 @@ export class Conversations extends APIResource {
     params: ConversationRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Conversation> {
-    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
     return this._client.get(path`/v2/conversations/${id}`, {
+      query,
+      ...options,
+      headers: 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: string,
+    params: ConversationDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConversationDeleteResponse> {
+    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+    return this._client.delete(path`/v2/conversations/${id}`, {
       ...options,
       headers: buildHeaders([
         {
@@ -309,7 +454,7 @@ export class Conversations extends 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
@@ -369,8 +514,8 @@ export class Conversations extends APIResource {
    * {
    *   "title": "Billing Issue - Priority",
    *   "customAttributes": {
-   *     "priority_level": "high",
-   *     "category": "billing"
+   *     "507f1f77bcf86cd799439011": 10,
+   *     "507f1f77bcf86cd799439012": true
    *   }
    * }
    * ```
@@ -433,83 +578,119 @@ export class Conversations extends 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
+   * ### Example Admin Reply
    *
-   * This endpoint is only available in API version 2026-01-01.nova and newer.
+   * ```json
+   * {
+   *   "type": "admin",
+   *   "id": "507f1f77bcf86cd799439011",
+   *   "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
+   *   "messageType": "reply"
+   * }
+   * ```
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const conversation of client.support.conversations.list()) {
-   *   // ...
+   * ### Example Admin Note (Internal)
+   *
+   * ```json
+   * {
+   *   "type": "admin",
+   *   "id": "507f1f77bcf86cd799439011",
+   *   "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
+   *   "messageType": "note"
    * }
    * ```
-   */
-  list(
-    params: ConversationListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ConversationsCursorPage, Conversation> {
-    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.getAPIList('/v2/conversations', CursorPage<Conversation>, {
-      query,
-      ...options,
+   *
+   * ### Example Response
+   *
+   * ```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"
+   * }
+   * ```
+   *
+   * ### Version Availability
+   *
+   * This endpoint is only available in API version 2026-01-01.nova and newer.
+   *
+   * @example
+   * ```ts
+   * const conversationPart =
+   *   await client.support.conversations.reply('12345', {
+   *     bodyMarkdown: 'Thank you for your help!',
+   *     messageType: 'reply',
+   *     type: 'contact',
+   *   });
+   * ```
+   */
+  reply(id: string, params: ConversationReplyParams, options?: RequestOptions): APIPromise<ConversationPart> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post(path`/v2/conversations/${id}/reply`, {
+      body,
+      ...options,
       headers: buildHeaders([
         {
           ...(featurebaseVersion?.toString() != null ?
@@ -522,28 +703,68 @@ export class Conversations extends APIResource {
   }
 
   /**
-   * Permanently deletes a conversation by its short ID.
+   * Redacts a conversation part (message) from a conversation. Redaction permanently
+   * removes the message content while preserving the conversation structure.
    *
-   * ### Path Parameters
+   * Only human message types can be redacted:
    *
-   * - `id` - The conversation short ID (numeric)
+   * - `user_msg` - Messages from customers/leads
+   * - `admin_msg` - Messages from admins
+   * - `email_msg` - Email messages
+   * - `bot_msg` - Bot messages
+   *
+   * System-generated conversation parts (assignments, status changes, etc.) cannot
+   * be redacted.
+   *
+   * ### Request Body
+   *
+   * | Field                | Type   | Required | Description                                                                    |
+   * | -------------------- | ------ | -------- | ------------------------------------------------------------------------------ |
+   * | `type`               | string | Yes      | The type of item to redact. Currently only `"conversation_part"` is supported. |
+   * | `conversationId`     | string | Yes      | The conversation short ID containing the part to redact                        |
+   * | `conversationPartId` | string | Yes      | The conversation part short ID to redact                                       |
+   * | `actingAdminId`      | string | No       | Admin ID performing the action (for attribution)                               |
    *
    * ### Response
    *
-   * Returns a deletion confirmation object:
+   * Returns the updated conversation object.
+   *
+   * ### Example Request
+   *
+   * ```json
+   * {
+   *   "type": "conversation_part",
+   *   "conversationId": "12345",
+   *   "conversationPartId": "67890",
+   *   "actingAdminId": "507f1f77bcf86cd799439011"
+   * }
+   * ```
+   *
+   * ### Example Response
    *
    * ```json
    * {
-   *   "id": "12345",
    *   "object": "conversation",
-   *   "deleted": true
+   *   "id": "12345",
+   *   "conversationParts": [
+   *     {
+   *       "object": "conversation_part",
+   *       "id": "67890",
+   *       "partType": "user_msg",
+   *       "bodyHtml": "",
+   *       "bodyMarkdown": "",
+   *       "redacted": true,
+   *       ...
+   *     }
+   *   ],
+   *   ...
    * }
    * ```
    *
-   * ### Caution
+   * ### Error Cases
    *
-   * This operation is **irreversible**. The conversation and all its messages will
-   * be permanently deleted.
+   * - **400 Bad Request** - Only human messages can be redacted
+   * - **404 Not Found** - Conversation or conversation part not found
    *
    * ### Version Availability
    *
@@ -552,16 +773,17 @@ export class Conversations extends APIResource {
    * @example
    * ```ts
    * const conversation =
-   *   await client.support.conversations.delete('12345');
+   *   await client.support.conversations.redact({
+   *     conversationId: '12345',
+   *     conversationPartId: '67890',
+   *     type: 'conversation_part',
+   *   });
    * ```
    */
-  delete(
-    id: string,
-    params: ConversationDeleteParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ConversationDeleteResponse> {
-    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-    return this._client.delete(path`/v2/conversations/${id}`, {
+  redact(params: ConversationRedactParams, options?: RequestOptions): APIPromise<Conversation> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/conversations/redact', {
+      body,
       ...options,
       headers: buildHeaders([
         {
@@ -617,7 +839,7 @@ export class Conversations extends APIResource {
    *
    * @example
    * ```ts
-   * const response =
+   * const attachedConversationTag =
    *   await client.support.conversations.attachTag('12345', {
    *     actingAdminId: '507f1f77bcf86cd799439011',
    *     tagId: '67ec1234abcd5678ef901234',
@@ -628,7 +850,7 @@ export class Conversations extends APIResource {
     id: string,
     params: ConversationAttachTagParams,
     options?: RequestOptions,
-  ): APIPromise<ConversationAttachTagResponse> {
+  ): APIPromise<AttachedConversationTag> {
     const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
     return this._client.post(path`/v2/conversations/${id}/tags`, {
       body,
@@ -686,7 +908,7 @@ export class Conversations extends APIResource {
    *
    * @example
    * ```ts
-   * const response =
+   * const attachedConversationTag =
    *   await client.support.conversations.detachTag(
    *     '67ec1234abcd5678ef901234',
    *     {
@@ -700,7 +922,7 @@ export class Conversations extends APIResource {
     tagID: string,
     params: ConversationDetachTagParams,
     options?: RequestOptions,
-  ): APIPromise<ConversationDetachTagResponse> {
+  ): APIPromise<AttachedConversationTag> {
     const { id, 'Featurebase-Version': featurebaseVersion, ...body } = params;
     return this._client.delete(path`/v2/conversations/${id}/tags/${tagID}`, {
       body,
@@ -716,225 +938,6 @@ export class Conversations extends APIResource {
     });
   }
 
-  /**
-   * Redacts a conversation part (message) from a conversation. Redaction permanently
-   * removes the message content while preserving the conversation structure.
-   *
-   * Only human message types can be redacted:
-   *
-   * - `user_msg` - Messages from customers/leads
-   * - `admin_msg` - Messages from admins
-   * - `email_msg` - Email messages
-   * - `bot_msg` - Bot messages
-   *
-   * System-generated conversation parts (assignments, status changes, etc.) cannot
-   * be redacted.
-   *
-   * ### Request Body
-   *
-   * | Field                | Type   | Required | Description                                                                    |
-   * | -------------------- | ------ | -------- | ------------------------------------------------------------------------------ |
-   * | `type`               | string | Yes      | The type of item to redact. Currently only `"conversation_part"` is supported. |
-   * | `conversationId`     | string | Yes      | The conversation short ID containing the part to redact                        |
-   * | `conversationPartId` | string | Yes      | The conversation part short ID to redact                                       |
-   * | `actingAdminId`      | string | No       | Admin ID performing the action (for attribution)                               |
-   *
-   * ### Response
-   *
-   * Returns the updated conversation object.
-   *
-   * ### Example Request
-   *
-   * ```json
-   * {
-   *   "type": "conversation_part",
-   *   "conversationId": "12345",
-   *   "conversationPartId": "67890",
-   *   "actingAdminId": "507f1f77bcf86cd799439011"
-   * }
-   * ```
-   *
-   * ### Example Response
-   *
-   * ```json
-   * {
-   *   "object": "conversation",
-   *   "id": "12345",
-   *   "conversationParts": [
-   *     {
-   *       "object": "conversation_part",
-   *       "id": "67890",
-   *       "partType": "user_msg",
-   *       "bodyHtml": "",
-   *       "bodyMarkdown": "",
-   *       "redacted": true,
-   *       ...
-   *     }
-   *   ],
-   *   ...
-   * }
-   * ```
-   *
-   * ### Error Cases
-   *
-   * - **400 Bad Request** - Only human messages can be redacted
-   * - **404 Not Found** - Conversation or conversation part not found
-   *
-   * ### Version Availability
-   *
-   * This endpoint is only available in API version 2026-01-01.nova and newer.
-   *
-   * @example
-   * ```ts
-   * const conversation =
-   *   await client.support.conversations.redact({
-   *     conversationId: '12345',
-   *     conversationPartId: '67890',
-   *     type: 'conversation_part',
-   *   });
-   * ```
-   */
-  redact(params: ConversationRedactParams, options?: RequestOptions): APIPromise<Conversation> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-    return this._client.post('/v2/conversations/redact', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
-  /**
-   * Adds a reply to an existing conversation. Supports both contact (customer/lead)
-   * and admin replies.
-   *
-   * ### Path Parameters
-   *
-   * - `id` - The conversation ID (short ID)
-   *
-   * ### 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.
-   *
-   * #### Admin Reply
-   *
-   * | 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
-   * {
-   *   "type": "contact",
-   *   "userId": "user_123",
-   *   "bodyMarkdown": "Thank you for your help!",
-   *   "messageType": "reply"
-   * }
-   * ```
-   *
-   * ### Example Admin Reply
-   *
-   * ```json
-   * {
-   *   "type": "admin",
-   *   "id": "507f1f77bcf86cd799439011",
-   *   "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
-   *   "messageType": "reply"
-   * }
-   * ```
-   *
-   * ### Example Admin Note (Internal)
-   *
-   * ```json
-   * {
-   *   "type": "admin",
-   *   "id": "507f1f77bcf86cd799439011",
-   *   "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
-   *   "messageType": "note"
-   * }
-   * ```
-   *
-   * ### Example Response
-   *
-   * ```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"
-   * }
-   * ```
-   *
-   * ### Version Availability
-   *
-   * This endpoint is only available in API version 2026-01-01.nova and newer.
-   *
-   * @example
-   * ```ts
-   * const conversationPart =
-   *   await client.support.conversations.reply('12345', {
-   *     bodyMarkdown: 'Thank you for your help!',
-   *     messageType: 'reply',
-   *     type: 'contact',
-   *   });
-   * ```
-   */
-  reply(id: string, params: ConversationReplyParams, options?: RequestOptions): APIPromise<ConversationPart> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-    return this._client.post(path`/v2/conversations/${id}/reply`, {
-      body,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Search conversations with a structured filter AST and an optional full-text
    * query.
@@ -1059,6 +1062,49 @@ export class Conversations extends APIResource {
 
 export type ConversationsCursorPage = CursorPage<Conversation>;
 
+export interface AttachedConversationTag {
+  /**
+   * Unique tag identifier
+   */
+  id: string;
+
+  /**
+   * Current tag name
+   */
+  name: string;
+
+  /**
+   * Object type identifier for a tag
+   */
+  type: 'tag';
+
+  /**
+   * ISO timestamp when the tag was applied
+   */
+  appliedAt?: string | null;
+
+  /**
+   * Actor that applied the tag
+   */
+  appliedBy?: ConversationTagMutationActor | null;
+
+  /**
+   * ISO timestamp when the tag was removed, if applicable
+   */
+  removedAt?: string | null;
+
+  /**
+   * Actor that applied the tag
+   */
+  removedBy?: ConversationTagMutationActor | null;
+
+  /**
+   * Reply/message ID used as the deterministic attachment target for this
+   * conversation tag mutation.
+   */
+  targetPartId?: string | null;
+}
+
 export interface Conversation {
   /**
    * Unique conversation identifier
@@ -1188,6 +1234,19 @@ export interface Conversation {
    */
   csatSummary?: Conversation.CsatSummary;
 
+  /**
+   * Custom conversation attributes keyed by custom attribute ID. Only org-defined,
+   * non-archived conversation attributes are returned; internal workflow metadata is
+   * omitted.
+   */
+  customAttributes?: { [key: string]: unknown };
+
+  /**
+   * Custom conversation attribute values expanded with definition metadata. Returned
+   * only when `include=customAttributeDefinitions` is provided.
+   */
+  customAttributeValues?: Array<ConversationAttributeValue>;
+
   /**
    * Whether customer replies are disabled
    */
@@ -1203,7 +1262,7 @@ export interface Conversation {
    */
   readReceipts?: Array<Conversation.ReadReceipt>;
 
-  source?: Conversation.Source;
+  source?: MessageSource;
 
   /**
    * Conversation title
@@ -1237,13 +1296,16 @@ export namespace Conversation {
      * ISO timestamp when first-time submissions stop being accepted
      */
     lateSubmitWindowEndsAt?: string;
+
+    slackDelivery?: ConversationsAPI.CsatSlackDelivery;
   }
 
   export interface CsatHistory {
     /**
-     * Channel used for the CSAT request
+     * Channel used for the CSAT request. `desktop` = web messenger, `email` =
+     * follow-up email, `slack` = Block Kit prompt in the conversation thread.
      */
-    channel: 'desktop' | 'email';
+    channel: 'desktop' | 'email' | 'slack';
 
     /**
      * Whether this row represents the currently effective CSAT request for the
@@ -1315,6 +1377,8 @@ export namespace Conversation {
      */
     score?: number;
 
+    slackDelivery?: ConversationsAPI.CsatSlackDelivery;
+
     workflow?: ConversationsAPI.CsatWorkflowLink;
   }
 
@@ -1341,7 +1405,7 @@ export namespace Conversation {
     /**
      * Channel used for the latest CSAT request when known
      */
-    channel?: 'desktop' | 'email';
+    channel?: 'desktop' | 'email' | 'slack';
 
     /**
      * ISO timestamp when the request expired
@@ -1402,40 +1466,43 @@ export namespace Conversation {
      */
     userType: 'admin' | 'customer' | 'lead';
   }
+}
 
-  export interface Source {
-    /**
-     * Body of the initial message as HTML with signed image URLs
-     */
-    bodyHtml: string;
+export interface ConversationAttributeValue {
+  /**
+   * Stable machine identifier used as the key in conversation.customAttributes.
+   */
+  id: string;
 
-    /**
-     * Body of the initial message as markdown
-     */
-    bodyMarkdown: string;
+  /**
+   * Storage-level data type used for validation and search.
+   */
+  dataType: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object';
 
-    /**
-     * Channel through which the conversation was initiated
-     */
-    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email';
+  /**
+   * Conversation field subtype that controls the expected value shape.
+   */
+  fieldSubType: 'text' | 'number' | 'select' | 'multi-select' | 'checkbox' | 'date';
 
-    author?: ConversationsAPI.ConversationParticipant;
+  /**
+   * Stable internal identifier for the attribute definition.
+   */
+  identifier: string;
 
-    /**
-     * How the conversation was initiated
-     */
-    deliveredAs?: 'customer_initiated' | 'admin_initiated';
+  /**
+   * Human-readable attribute name shown in Featurebase.
+   */
+  name: string;
 
-    /**
-     * Subject line for email conversations
-     */
-    subject?: string;
+  /**
+   * Allowed values for select and multi-select attributes.
+   */
+  options?: Array<ConversationAttributesAPI.ConversationAttributeOption>;
 
-    /**
-     * URL where the conversation was initiated
-     */
-    url?: string;
-  }
+  /**
+   * The conversation-specific custom attribute value.
+   */
+  value?: unknown;
 }
 
 /**
@@ -1483,7 +1550,7 @@ export namespace ConversationPart {
     /**
      * Channel through which the message was sent
      */
-    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email';
+    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email' | 'slack';
 
     /**
      * ISO timestamp when the part was created
@@ -1512,6 +1579,12 @@ export namespace ConversationPart {
      */
     redacted?: boolean;
 
+    /**
+     * Safe Slack message identifiers. Only present for Slack-backed messages while the
+     * organization has Slack integration enabled.
+     */
+    slack?: ConversationsAPI.SlackMessageDetails;
+
     /**
      * Reply-level tag applications and provenance for this conversation part
      */
@@ -1540,7 +1613,7 @@ export namespace ConversationPart {
     /**
      * Channel through which the message was sent
      */
-    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email';
+    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email' | 'slack';
 
     /**
      * ISO timestamp when the part was created
@@ -1569,6 +1642,12 @@ export namespace ConversationPart {
      */
     redacted?: boolean;
 
+    /**
+     * Safe Slack message identifiers. Only present for Slack-backed messages while the
+     * organization has Slack integration enabled.
+     */
+    slack?: ConversationsAPI.SlackMessageDetails;
+
     /**
      * Reply-level tag applications and provenance for this conversation part
      */
@@ -1728,13 +1807,19 @@ export namespace ConversationPart {
     /**
      * Channel through which the message was sent
      */
-    channel?: 'unknown' | 'desktop' | 'android' | 'ios' | 'email';
+    channel?: 'unknown' | 'desktop' | 'android' | 'ios' | 'email' | 'slack';
 
     /**
      * Whether this message has been redacted
      */
     redacted?: boolean;
 
+    /**
+     * Safe Slack message identifiers. Only present for Slack-backed messages while the
+     * organization has Slack integration enabled.
+     */
+    slack?: ConversationsAPI.SlackMessageDetails;
+
     /**
      * Reply-level tag applications and provenance for this conversation part
      */
@@ -1900,9 +1985,10 @@ export namespace ConversationPart {
      */
     export interface Csat {
       /**
-       * Channel used for the CSAT request
+       * Channel used for the CSAT request. `desktop` = web messenger, `email` =
+       * follow-up email, `slack` = Block Kit prompt in the conversation thread.
        */
-      channel: 'desktop' | 'email';
+      channel: 'desktop' | 'email' | 'slack';
 
       /**
        * ISO timestamp when the request was created
@@ -1986,9 +2072,10 @@ export namespace ConversationPart {
      */
     export interface Csat {
       /**
-       * Channel used for the CSAT request
+       * Channel used for the CSAT request. `desktop` = web messenger, `email` =
+       * follow-up email, `slack` = Block Kit prompt in the conversation thread.
        */
-      channel: 'desktop' | 'email';
+      channel: 'desktop' | 'email' | 'slack';
 
       /**
        * ISO timestamp when the customer submitted the rating
@@ -2276,39 +2363,17 @@ export namespace ConversationPart {
     /**
      * Actor that applied the tag
      */
-    actor?: TagUpdate.Actor;
+    actor?: ConversationsAPI.ConversationTagMutationActor;
 
-    /**
-     * Tag name at the time of the event or the best available current display name
-     */
-    tagName?: string | null;
-
-    /**
-     * Conversation part that the tag mutation targeted
-     */
-    targetPartId?: string | null;
-  }
-
-  export namespace TagUpdate {
-    /**
-     * Actor that applied the tag
-     */
-    export interface Actor {
-      /**
-       * Actor that caused the tag mutation
-       */
-      type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-      /**
-       * Actor identifier when available
-       */
-      id?: string | null;
+    /**
+     * Tag name at the time of the event or the best available current display name
+     */
+    tagName?: string | null;
 
-      /**
-       * Actor display name when available
-       */
-      name?: string | null;
-    }
+    /**
+     * Conversation part that the tag mutation targeted
+     */
+    targetPartId?: string | null;
   }
 
   /**
@@ -2525,7 +2590,7 @@ export interface ConversationTagApplication {
   /**
    * Actor that applied the tag
    */
-  appliedBy?: ConversationTagApplication.AppliedBy;
+  appliedBy?: ConversationTagMutationActor;
 
   /**
    * ISO timestamp when the tag was removed from this reply, if it was removed
@@ -2535,7 +2600,7 @@ export interface ConversationTagApplication {
   /**
    * Actor that applied the tag
    */
-  removedBy?: ConversationTagApplication.RemovedBy;
+  removedBy?: ConversationTagMutationActor;
 
   /**
    * Resolved tag object when the tag still exists in the shared workspace catalog
@@ -2543,46 +2608,24 @@ export interface ConversationTagApplication {
   tag?: ConversationTagsAPI.ConversationTag;
 }
 
-export namespace ConversationTagApplication {
+/**
+ * Actor that applied the tag
+ */
+export interface ConversationTagMutationActor {
   /**
-   * Actor that applied the tag
+   * Actor that caused the tag mutation
    */
-  export interface AppliedBy {
-    /**
-     * Actor that caused the tag mutation
-     */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-    /**
-     * Actor identifier when available
-     */
-    id?: string | null;
-
-    /**
-     * Actor display name when available
-     */
-    name?: string | null;
-  }
+  type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
 
   /**
-   * Actor that applied the tag
+   * Actor identifier when available
    */
-  export interface RemovedBy {
-    /**
-     * Actor that caused the tag mutation
-     */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-    /**
-     * Actor identifier when available
-     */
-    id?: string | null;
+  id?: string | null;
 
-    /**
-     * Actor display name when available
-     */
-    name?: string | null;
-  }
+  /**
+   * Actor display name when available
+   */
+  name?: string | null;
 }
 
 export interface CsatEmailDelivery {
@@ -2624,6 +2667,44 @@ export interface CsatRatedAgent {
   id?: string;
 }
 
+export interface CsatSlackDelivery {
+  /**
+   * Slack Block Kit prompt delivery status for the CSAT request when the channel is
+   * Slack
+   */
+  status: 'pending' | 'posted' | 'failed';
+
+  /**
+   * Slack channel id the CSAT prompt was posted to
+   */
+  channelId?: string;
+
+  /**
+   * ISO timestamp when posting the CSAT prompt to Slack failed
+   */
+  failedAt?: string;
+
+  /**
+   * Operational failure reason for the Slack CSAT prompt delivery
+   */
+  failureReason?: string;
+
+  /**
+   * Slack message timestamp of the posted CSAT prompt
+   */
+  messageTs?: string;
+
+  /**
+   * ISO timestamp when the CSAT prompt was enqueued for Slack
+   */
+  postedAt?: string;
+
+  /**
+   * Slack workspace (team) the CSAT prompt was posted to
+   */
+  teamId?: string;
+}
+
 export interface CsatWorkflowLink {
   /**
    * Workflow action ID associated with the CSAT request
@@ -2661,191 +2742,160 @@ export interface EmailRecipients {
   ids?: Array<string>;
 }
 
-export interface ConversationDeleteResponse {
-  /**
-   * Unique identifier of the deleted conversation
-   */
-  id: string;
-
-  /**
-   * Indicates the resource was deleted
-   */
-  deleted: true;
-
-  /**
-   * Object type identifier
-   */
-  object: 'conversation';
-}
-
-export interface ConversationAttachTagResponse {
+export interface MessageSource {
   /**
-   * Unique tag identifier
+   * Body of the initial message as HTML with signed image URLs
    */
-  id: string;
+  bodyHtml: string;
 
   /**
-   * Current tag name
+   * Body of the initial message as markdown
    */
-  name: string;
+  bodyMarkdown: string;
 
   /**
-   * Object type identifier for a tag
+   * Channel through which the conversation was initiated
    */
-  type: 'tag';
+  channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email' | 'slack';
 
-  /**
-   * ISO timestamp when the tag was applied
-   */
-  appliedAt?: string | null;
+  author?: ConversationParticipant;
 
   /**
-   * Actor that applied the tag
+   * How the conversation was initiated
    */
-  appliedBy?: ConversationAttachTagResponse.AppliedBy | null;
+  deliveredAs?: 'customer_initiated' | 'admin_initiated';
 
   /**
-   * ISO timestamp when the tag was removed, if applicable
+   * Safe Slack thread identifiers. Only present for Slack-origin conversations while
+   * the organization has Slack integration enabled.
    */
-  removedAt?: string | null;
+  slack?: MessageSource.Slack;
 
   /**
-   * Actor that applied the tag
+   * Subject line for email conversations
    */
-  removedBy?: ConversationAttachTagResponse.RemovedBy | null;
+  subject?: string;
 
   /**
-   * Reply/message ID used as the deterministic attachment target for this
-   * conversation tag mutation.
+   * URL where the conversation was initiated
    */
-  targetPartId?: string | null;
+  url?: string;
 }
 
-export namespace ConversationAttachTagResponse {
+export namespace MessageSource {
   /**
-   * Actor that applied the tag
+   * Safe Slack thread identifiers. Only present for Slack-origin conversations while
+   * the organization has Slack integration enabled.
    */
-  export interface AppliedBy {
+  export interface Slack {
     /**
-     * Actor that caused the tag mutation
+     * Slack channel ID for the thread
      */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
+    channelId: string;
 
     /**
-     * Actor identifier when available
+     * Slack workspace/team ID for the thread
      */
-    id?: string | null;
+    teamId: string;
 
     /**
-     * Actor display name when available
+     * Slack root thread timestamp
      */
-    name?: string | null;
+    threadTs: string;
   }
+}
 
+/**
+ * The customer or lead the conversation is with. Use this for the row identity;
+ * use `matchingPartAuthor` if you specifically want the message author.
+ */
+export interface SearchMatchingPartAuthor {
   /**
-   * Actor that applied the tag
+   * Author id
    */
-  export interface RemovedBy {
-    /**
-     * Actor that caused the tag mutation
-     */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-    /**
-     * Actor identifier when available
-     */
-    id?: string | null;
+  id: string;
 
-    /**
-     * Actor display name when available
-     */
-    name?: string | null;
-  }
-}
+  /**
+   * Author type
+   */
+  type: 'admin' | 'customer' | 'lead' | 'bot' | 'guest' | 'integration';
 
-export interface ConversationDetachTagResponse {
   /**
-   * Unique tag identifier
+   * Companies the author belongs to (customers only)
    */
-  id: string;
+  companies?: Array<SearchMatchingPartAuthor.Company>;
 
   /**
-   * Current tag name
+   * Email when known
    */
-  name: string;
+  email?: string | null;
 
   /**
-   * Object type identifier for a tag
+   * Display name when known
    */
-  type: 'tag';
+  name?: string | null;
 
   /**
-   * ISO timestamp when the tag was applied
+   * Profile picture URL when known
    */
-  appliedAt?: string | null;
+  profilePicture?: string | null;
+}
+
+export namespace SearchMatchingPartAuthor {
+  export interface Company {
+    /**
+     * Company id
+     */
+    id: string;
+
+    /**
+     * Company name
+     */
+    name?: string;
+  }
+}
 
+/**
+ * Safe Slack message identifiers. Only present for Slack-backed messages while the
+ * organization has Slack integration enabled.
+ */
+export interface SlackMessageDetails {
   /**
-   * Actor that applied the tag
+   * Slack channel ID for the message
    */
-  appliedBy?: ConversationDetachTagResponse.AppliedBy | null;
+  channelId: string;
 
   /**
-   * ISO timestamp when the tag was removed, if applicable
+   * Slack message timestamp
    */
-  removedAt?: string | null;
+  messageTs: string;
 
   /**
-   * Actor that applied the tag
+   * Slack workspace/team ID for the message
    */
-  removedBy?: ConversationDetachTagResponse.RemovedBy | null;
+  teamId: string;
 
   /**
-   * Reply/message ID used as the deterministic attachment target for this
-   * conversation tag mutation.
+   * Slack root thread timestamp when this message belongs to a thread
    */
-  targetPartId?: string | null;
+  threadTs?: string;
 }
 
-export namespace ConversationDetachTagResponse {
+export interface ConversationDeleteResponse {
   /**
-   * Actor that applied the tag
+   * Unique identifier of the deleted conversation
    */
-  export interface AppliedBy {
-    /**
-     * Actor that caused the tag mutation
-     */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-    /**
-     * Actor identifier when available
-     */
-    id?: string | null;
-
-    /**
-     * Actor display name when available
-     */
-    name?: string | null;
-  }
+  id: string;
 
   /**
-   * Actor that applied the tag
+   * Indicates the resource was deleted
    */
-  export interface RemovedBy {
-    /**
-     * Actor that caused the tag mutation
-     */
-    type: 'admin' | 'customer' | 'lead' | 'bot' | 'integration' | 'system' | 'workflow';
-
-    /**
-     * Actor identifier when available
-     */
-    id?: string | null;
+  deleted: true;
 
-    /**
-     * Actor display name when available
-     */
-    name?: string | null;
-  }
+  /**
+   * Object type identifier
+   */
+  object: 'conversation';
 }
 
 export interface ConversationSearchResponse {
@@ -2954,7 +3004,20 @@ export namespace ConversationSearchResponse {
      * The customer or lead the conversation is with. Use this for the row identity;
      * use `matchingPartAuthor` if you specifically want the message author.
      */
-    conversationUser?: Data.ConversationUser | null;
+    conversationUser?: ConversationsAPI.SearchMatchingPartAuthor | null;
+
+    /**
+     * Custom conversation attributes keyed by custom attribute ID. Only org-defined,
+     * non-archived conversation attributes are returned; internal workflow metadata is
+     * omitted.
+     */
+    customAttributes?: { [key: string]: unknown };
+
+    /**
+     * Custom conversation attribute values expanded with definition metadata. Returned
+     * only when `include=customAttributeDefinitions` is provided.
+     */
+    customAttributeValues?: Array<ConversationsAPI.ConversationAttributeValue>;
 
     /**
      * Plain-text / markdown preview of the matching conversation part body (search
@@ -2972,7 +3035,7 @@ export namespace ConversationSearchResponse {
      * The customer or lead the conversation is with. Use this for the row identity;
      * use `matchingPartAuthor` if you specifically want the message author.
      */
-    matchingPartAuthor?: Data.MatchingPartAuthor | null;
+    matchingPartAuthor?: ConversationsAPI.SearchMatchingPartAuthor | null;
 
     /**
      * Aggregate relevance score for the conversation (search mode only). Higher is
@@ -2980,7 +3043,7 @@ export namespace ConversationSearchResponse {
      */
     relevanceScore?: number | null;
 
-    source?: Data.Source;
+    source?: ConversationsAPI.MessageSource;
 
     /**
      * Window of conversation messages around the matching part for lightweight context
@@ -2999,147 +3062,25 @@ export namespace ConversationSearchResponse {
   }
 
   export namespace Data {
-    /**
-     * The customer or lead the conversation is with. Use this for the row identity;
-     * use `matchingPartAuthor` if you specifically want the message author.
-     */
-    export interface ConversationUser {
-      /**
-       * Author id
-       */
-      id: string;
-
-      /**
-       * Author type
-       */
-      type: 'admin' | 'customer' | 'lead' | 'bot' | 'guest' | 'integration';
-
-      /**
-       * Companies the author belongs to (customers only)
-       */
-      companies?: Array<ConversationUser.Company>;
-
-      /**
-       * Email when known
-       */
-      email?: string | null;
-
-      /**
-       * Display name when known
-       */
-      name?: string | null;
-
-      /**
-       * Profile picture URL when known
-       */
-      profilePicture?: string | null;
-    }
-
-    export namespace ConversationUser {
-      export interface Company {
-        id: string;
-
-        name?: string;
-      }
-    }
-
     /**
      * Reference to the conversation part that best matched the search query (search
      * mode only)
      */
-    export interface MatchingPart {
-      /**
-       * Conversation part id
-       */
-      id: string;
-
-      /**
-       * ISO timestamp when the matching part was created
-       */
-      createdAt?: string | null;
-
-      /**
-       * Conversation part type
-       */
-      partType?: string;
-    }
-
-    /**
-     * The customer or lead the conversation is with. Use this for the row identity;
-     * use `matchingPartAuthor` if you specifically want the message author.
-     */
-    export interface MatchingPartAuthor {
-      /**
-       * Author id
-       */
-      id: string;
-
-      /**
-       * Author type
-       */
-      type: 'admin' | 'customer' | 'lead' | 'bot' | 'guest' | 'integration';
-
-      /**
-       * Companies the author belongs to (customers only)
-       */
-      companies?: Array<MatchingPartAuthor.Company>;
-
-      /**
-       * Email when known
-       */
-      email?: string | null;
-
-      /**
-       * Display name when known
-       */
-      name?: string | null;
-
-      /**
-       * Profile picture URL when known
-       */
-      profilePicture?: string | null;
-    }
-
-    export namespace MatchingPartAuthor {
-      export interface Company {
-        id: string;
-
-        name?: string;
-      }
-    }
-
-    export interface Source {
-      /**
-       * Body of the initial message as HTML with signed image URLs
-       */
-      bodyHtml: string;
-
-      /**
-       * Body of the initial message as markdown
-       */
-      bodyMarkdown: string;
-
-      /**
-       * Channel through which the conversation was initiated
-       */
-      channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email';
-
-      author?: ConversationsAPI.ConversationParticipant;
-
+    export interface MatchingPart {
       /**
-       * How the conversation was initiated
+       * Conversation part id
        */
-      deliveredAs?: 'customer_initiated' | 'admin_initiated';
+      id: string;
 
       /**
-       * Subject line for email conversations
+       * ISO timestamp when the matching part was created
        */
-      subject?: string;
+      createdAt?: string | null;
 
       /**
-       * URL where the conversation was initiated
+       * Conversation part type
        */
-      url?: string;
+      partType?: string;
     }
 
     export interface SurroundingConversationPart {
@@ -3162,7 +3103,7 @@ export namespace ConversationSearchResponse {
        * The customer or lead the conversation is with. Use this for the row identity;
        * use `matchingPartAuthor` if you specifically want the message author.
        */
-      author?: SurroundingConversationPart.Author | null;
+      author?: ConversationsAPI.SearchMatchingPartAuthor | null;
 
       /**
        * ISO timestamp when the part was created
@@ -3174,53 +3115,28 @@ export namespace ConversationSearchResponse {
        */
       partType?: string;
     }
+  }
+}
 
-    export namespace SurroundingConversationPart {
-      /**
-       * The customer or lead the conversation is with. Use this for the row identity;
-       * use `matchingPartAuthor` if you specifically want the message author.
-       */
-      export interface Author {
-        /**
-         * Author id
-         */
-        id: string;
-
-        /**
-         * Author type
-         */
-        type: 'admin' | 'customer' | 'lead' | 'bot' | 'guest' | 'integration';
-
-        /**
-         * Companies the author belongs to (customers only)
-         */
-        companies?: Array<Author.Company>;
-
-        /**
-         * Email when known
-         */
-        email?: string | null;
-
-        /**
-         * Display name when known
-         */
-        name?: string | null;
-
-        /**
-         * Profile picture URL when known
-         */
-        profilePicture?: string | null;
-      }
+export interface ConversationListParams extends CursorPageParams {
+  /**
+   * Query param: Comma-separated optional expansions. Use
+   * `customAttributeDefinitions` to return `customAttributeValues` with names and
+   * types alongside ID-keyed `customAttributes`.
+   */
+  include?: string | Array<string>;
 
-      export namespace Author {
-        export interface Company {
-          id: string;
+  /**
+   * Query param: Filter conversations by one or more tag IDs using a comma-separated
+   * list. Conversations must contain all provided tags.
+   */
+  tagIds?: string | Array<string>;
 
-          name?: string;
-        }
-      }
-    }
-  }
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface ConversationCreateParams {
@@ -3323,6 +3239,21 @@ export namespace ConversationCreateParams {
 }
 
 export interface ConversationRetrieveParams {
+  /**
+   * Query param: Comma-separated optional expansions. Use
+   * `customAttributeDefinitions` to return `customAttributeValues` with names and
+   * types alongside ID-keyed `customAttributes`.
+   */
+  include?: string | Array<string>;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface ConversationDeleteParams {
   /**
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
@@ -3344,8 +3275,9 @@ export interface ConversationUpdateParams {
   adminAssigneeId?: string | null;
 
   /**
-   * Body param: Custom attributes to set on the conversation. Uses the same
-   * validation as v1 API.
+   * Body param: Custom attributes to set on the conversation, keyed by conversation
+   * custom attribute ID. Use the custom attribute definitions for your organization
+   * to map IDs to display names.
    */
   customAttributes?: { [key: string]: unknown };
 
@@ -3413,96 +3345,6 @@ export namespace ConversationUpdateParams {
   }
 }
 
-export interface ConversationListParams extends CursorPageParams {
-  /**
-   * Query param: Filter conversations by one or more tag IDs using a comma-separated
-   * list. Conversations must contain all provided tags.
-   */
-  tagIds?: string | Array<string>;
-
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
-export interface ConversationDeleteParams {
-  /**
-   * API version for this request. Defaults to your organization's configured API
-   * version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
-export interface ConversationAttachTagParams {
-  /**
-   * Body param: Required admin ID performing this tag attachment. Must be a member
-   * of the organization so the mutation can be attributed to a real admin actor.
-   */
-  actingAdminId: string;
-
-  /**
-   * Body param: The Featurebase tag ID to attach to the conversation.
-   */
-  tagId: string;
-
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
-export interface ConversationDetachTagParams {
-  /**
-   * Path param: Conversation ID (short ID)
-   */
-  id: string;
-
-  /**
-   * Body param: Required admin ID performing this tag removal. Must be a member of
-   * the organization so the mutation can be attributed to a real admin actor.
-   */
-  actingAdminId: string;
-
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
-export interface ConversationRedactParams {
-  /**
-   * Body param: The conversation short ID that contains the part to redact
-   */
-  conversationId: string;
-
-  /**
-   * Body param: The conversation part short ID to redact
-   */
-  conversationPartId: string;
-
-  /**
-   * Body param: The type of item to redact. Currently only "conversation_part" is
-   * supported.
-   */
-  type: 'conversation_part';
-
-  /**
-   * Body param: The admin ID performing this action. If not provided, changes are
-   * attributed to the system bot user.
-   */
-  actingAdminId?: string;
-
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
 export type ConversationReplyParams =
   | ConversationReplyParams.ContactReplyBody
   | ConversationReplyParams.AdminReplyBody;
@@ -3587,6 +3429,74 @@ export declare namespace ConversationReplyParams {
   }
 }
 
+export interface ConversationRedactParams {
+  /**
+   * Body param: The conversation short ID that contains the part to redact
+   */
+  conversationId: string;
+
+  /**
+   * Body param: The conversation part short ID to redact
+   */
+  conversationPartId: string;
+
+  /**
+   * Body param: The type of item to redact. Currently only "conversation_part" is
+   * supported.
+   */
+  type: 'conversation_part';
+
+  /**
+   * Body param: The admin ID performing this action. If not provided, changes are
+   * attributed to the system bot user.
+   */
+  actingAdminId?: string;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface ConversationAttachTagParams {
+  /**
+   * Body param: Required admin ID performing this tag attachment. Must be a member
+   * of the organization so the mutation can be attributed to a real admin actor.
+   */
+  actingAdminId: string;
+
+  /**
+   * Body param: The Featurebase tag ID to attach to the conversation.
+   */
+  tagId: string;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface ConversationDetachTagParams {
+  /**
+   * Path param: Conversation ID (short ID)
+   */
+  id: string;
+
+  /**
+   * Body param: Required admin ID performing this tag removal. Must be a member of
+   * the organization so the mutation can be attributed to a real admin actor.
+   */
+  actingAdminId: string;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
+}
+
 export interface ConversationSearchParams {
   /**
    * Body param: An opaque cursor for pagination. Use the nextCursor value from a
@@ -3594,6 +3504,13 @@ export interface ConversationSearchParams {
    */
   cursor?: string;
 
+  /**
+   * Body param: Optional expansions. Use `customAttributeDefinitions` to return
+   * `customAttributeValues` with names and types alongside ID-keyed
+   * `customAttributes`.
+   */
+  include?: Array<'customAttributeDefinitions'>;
+
   /**
    * Body param: A limit on the number of objects to be returned, between 1 and 100.
    */
@@ -3602,10 +3519,11 @@ export interface ConversationSearchParams {
   /**
    * Body param: Structured filter AST. Either a single filter clause or one
    * top-level AND group. Use this for filtering by `state`, `tagIds`,
-   * `adminAssigneeId`, etc. (Legacy snake_case names are accepted for back-compat —
-   * see the OpenAPI route description for the full alias map.)
+   * `adminAssigneeId`, `customAttributes.<attributeId>`, etc. (Legacy snake_case
+   * names are accepted for back-compat — see the OpenAPI route description for the
+   * full alias map.)
    */
-  query?: ConversationSearchParams.SearchFilter | ConversationSearchParams.SearchFilterGroup;
+  query?: PostsAPI.SearchFilter | PostsAPI.SearchFilterGroup;
 
   /**
    * Body param: Plain-text full-text search across conversation messages.
@@ -3629,83 +3547,38 @@ export interface ConversationSearchParams {
   'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export namespace ConversationSearchParams {
-  export interface SearchFilter {
-    /**
-     * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-     */
-    field: string;
-
-    /**
-     * Comparison operator
-     */
-    operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-
-    /**
-     * Value to compare against (primitive or array of primitives)
-     */
-    value: string | number | boolean | Array<string | number> | null;
-  }
-
-  export interface SearchFilterGroup {
-    /**
-     * Group operator: AND (all match) or OR (any match)
-     */
-    operator: 'AND' | 'OR';
-
-    /**
-     * Array of filter clauses (1-15 entries)
-     */
-    value: Array<SearchFilterGroup.Value>;
-  }
-
-  export namespace SearchFilterGroup {
-    export interface Value {
-      /**
-       * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-       */
-      field: string;
-
-      /**
-       * Comparison operator
-       */
-      operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-
-      /**
-       * Value to compare against (primitive or array of primitives)
-       */
-      value: string | number | boolean | Array<string | number> | null;
-    }
-  }
-}
-
 Conversations.Participants = Participants;
 
 export declare namespace Conversations {
   export {
+    type AttachedConversationTag as AttachedConversationTag,
     type Conversation as Conversation,
+    type ConversationAttributeValue as ConversationAttributeValue,
     type ConversationPart as ConversationPart,
     type ConversationPartAuthor as ConversationPartAuthor,
     type ConversationParticipant as ConversationParticipant,
     type ConversationTagApplication as ConversationTagApplication,
+    type ConversationTagMutationActor as ConversationTagMutationActor,
     type CsatEmailDelivery as CsatEmailDelivery,
     type CsatRatedAgent as CsatRatedAgent,
+    type CsatSlackDelivery as CsatSlackDelivery,
     type CsatWorkflowLink as CsatWorkflowLink,
     type EmailRecipients as EmailRecipients,
+    type MessageSource as MessageSource,
+    type SearchMatchingPartAuthor as SearchMatchingPartAuthor,
+    type SlackMessageDetails as SlackMessageDetails,
     type ConversationDeleteResponse as ConversationDeleteResponse,
-    type ConversationAttachTagResponse as ConversationAttachTagResponse,
-    type ConversationDetachTagResponse as ConversationDetachTagResponse,
     type ConversationSearchResponse as ConversationSearchResponse,
     type ConversationsCursorPage as ConversationsCursorPage,
+    type ConversationListParams as ConversationListParams,
     type ConversationCreateParams as ConversationCreateParams,
     type ConversationRetrieveParams as ConversationRetrieveParams,
-    type ConversationUpdateParams as ConversationUpdateParams,
-    type ConversationListParams as ConversationListParams,
     type ConversationDeleteParams as ConversationDeleteParams,
+    type ConversationUpdateParams as ConversationUpdateParams,
+    type ConversationReplyParams as ConversationReplyParams,
+    type ConversationRedactParams as ConversationRedactParams,
     type ConversationAttachTagParams as ConversationAttachTagParams,
     type ConversationDetachTagParams as ConversationDetachTagParams,
-    type ConversationRedactParams as ConversationRedactParams,
-    type ConversationReplyParams as ConversationReplyParams,
     type ConversationSearchParams as ConversationSearchParams,
   };