featurebase-node 0.12.0 → 0.14.0

package/resources/support/conversations/conversations.d.mts

@@ -1,6 +1,8 @@
 import { APIResource } from "../../../core/resource.mjs";
 import * as ConversationsAPI from "./conversations.mjs";
+import * as ConversationAttributesAPI from "../../conversation-attributes.mjs";
 import * as ConversationTagsAPI from "../conversation-tags.mjs";
+import * as PostsAPI from "../../feedback/posts/posts.mjs";
 import * as ParticipantsAPI from "./participants.mjs";
 import { ParticipantAddParams, ParticipantRemoveParams, Participants } from "./participants.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
@@ -11,6 +13,77 @@ import { RequestOptions } from "../../../internal/request-options.mjs";
  */
 export declare class Conversations extends APIResource {
     participants: ParticipantsAPI.Participants;
+    /**
+     * 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>;
     /**
      * Creates a new conversation. Supports both contact-initiated (customer/lead) and
      * admin-initiated (outreach) conversations.
@@ -250,6 +323,41 @@ export declare class Conversations extends APIResource {
      * ```
      */
     retrieve(id: string, params?: ConversationRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<Conversation>;
+    /**
+     * 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>;
     /**
      * Updates a conversation's properties. Supports partial updates - only provided
      * fields will be updated.
@@ -270,7 +378,7 @@ export declare 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
@@ -330,8 +438,8 @@ export declare class Conversations extends APIResource {
      * {
      *   "title": "Billing Issue - Priority",
      *   "customAttributes": {
-     *     "priority_level": "high",
-     *     "category": "billing"
+     *     "507f1f77bcf86cd799439011": 10,
+     *     "507f1f77bcf86cd799439012": true
      *   }
      * }
      * ```
@@ -379,195 +487,97 @@ export declare class Conversations extends APIResource {
      */
     update(id: string, params: ConversationUpdateParams, options?: RequestOptions): APIPromise<Conversation>;
     /**
-     * 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.                                                              |
      *
-     * ```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="
-     * }
-     * ```
+     * ### Response
      *
-     * ### Version Availability
+     * Returns the created conversation part object with a **201 Created** status. The
+     * response includes both `bodyHtml` (with signed image URLs) and `bodyMarkdown`
+     * fields.
      *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     * ### Example Contact Reply
      *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const conversation of client.support.conversations.list()) {
-     *   // ...
+     * ```json
+     * {
+     *   "type": "contact",
+     *   "userId": "user_123",
+     *   "bodyMarkdown": "Thank you for your help!",
+     *   "messageType": "reply"
      * }
      * ```
-     */
-    list(params?: ConversationListParams | null | undefined, options?: RequestOptions): PagePromise<ConversationsCursorPage, Conversation>;
-    /**
-     * Permanently deletes a conversation by its short ID.
-     *
-     * ### Path Parameters
-     *
-     * - `id` - The conversation short ID (numeric)
      *
-     * ### Response
-     *
-     * Returns a deletion confirmation object:
+     * ### Example Admin Reply
      *
      * ```json
      * {
-     *   "id": "12345",
-     *   "object": "conversation",
-     *   "deleted": true
+     *   "type": "admin",
+     *   "id": "507f1f77bcf86cd799439011",
+     *   "bodyMarkdown": "I'm happy to help! Here's what you need to do...",
+     *   "messageType": "reply"
      * }
      * ```
      *
-     * ### 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>;
-    /**
-     * 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 Admin Note (Internal)
      *
      * ```json
      * {
-     *   "tagId": "67ec1234abcd5678ef901234",
-     *   "actingAdminId": "507f1f77bcf86cd799439011"
+     *   "type": "admin",
+     *   "id": "507f1f77bcf86cd799439011",
+     *   "bodyMarkdown": "Customer seems frustrated, escalating to tier 2.",
+     *   "messageType": "note"
      * }
      * ```
      *
-     * ### Version Availability
-     *
-     * This endpoint is only available in API version 2026-01-01.nova and newer.
-     *
-     * @example
-     * ```ts
-     * const response =
-     *   await client.support.conversations.attachTag('12345', {
-     *     actingAdminId: '507f1f77bcf86cd799439011',
-     *     tagId: '67ec1234abcd5678ef901234',
-     *   });
-     * ```
-     */
-    attachTag(id: string, params: ConversationAttachTagParams, options?: RequestOptions): APIPromise<ConversationAttachTagResponse>;
-    /**
-     * 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
+     * ### Example Response
      *
      * ```json
      * {
-     *   "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"
      * }
      * ```
      *
@@ -577,17 +587,15 @@ export declare class Conversations extends APIResource {
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.support.conversations.detachTag(
-     *     '67ec1234abcd5678ef901234',
-     *     {
-     *       id: '12345',
-     *       actingAdminId: '507f1f77bcf86cd799439011',
-     *     },
-     *   );
+     * const conversationPart =
+     *   await client.support.conversations.reply('12345', {
+     *     bodyMarkdown: 'Thank you for your help!',
+     *     messageType: 'reply',
+     *     type: 'contact',
+     *   });
      * ```
      */
-    detachTag(tagID: string, params: ConversationDetachTagParams, options?: RequestOptions): APIPromise<ConversationDetachTagResponse>;
+    reply(id: string, params: ConversationReplyParams, options?: RequestOptions): APIPromise<ConversationPart>;
     /**
      * Redacts a conversation part (message) from a conversation. Redaction permanently
      * removes the message content while preserving the conversation structure.
@@ -668,8 +676,10 @@ export declare class Conversations extends APIResource {
      */
     redact(params: ConversationRedactParams, options?: RequestOptions): APIPromise<Conversation>;
     /**
-     * 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
      *
@@ -677,88 +687,78 @@ export declare class Conversations extends 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: string, params: ConversationAttachTagParams, options?: RequestOptions): APIPromise<AttachedConversationTag>;
+    /**
+     * 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
+     *
+     * - `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 Response
+     * ### 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"
      * }
      * ```
      *
@@ -768,15 +768,17 @@ export declare class Conversations extends 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: string, params: ConversationReplyParams, options?: RequestOptions): APIPromise<ConversationPart>;
+    detachTag(tagID: string, params: ConversationDetachTagParams, options?: RequestOptions): APIPromise<AttachedConversationTag>;
     /**
      * Search conversations with a structured filter AST and an optional full-text
      * query.
@@ -785,7 +787,7 @@ export declare class Conversations extends 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
@@ -804,7 +806,7 @@ export declare class Conversations extends APIResource {
      *     "value": [
      *       { "field": "state", "operator": "=", "value": "open" },
      *       {
-     *         "field": "admin_assignee_id",
+     *         "field": "adminAssigneeId",
      *         "operator": "=",
      *         "value": "507f1f77bcf86cd799439011"
      *       }
@@ -817,18 +819,24 @@ export declare class Conversations extends 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
@@ -879,6 +887,41 @@ export declare class Conversations extends APIResource {
     search(params: ConversationSearchParams, options?: RequestOptions): APIPromise<ConversationSearchResponse>;
 }
 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
@@ -983,6 +1026,19 @@ export interface Conversation {
      * exists.
      */
     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
      */
@@ -996,7 +1052,7 @@ export interface Conversation {
      * infer content access.
      */
     readReceipts?: Array<Conversation.ReadReceipt>;
-    source?: Conversation.Source;
+    source?: MessageSource;
     /**
      * Conversation title
      */
@@ -1024,12 +1080,14 @@ export declare namespace Conversation {
          * ISO timestamp when first-time submissions stop being accepted
          */
         lateSubmitWindowEndsAt?: string;
+        slackDelivery?: ConversationsAPI.CsatSlackDelivery;
     }
     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
          * conversation
@@ -1085,6 +1143,7 @@ export declare namespace Conversation {
          * Submitted score when this request was rated
          */
         score?: number;
+        slackDelivery?: ConversationsAPI.CsatSlackDelivery;
         workflow?: ConversationsAPI.CsatWorkflowLink;
     }
     /**
@@ -1107,7 +1166,7 @@ export declare namespace Conversation {
         /**
          * Channel used for the latest CSAT request when known
          */
-        channel?: 'desktop' | 'email';
+        channel?: 'desktop' | 'email' | 'slack';
         /**
          * ISO timestamp when the request expired
          */
@@ -1156,33 +1215,36 @@ export declare namespace Conversation {
          */
         userType: 'admin' | 'customer' | 'lead';
     }
-    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;
-        /**
-         * How the conversation was initiated
-         */
-        deliveredAs?: 'customer_initiated' | 'admin_initiated';
-        /**
-         * Subject line for email conversations
-         */
-        subject?: string;
-        /**
-         * URL where the conversation was initiated
-         */
-        url?: string;
-    }
+}
+export interface ConversationAttributeValue {
+    /**
+     * Stable machine identifier used as the key in conversation.customAttributes.
+     */
+    id: string;
+    /**
+     * Storage-level data type used for validation and search.
+     */
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object';
+    /**
+     * Conversation field subtype that controls the expected value shape.
+     */
+    fieldSubType: 'text' | 'number' | 'select' | 'multi-select' | 'checkbox' | 'date';
+    /**
+     * Stable internal identifier for the attribute definition.
+     */
+    identifier: string;
+    /**
+     * Human-readable attribute name shown in Featurebase.
+     */
+    name: string;
+    /**
+     * Allowed values for select and multi-select attributes.
+     */
+    options?: Array<ConversationAttributesAPI.ConversationAttributeOption>;
+    /**
+     * The conversation-specific custom attribute value.
+     */
+    value?: unknown;
 }
 /**
  * Message from a customer or lead
@@ -1208,7 +1270,7 @@ export declare 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
          */
@@ -1230,6 +1292,11 @@ export declare namespace ConversationPart {
          * 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
          */
@@ -1254,7 +1321,7 @@ export declare 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
          */
@@ -1276,6 +1343,11 @@ export declare namespace ConversationPart {
          * 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
          */
@@ -1405,11 +1477,16 @@ export declare 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
          */
@@ -1546,9 +1623,10 @@ export declare namespace ConversationPart {
          */
         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
              */
@@ -1616,9 +1694,10 @@ export declare namespace ConversationPart {
          */
         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
              */
@@ -1854,7 +1933,7 @@ export declare 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
          */
@@ -1864,25 +1943,6 @@ export declare namespace ConversationPart {
          */
         targetPartId?: string | null;
     }
-    namespace TagUpdate {
-        /**
-         * Actor that applied the tag
-         */
-        interface Actor {
-            /**
-             * 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;
-        }
-    }
     /**
      * Represents a workflow wait start, finish, or interruption in the conversation
      * thread
@@ -2062,7 +2122,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
      */
@@ -2070,47 +2130,28 @@ 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
      */
     tag?: ConversationTagsAPI.ConversationTag;
 }
-export declare namespace ConversationTagApplication {
+/**
+ * Actor that applied the tag
+ */
+export interface ConversationTagMutationActor {
     /**
-     * Actor that applied the tag
+     * Actor that caused the tag mutation
      */
-    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
      */
-    interface RemovedBy {
-        /**
-         * 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 | null;
+    /**
+     * Actor display name when available
+     */
+    name?: string | null;
 }
 export interface CsatEmailDelivery {
     /**
@@ -2144,6 +2185,37 @@ 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
@@ -2175,161 +2247,135 @@ 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 {
-    /**
-     * Unique tag identifier
-     */
-    id: string;
+export interface MessageSource {
     /**
-     * Current tag name
+     * Body of the initial message as HTML with signed image URLs
      */
-    name: string;
+    bodyHtml: string;
     /**
-     * Object type identifier for a tag
+     * Body of the initial message as markdown
      */
-    type: 'tag';
+    bodyMarkdown: string;
     /**
-     * ISO timestamp when the tag was applied
+     * Channel through which the conversation was initiated
      */
-    appliedAt?: string | null;
+    channel: 'unknown' | 'desktop' | 'android' | 'ios' | 'email' | 'slack';
+    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 declare namespace ConversationAttachTagResponse {
-    /**
-     * Actor that applied the tag
-     */
-    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;
-    }
+export declare namespace MessageSource {
     /**
-     * Actor that applied the tag
+     * Safe Slack thread identifiers. Only present for Slack-origin conversations while
+     * the organization has Slack integration enabled.
      */
-    interface RemovedBy {
+    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;
     }
 }
-export interface ConversationDetachTagResponse {
+/**
+ * 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 {
     /**
-     * Unique tag identifier
+     * Author id
      */
     id: string;
     /**
-     * Current tag name
+     * Author type
      */
-    name: string;
+    type: 'admin' | 'customer' | 'lead' | 'bot' | 'guest' | 'integration';
     /**
-     * Object type identifier for a tag
+     * Companies the author belongs to (customers only)
      */
-    type: 'tag';
+    companies?: Array<SearchMatchingPartAuthor.Company>;
     /**
-     * ISO timestamp when the tag was applied
+     * Email when known
      */
-    appliedAt?: string | null;
+    email?: string | null;
     /**
-     * Actor that applied the tag
+     * Display name when known
      */
-    appliedBy?: ConversationDetachTagResponse.AppliedBy | null;
+    name?: string | null;
     /**
-     * ISO timestamp when the tag was removed, if applicable
+     * Profile picture URL when known
      */
-    removedAt?: string | null;
+    profilePicture?: string | null;
+}
+export declare namespace SearchMatchingPartAuthor {
+    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
      */
-    removedBy?: ConversationDetachTagResponse.RemovedBy | null;
+    channelId: string;
     /**
-     * Reply/message ID used as the deterministic attachment target for this
-     * conversation tag mutation.
+     * Slack message timestamp
      */
-    targetPartId?: string | null;
+    messageTs: string;
+    /**
+     * Slack workspace/team ID for the message
+     */
+    teamId: string;
+    /**
+     * Slack root thread timestamp when this message belongs to a thread
+     */
+    threadTs?: string;
 }
-export declare namespace ConversationDetachTagResponse {
+export interface ConversationDeleteResponse {
     /**
-     * Actor that applied the tag
+     * Unique identifier of the deleted conversation
      */
-    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
      */
-    interface RemovedBy {
-        /**
-         * 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;
-    }
+    deleted: true;
+    /**
+     * Object type identifier
+     */
+    object: 'conversation';
 }
 export interface ConversationSearchResponse {
     /**
@@ -2418,7 +2464,20 @@ export declare 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
          * mode only)
@@ -2433,13 +2492,13 @@ export declare 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
          * more relevant.
          */
         relevanceScore?: number | null;
-        source?: Data.Source;
+        source?: ConversationsAPI.MessageSource;
         /**
          * Window of conversation messages around the matching part for lightweight context
          * previews. In search mode this is up to 15 messages before plus 15 from the
@@ -2455,42 +2514,6 @@ export declare namespace ConversationSearchResponse {
         title?: string;
     }
     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.
-         */
-        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;
-        }
-        namespace ConversationUser {
-            interface Company {
-                id: string;
-                name?: string;
-            }
-        }
         /**
          * Reference to the conversation part that best matched the search query (search
          * mode only)
@@ -2509,69 +2532,6 @@ export declare namespace ConversationSearchResponse {
              */
             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.
-         */
-        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;
-        }
-        namespace MatchingPartAuthor {
-            interface Company {
-                id: string;
-                name?: string;
-            }
-        }
-        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;
-            /**
-             * How the conversation was initiated
-             */
-            deliveredAs?: 'customer_initiated' | 'admin_initiated';
-            /**
-             * Subject line for email conversations
-             */
-            subject?: string;
-            /**
-             * URL where the conversation was initiated
-             */
-            url?: string;
-        }
         interface SurroundingConversationPart {
             /**
              * Conversation part id
@@ -2589,7 +2549,7 @@ export declare 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
              */
@@ -2599,46 +2559,26 @@ export declare namespace ConversationSearchResponse {
              */
             partType?: string;
         }
-        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.
-             */
-            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;
-            }
-            namespace Author {
-                interface Company {
-                    id: string;
-                    name?: string;
-                }
-            }
-        }
     }
 }
+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>;
+    /**
+     * 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 ConversationCreateParams {
     /**
      * Body param: The content of the initial message in markdown format. Images
@@ -2725,6 +2665,19 @@ export declare 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.
@@ -2743,8 +2696,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;
@@ -2803,82 +2757,6 @@ export declare namespace ConversationUpdateParams {
         contactIds?: Array<string>;
     }
 }
-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;
 export declare namespace ConversationReplyParams {
     interface ContactReplyBody {
@@ -2947,22 +2825,87 @@ export declare namespace ConversationReplyParams {
         '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 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
      * previous response to fetch the next page of results.
      */
     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.
      */
     limit?: number;
     /**
      * Body param: Structured filter AST. Either a single filter clause or one
-     * top-level AND group. Use this for filtering by `state`, `tag_ids`,
-     * `admin_assignee_id`, etc.
+     * top-level AND group. Use this for filtering by `state`, `tagIds`,
+     * `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.
      * Server-managed - no operators, no field selection.
@@ -2970,61 +2913,20 @@ export interface ConversationSearchParams {
     search?: string;
     /**
      * Body param: Result ordering. When omitted, filter mode defaults to
-     * last_activity_at:desc and search mode defaults to relevance ranking. When set,
+     * `lastActivityAt:desc` and search mode defaults to relevance ranking. When set,
      * both modes order by lastActivityAt in the requested direction (so you can ask a
-     * search query to return its hits in chronological order).
+     * search query to return its hits in chronological order). Snake_case
+     * `last_activity_at:*` is accepted for back-compat — prefer camelCase in new code.
      */
-    sort?: 'last_activity_at:desc' | 'last_activity_at:asc';
+    sort?: 'lastActivityAt:desc' | 'lastActivityAt:asc' | 'last_activity_at:desc' | 'last_activity_at:asc';
     /**
      * 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 declare namespace ConversationSearchParams {
-    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;
-    }
-    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>;
-    }
-    namespace SearchFilterGroup {
-        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;
-        }
-    }
-}
 export declare namespace Conversations {
-    export { type Conversation as Conversation, type ConversationPart as ConversationPart, type ConversationPartAuthor as ConversationPartAuthor, type ConversationParticipant as ConversationParticipant, type ConversationTagApplication as ConversationTagApplication, type CsatEmailDelivery as CsatEmailDelivery, type CsatRatedAgent as CsatRatedAgent, type CsatWorkflowLink as CsatWorkflowLink, type EmailRecipients as EmailRecipients, type ConversationDeleteResponse as ConversationDeleteResponse, type ConversationAttachTagResponse as ConversationAttachTagResponse, type ConversationDetachTagResponse as ConversationDetachTagResponse, type ConversationSearchResponse as ConversationSearchResponse, type ConversationsCursorPage as ConversationsCursorPage, type ConversationCreateParams as ConversationCreateParams, type ConversationRetrieveParams as ConversationRetrieveParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, type ConversationDeleteParams as ConversationDeleteParams, type ConversationAttachTagParams as ConversationAttachTagParams, type ConversationDetachTagParams as ConversationDetachTagParams, type ConversationRedactParams as ConversationRedactParams, type ConversationReplyParams as ConversationReplyParams, type ConversationSearchParams as ConversationSearchParams, };
+    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 ConversationSearchResponse as ConversationSearchResponse, type ConversationsCursorPage as ConversationsCursorPage, type ConversationListParams as ConversationListParams, type ConversationCreateParams as ConversationCreateParams, type ConversationRetrieveParams as ConversationRetrieveParams, 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 ConversationSearchParams as ConversationSearchParams, };
     export { Participants as Participants, type ParticipantAddParams as ParticipantAddParams, type ParticipantRemoveParams as ParticipantRemoveParams, };
 }
 //# sourceMappingURL=conversations.d.mts.map