featurebase-node 0.14.2 → 0.15.0

package/src/resources/support/conversation-tags.ts

@@ -11,22 +11,24 @@ import { path } from '../../internal/utils/path';
  */
 export class ConversationTags extends APIResource {
   /**
-   * Returns the live conversation tags available in the workspace tag catalog. These
-   * are the canonical tags that power conversation payloads, filters, and tag
-   * mutation endpoints.
+   * Returns a single conversation tag by its Featurebase tag ID. Archived tags can
+   * still be retrieved directly by ID, while permanently deleted tags return `404`.
    *
    * @example
    * ```ts
-   * const conversationTags =
-   *   await client.support.conversationTags.list();
+   * const conversationTag =
+   *   await client.support.conversationTags.retrieve(
+   *     '67ec1234abcd5678ef901234',
+   *   );
    * ```
    */
-  list(
-    params: ConversationTagListParams | null | undefined = {},
+  retrieve(
+    id: string,
+    params: ConversationTagRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTagListResponse> {
+  ): APIPromise<ConversationTag> {
     const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-    return this._client.get('/v2/tags', {
+    return this._client.get(path`/v2/tags/${id}`, {
       ...options,
       headers: buildHeaders([
         {
@@ -40,24 +42,22 @@ export class ConversationTags extends APIResource {
   }
 
   /**
-   * Creates a new workspace conversation tag when only `name` is provided. If `id`
-   * is also provided, the existing tag is renamed instead.
+   * Returns the live conversation tags available in the workspace tag catalog. These
+   * are the canonical tags that power conversation payloads, filters, and tag
+   * mutation endpoints.
    *
    * @example
    * ```ts
-   * const conversationTag =
-   *   await client.support.conversationTags.createOrRename({
-   *     name: 'Churn',
-   *   });
+   * const conversationTags =
+   *   await client.support.conversationTags.list();
    * ```
    */
-  createOrRename(
-    params: ConversationTagCreateOrRenameParams,
+  list(
+    params: ConversationTagListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTag> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-    return this._client.post('/v2/tags', {
-      body,
+  ): APIPromise<ConversationTagListResponse> {
+    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+    return this._client.get('/v2/tags', {
       ...options,
       headers: buildHeaders([
         {
@@ -71,24 +71,26 @@ export class ConversationTags extends APIResource {
   }
 
   /**
-   * Returns a single conversation tag by its Featurebase tag ID. Archived tags can
-   * still be retrieved directly by ID, while permanently deleted tags return `404`.
+   * Deletes a conversation tag from the workspace catalog and removes it from
+   * aggregate conversation tag state. Archived and historical part applications
+   * remain part of the audit trail where applicable.
    *
    * @example
    * ```ts
    * const conversationTag =
-   *   await client.support.conversationTags.retrieve(
+   *   await client.support.conversationTags.delete(
    *     '67ec1234abcd5678ef901234',
    *   );
    * ```
    */
-  retrieve(
+  delete(
     id: string,
-    params: ConversationTagRetrieveParams | null | undefined = {},
+    params: ConversationTagDeleteParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTag> {
-    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-    return this._client.get(path`/v2/tags/${id}`, {
+  ): APIPromise<ConversationTagDeleteResponse> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params ?? {};
+    return this._client.delete(path`/v2/tags/${id}`, {
+      body,
       ...options,
       headers: buildHeaders([
         {
@@ -102,25 +104,23 @@ export class ConversationTags extends APIResource {
   }
 
   /**
-   * Deletes a conversation tag from the workspace catalog and removes it from
-   * aggregate conversation tag state. Archived and historical part applications
-   * remain part of the audit trail where applicable.
+   * Creates a new workspace conversation tag when only `name` is provided. If `id`
+   * is also provided, the existing tag is renamed instead.
    *
    * @example
    * ```ts
    * const conversationTag =
-   *   await client.support.conversationTags.delete(
-   *     '67ec1234abcd5678ef901234',
-   *   );
+   *   await client.support.conversationTags.createOrRename({
+   *     name: 'Churn',
+   *   });
    * ```
    */
-  delete(
-    id: string,
-    params: ConversationTagDeleteParams | null | undefined = {},
+  createOrRename(
+    params: ConversationTagCreateOrRenameParams,
     options?: RequestOptions,
-  ): APIPromise<ConversationTagDeleteResponse> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params ?? {};
-    return this._client.delete(path`/v2/tags/${id}`, {
+  ): APIPromise<ConversationTag> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/tags', {
       body,
       ...options,
       headers: buildHeaders([
@@ -186,26 +186,23 @@ export interface ConversationTagDeleteResponse {
   object: 'tag';
 }
 
-export interface ConversationTagListParams {
+export interface ConversationTagRetrieveParams {
   /**
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface ConversationTagCreateOrRenameParams {
-  /**
-   * Body param: Tag name
-   */
-  name: string;
-
+export interface ConversationTagListParams {
   /**
-   * Body param: Optional existing tag ID. Provide this to rename an existing tag
-   * instead of creating a new one.
+   * API version for this request. Defaults to your organization's configured API
+   * version if not specified.
    */
-  id?: string;
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
 
+export interface ConversationTagDeleteParams {
   /**
    * Body param: Optional admin ID for actor attribution and permission checks.
    */
@@ -215,18 +212,21 @@ export interface ConversationTagCreateOrRenameParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface ConversationTagRetrieveParams {
+export interface ConversationTagCreateOrRenameParams {
   /**
-   * API version for this request. Defaults to your organization's configured API
-   * version if not specified.
+   * Body param: Tag name
    */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
+  name: string;
+
+  /**
+   * Body param: Optional existing tag ID. Provide this to rename an existing tag
+   * instead of creating a new one.
+   */
+  id?: string;
 
-export interface ConversationTagDeleteParams {
   /**
    * Body param: Optional admin ID for actor attribution and permission checks.
    */
@@ -236,7 +236,7 @@ export interface ConversationTagDeleteParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export declare namespace ConversationTags {
@@ -244,9 +244,9 @@ export declare namespace ConversationTags {
     type ConversationTag as ConversationTag,
     type ConversationTagListResponse as ConversationTagListResponse,
     type ConversationTagDeleteResponse as ConversationTagDeleteResponse,
-    type ConversationTagListParams as ConversationTagListParams,
-    type ConversationTagCreateOrRenameParams as ConversationTagCreateOrRenameParams,
     type ConversationTagRetrieveParams as ConversationTagRetrieveParams,
+    type ConversationTagListParams as ConversationTagListParams,
     type ConversationTagDeleteParams as ConversationTagDeleteParams,
+    type ConversationTagCreateOrRenameParams as ConversationTagCreateOrRenameParams,
   };
 }