featurebase-node 0.8.1 → 0.9.0

package/resources/support/conversations/conversations.d.ts

@@ -3,8 +3,6 @@ import * as ConversationsAPI from "./conversations.js";
 import * as ConversationTagsAPI from "../conversation-tags.js";
 import * as ParticipantsAPI from "./participants.js";
 import { ParticipantAddParams, ParticipantRemoveParams, Participants } from "./participants.js";
-import * as TagsAPI from "./tags.js";
-import { AttachedConversationTag, ConversationTagMutationActor, TagAttachParams, TagDetachParams, Tags } from "./tags.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { CursorPage, type CursorPageParams, PagePromise } from "../../../core/pagination.js";
 import { RequestOptions } from "../../../internal/request-options.js";
@@ -12,7 +10,6 @@ import { RequestOptions } from "../../../internal/request-options.js";
  * Conversations are messenger/inbox conversations in your Featurebase organization. Use this endpoint to list and retrieve conversation information.
  */
 export declare class Conversations extends APIResource {
-    tags: TagsAPI.Tags;
     participants: ParticipantsAPI.Participants;
     /**
      * Creates a new conversation. Supports both contact-initiated (customer/lead) and
@@ -487,6 +484,110 @@ export declare class Conversations extends APIResource {
      * ```
      */
     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
+     *
+     * ```json
+     * {
+     *   "tagId": "67ec1234abcd5678ef901234",
+     *   "actingAdminId": "507f1f77bcf86cd799439011"
+     * }
+     * ```
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.support.conversations.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
+     *
+     * ```json
+     * {
+     *   "actingAdminId": "507f1f77bcf86cd799439011"
+     * }
+     * ```
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.support.conversations.detachTag(
+     *     '67ec1234abcd5678ef901234',
+     *     {
+     *       id: '12345',
+     *       actingAdminId: '507f1f77bcf86cd799439011',
+     *     },
+     *   );
+     * ```
+     */
+    detachTag(tagID: string, params: ConversationDetachTagParams, options?: RequestOptions): APIPromise<ConversationDetachTagResponse>;
     /**
      * Redacts a conversation part (message) from a conversation. Redaction permanently
      * removes the message content while preserving the conversation structure.
@@ -676,6 +777,100 @@ export declare class Conversations extends APIResource {
      * ```
      */
     reply(id: string, params: ConversationReplyParams, options?: RequestOptions): APIPromise<ConversationPart>;
+    /**
+     * Search conversations with a structured filter AST and an optional full-text
+     * query.
+     *
+     * The endpoint has two modes that are picked automatically from the body:
+     *
+     * - **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.
+     * - **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.
+     *
+     * ### Structured query AST
+     *
+     * Each clause has the shape `{ field, operator, value }`. You can pass a single
+     * clause or wrap up to 15 in a top-level `AND` group:
+     *
+     * ```json
+     * {
+     *   "query": {
+     *     "operator": "AND",
+     *     "value": [
+     *       { "field": "state", "operator": "=", "value": "open" },
+     *       {
+     *         "field": "admin_assignee_id",
+     *         "operator": "=",
+     *         "value": "507f1f77bcf86cd799439011"
+     *       }
+     *     ]
+     *   }
+     * }
+     * ```
+     *
+     * Top-level `OR` groups and nested groups are not supported in this version.
+     *
+     * ### 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` |
+     * | `mentioned_admin_ids`        | admin id                                          | `=`, `!=`, `IN`, `NIN` |
+     * | `created_at`                 | 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
+     * with at least one positive clause (`=`, `IN`, `>`, `<`) instead. Bounded enum
+     * fields (`state`, `priority`) are exempt because their negation is naturally
+     * bounded.
+     *
+     * ### Pagination
+     *
+     * Cursor-based, `limit` between 1 and 100 (default 10). Pagination cursors are
+     * mode-specific - reusing a filter-mode cursor in search mode (or vice versa)
+     * returns `400`. `totalCount` is approximate and capped at 1000;
+     * `totalCountCapped` is `true` when the real count may be higher.
+     *
+     * ### Response
+     *
+     * Returns a slim conversation row optimised for inbox / list rendering - just the
+     * fields you need to render a row and link to the conversation. Fetch the full
+     * conversation via `GET /v2/conversations/{id}` when the user opens one.
+     *
+     * Search-specific additions on each row:
+     *
+     * - `conversationUser` - the customer / lead the conversation is with. Use this
+     *   for the row identity.
+     * - `latestConversationParts` - capped latest-message preview window. Each
+     *   `previewMarkdown` value is truncated server-side; fetch the full conversation
+     *   for complete history and full bodies.
+     * - `matchingPartAuthor` - author of the specific message that matched the search
+     *   query (search mode only). May be a teammate or bot.
+     * - `matchingPart` - reference to the matched message (search mode only).
+     * - `matchingBodyPreviewMarkdown` - plain-text / markdown preview of the matched
+     *   body (search mode only).
+     * - `relevanceScore` - aggregate score (search mode only).
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.support.conversations.search();
+     * ```
+     */
+    search(params: ConversationSearchParams, options?: RequestOptions): APIPromise<ConversationSearchResponse>;
 }
 export type ConversationsCursorPage = CursorPage<Conversation>;
 export interface Conversation {
@@ -1653,7 +1848,7 @@ export declare namespace ConversationPart {
         /**
          * Actor that applied the tag
          */
-        actor?: TagsAPI.ConversationTagMutationActor;
+        actor?: TagUpdate.Actor;
         /**
          * Tag name at the time of the event or the best available current display name
          */
@@ -1663,6 +1858,25 @@ 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
@@ -1842,7 +2056,7 @@ export interface ConversationTagApplication {
     /**
      * Actor that applied the tag
      */
-    appliedBy?: TagsAPI.ConversationTagMutationActor;
+    appliedBy?: ConversationTagApplication.AppliedBy;
     /**
      * ISO timestamp when the tag was removed from this reply, if it was removed
      */
@@ -1850,12 +2064,48 @@ export interface ConversationTagApplication {
     /**
      * Actor that applied the tag
      */
-    removedBy?: TagsAPI.ConversationTagMutationActor;
+    removedBy?: ConversationTagApplication.RemovedBy;
     /**
      * 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
+     */
+    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;
+    }
+    /**
+     * Actor that applied the tag
+     */
+    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;
+    }
+}
 export interface CsatEmailDelivery {
     /**
      * Email delivery status for the CSAT request when applicable
@@ -1933,6 +2183,453 @@ export interface ConversationDeleteResponse {
      */
     object: 'conversation';
 }
+export interface ConversationAttachTagResponse {
+    /**
+     * 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?: ConversationAttachTagResponse.AppliedBy | null;
+    /**
+     * ISO timestamp when the tag was removed, if applicable
+     */
+    removedAt?: string | null;
+    /**
+     * Actor that applied the tag
+     */
+    removedBy?: ConversationAttachTagResponse.RemovedBy | null;
+    /**
+     * Reply/message ID used as the deterministic attachment target for this
+     * conversation tag mutation.
+     */
+    targetPartId?: string | null;
+}
+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;
+    }
+    /**
+     * Actor that applied the tag
+     */
+    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;
+    }
+}
+export interface ConversationDetachTagResponse {
+    /**
+     * 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?: ConversationDetachTagResponse.AppliedBy | null;
+    /**
+     * ISO timestamp when the tag was removed, if applicable
+     */
+    removedAt?: string | null;
+    /**
+     * Actor that applied the tag
+     */
+    removedBy?: ConversationDetachTagResponse.RemovedBy | null;
+    /**
+     * Reply/message ID used as the deterministic attachment target for this
+     * conversation tag mutation.
+     */
+    targetPartId?: string | null;
+}
+export declare namespace ConversationDetachTagResponse {
+    /**
+     * 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;
+    }
+    /**
+     * Actor that applied the tag
+     */
+    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;
+    }
+}
+export interface ConversationSearchResponse {
+    /**
+     * Array of search results
+     */
+    data: Array<ConversationSearchResponse.Data>;
+    /**
+     * Cursor for fetching the next page (null if no more results)
+     */
+    nextCursor: string | null;
+    /**
+     * Object type identifier
+     */
+    object: 'list';
+    /**
+     * Total number of conversations matching the query, capped at 200. When the actual
+     * total is at or above the cap, `totalCountCapped` is true and the value is
+     * exactly the cap.
+     */
+    totalCount?: number;
+    /**
+     * True when totalCount is exactly the cap and the real count is `>= totalCount`.
+     * UI may render as "200+".
+     */
+    totalCountCapped?: boolean;
+}
+export declare namespace ConversationSearchResponse {
+    interface Data {
+        /**
+         * Unique conversation identifier
+         */
+        id: string;
+        /**
+         * ID of the assigned admin
+         */
+        adminAssigneeId: string | null;
+        /**
+         * ID of the brand associated with this conversation
+         */
+        brandId: string | null;
+        /**
+         * ISO timestamp when conversation was created
+         */
+        createdAt: string;
+        /**
+         * ISO timestamp of last activity
+         */
+        lastActivityAt: string | null;
+        /**
+         * Object type identifier
+         */
+        object: 'conversation';
+        /**
+         * Participants in this conversation
+         */
+        participants: Array<ConversationsAPI.ConversationParticipant>;
+        /**
+         * Whether this conversation is marked as priority
+         */
+        priority: boolean;
+        /**
+         * ISO timestamp when priority was set
+         */
+        prioritySetAt: string | null;
+        /**
+         * Current state of the conversation
+         */
+        state: 'open' | 'closed' | 'snoozed';
+        /**
+         * Current tags applied anywhere in this conversation
+         */
+        tags: Array<ConversationTagsAPI.ConversationTag>;
+        /**
+         * ID of the assigned team
+         */
+        teamAssigneeId: string | null;
+        /**
+         * ISO timestamp when conversation was last updated
+         */
+        updatedAt: string;
+        /**
+         * Whether we are awaiting a customer reply
+         */
+        awaitingCustomerReply?: boolean;
+        /**
+         * 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;
+        /**
+         * Latest conversation messages for lightweight timeline previews. Capped and
+         * truncated by the server; fetch the full conversation for complete message
+         * history.
+         */
+        latestConversationParts?: Array<Data.LatestConversationPart>;
+        /**
+         * Plain-text / markdown preview of the matching conversation part body (search
+         * mode only)
+         */
+        matchingBodyPreviewMarkdown?: string | null;
+        /**
+         * Reference to the conversation part that best matched the search query (search
+         * mode only)
+         */
+        matchingPart?: Data.MatchingPart | null;
+        /**
+         * 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;
+        /**
+         * Aggregate relevance score for the conversation (search mode only). Higher is
+         * more relevant.
+         */
+        relevanceScore?: number | null;
+        source?: Data.Source;
+        /**
+         * Conversation title
+         */
+        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;
+            }
+        }
+        interface LatestConversationPart {
+            /**
+             * Conversation part id
+             */
+            id: string;
+            /**
+             * Plain-text truncated preview of the part body
+             */
+            previewMarkdown: string | null;
+            /**
+             * True when previewMarkdown was truncated by the server
+             */
+            previewMarkdownTruncated: boolean;
+            /**
+             * The customer or lead the conversation is with. Use this for the row identity;
+             * use `matchingPartAuthor` if you specifically want the message author.
+             */
+            author?: LatestConversationPart.Author | null;
+            /**
+             * ISO timestamp when the part was created
+             */
+            createdAt?: string | null;
+            /**
+             * Conversation part type
+             */
+            partType?: string;
+        }
+        namespace LatestConversationPart {
+            /**
+             * 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;
+                }
+            }
+        }
+        /**
+         * Reference to the conversation part that best matched the search query (search
+         * mode only)
+         */
+        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.
+         */
+        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;
+        }
+    }
+}
 export interface ConversationCreateParams {
     /**
      * Body param: The content of the initial message in markdown format. Images
@@ -2116,6 +2813,38 @@ export interface ConversationDeleteParams {
      */
     '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
@@ -2209,9 +2938,82 @@ export declare namespace ConversationReplyParams {
         '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: 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.
+     */
+    query?: ConversationSearchParams.ConversationSearchFilter | ConversationSearchParams.ConversationSearchFilterGroup;
+    /**
+     * Body param: Plain-text full-text search across conversation messages.
+     * Server-managed - no operators, no field selection.
+     */
+    search?: string;
+    /**
+     * Body param: Sort direction for filter mode (ignored in search mode where results
+     * are sorted by relevance). Defaults to last_activity_at:desc.
+     */
+    sort?: '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 ConversationSearchFilter {
+        /**
+         * 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 ConversationSearchFilterGroup {
+        /**
+         * Group operator: AND (all match) or OR (any match)
+         */
+        operator: 'AND' | 'OR';
+        /**
+         * Array of filter clauses (1-15 entries)
+         */
+        value: Array<ConversationSearchFilterGroup.Value>;
+    }
+    namespace ConversationSearchFilterGroup {
+        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 ConversationsCursorPage as ConversationsCursorPage, type ConversationCreateParams as ConversationCreateParams, type ConversationRetrieveParams as ConversationRetrieveParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, type ConversationDeleteParams as ConversationDeleteParams, type ConversationRedactParams as ConversationRedactParams, type ConversationReplyParams as ConversationReplyParams, };
-    export { Tags as Tags, type AttachedConversationTag as AttachedConversationTag, type ConversationTagMutationActor as ConversationTagMutationActor, type TagAttachParams as TagAttachParams, type TagDetachParams as TagDetachParams, };
+    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 { Participants as Participants, type ParticipantAddParams as ParticipantAddParams, type ParticipantRemoveParams as ParticipantRemoveParams, };
 }
 //# sourceMappingURL=conversations.d.ts.map