featurebase-node 0.13.0 → 0.14.0

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

@@ -11,24 +11,22 @@ import { path } from '../../internal/utils/path';
  */
 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`.
+   * 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.retrieve(
-   *     '67ec1234abcd5678ef901234',
-   *   );
+   * const conversationTags =
+   *   await client.support.conversationTags.list();
    * ```
    */
-  retrieve(
-    id: string,
-    params: ConversationTagRetrieveParams | null | undefined = {},
+  list(
+    params: ConversationTagListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTag> {
+  ): APIPromise<ConversationTagListResponse> {
     const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-    return this._client.get(path`/v2/tags/${id}`, {
+    return this._client.get('/v2/tags', {
       ...options,
       headers: buildHeaders([
         {
@@ -42,22 +40,24 @@ 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.
+   * 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 conversationTags =
-   *   await client.support.conversationTags.list();
+   * const conversationTag =
+   *   await client.support.conversationTags.createOrRename({
+   *     name: 'Churn',
+   *   });
    * ```
    */
-  list(
-    params: ConversationTagListParams | null | undefined = {},
+  createOrRename(
+    params: ConversationTagCreateOrRenameParams,
     options?: RequestOptions,
-  ): APIPromise<ConversationTagListResponse> {
-    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
-    return this._client.get('/v2/tags', {
+  ): APIPromise<ConversationTag> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/tags', {
+      body,
       ...options,
       headers: buildHeaders([
         {
@@ -71,26 +71,24 @@ 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.
+   * 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 conversationTag =
-   *   await client.support.conversationTags.delete(
+   *   await client.support.conversationTags.retrieve(
    *     '67ec1234abcd5678ef901234',
    *   );
    * ```
    */
-  delete(
+  retrieve(
     id: string,
-    params: ConversationTagDeleteParams | null | undefined = {},
+    params: ConversationTagRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTagDeleteResponse> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params ?? {};
-    return this._client.delete(path`/v2/tags/${id}`, {
-      body,
+  ): APIPromise<ConversationTag> {
+    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+    return this._client.get(path`/v2/tags/${id}`, {
       ...options,
       headers: buildHeaders([
         {
@@ -104,23 +102,25 @@ 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.
+   * 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.createOrRename({
-   *     name: 'Churn',
-   *   });
+   *   await client.support.conversationTags.delete(
+   *     '67ec1234abcd5678ef901234',
+   *   );
    * ```
    */
-  createOrRename(
-    params: ConversationTagCreateOrRenameParams,
+  delete(
+    id: string,
+    params: ConversationTagDeleteParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConversationTag> {
-    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
-    return this._client.post('/v2/tags', {
+  ): APIPromise<ConversationTagDeleteResponse> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params ?? {};
+    return this._client.delete(path`/v2/tags/${id}`, {
       body,
       ...options,
       headers: buildHeaders([
@@ -186,7 +186,7 @@ export interface ConversationTagDeleteResponse {
   object: 'tag';
 }
 
-export interface ConversationTagRetrieveParams {
+export interface ConversationTagListParams {
   /**
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
@@ -194,15 +194,18 @@ export interface ConversationTagRetrieveParams {
   'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface ConversationTagListParams {
+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.
    */
@@ -215,18 +218,15 @@ export interface ConversationTagDeleteParams {
   'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface ConversationTagCreateOrRenameParams {
-  /**
-   * Body param: Tag name
-   */
-  name: string;
-
+export interface ConversationTagRetrieveParams {
   /**
-   * 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-01-01.nova' | '2025-12-12.clover';
+}
 
+export interface ConversationTagDeleteParams {
   /**
    * Body param: Optional admin ID for actor attribution and permission checks.
    */
@@ -244,9 +244,9 @@ export declare namespace ConversationTags {
     type ConversationTag as ConversationTag,
     type ConversationTagListResponse as ConversationTagListResponse,
     type ConversationTagDeleteResponse as ConversationTagDeleteResponse,
-    type ConversationTagRetrieveParams as ConversationTagRetrieveParams,
     type ConversationTagListParams as ConversationTagListParams,
-    type ConversationTagDeleteParams as ConversationTagDeleteParams,
     type ConversationTagCreateOrRenameParams as ConversationTagCreateOrRenameParams,
+    type ConversationTagRetrieveParams as ConversationTagRetrieveParams,
+    type ConversationTagDeleteParams as ConversationTagDeleteParams,
   };
 }