@37signals/basecamp 0.2.0

package/dist/generated/services/card-columns.js

@@ -0,0 +1,264 @@
+/**
+ * CardColumns service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+import { BaseService } from "../../services/base.js";
+import { Errors } from "../../errors.js";
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service for CardColumns operations.
+ */
+export class CardColumnsService extends BaseService {
+    /**
+     * Get a card column by ID
+     * @param columnId - The column ID
+     * @returns The CardColumn
+     * @throws {BasecampError} If the resource is not found
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.get(123);
+     * ```
+     */
+    async get(columnId) {
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "GetCardColumn",
+            resourceType: "card_column",
+            isMutation: false,
+            resourceId: columnId,
+        }, () => this.client.GET("/card_tables/columns/{columnId}", {
+            params: {
+                path: { columnId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Update an existing column
+     * @param columnId - The column ID
+     * @param req - Card_column update parameters
+     * @returns The CardColumn
+     * @throws {BasecampError} If the resource is not found or fields are invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.update(123, { });
+     * ```
+     */
+    async update(columnId, req) {
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "UpdateCardColumn",
+            resourceType: "card_column",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.PUT("/card_tables/columns/{columnId}", {
+            params: {
+                path: { columnId },
+            },
+            body: {
+                title: req.title,
+                description: req.description,
+            },
+        }));
+        return response;
+    }
+    /**
+     * Set the color of a column
+     * @param columnId - The column ID
+     * @param req - Card_column_color request parameters
+     * @returns The CardColumn
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.setColor(123, { color: "example" });
+     * ```
+     */
+    async setColor(columnId, req) {
+        if (!req.color) {
+            throw Errors.validation("Color is required");
+        }
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "SetCardColumnColor",
+            resourceType: "card_column_color",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.PUT("/card_tables/columns/{columnId}/color.json", {
+            params: {
+                path: { columnId },
+            },
+            body: {
+                color: req.color,
+            },
+        }));
+        return response;
+    }
+    /**
+     * Enable on-hold section in a column
+     * @param columnId - The column ID
+     * @returns The CardColumn
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.enableOnHold(123);
+     * ```
+     */
+    async enableOnHold(columnId) {
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "EnableCardColumnOnHold",
+            resourceType: "card_column_on_hold",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.POST("/card_tables/columns/{columnId}/on_hold.json", {
+            params: {
+                path: { columnId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Disable on-hold section in a column
+     * @param columnId - The column ID
+     * @returns The CardColumn
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.disableOnHold(123);
+     * ```
+     */
+    async disableOnHold(columnId) {
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "DisableCardColumnOnHold",
+            resourceType: "card_column_on_hold",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.DELETE("/card_tables/columns/{columnId}/on_hold.json", {
+            params: {
+                path: { columnId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Subscribe to a card column (watch for changes)
+     * @param columnId - The column ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.cardColumns.subscribeToColumn(123);
+     * ```
+     */
+    async subscribeToColumn(columnId) {
+        await this.request({
+            service: "CardColumns",
+            operation: "SubscribeToCardColumn",
+            resourceType: "to_card_column",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.POST("/card_tables/lists/{columnId}/subscription.json", {
+            params: {
+                path: { columnId },
+            },
+        }));
+    }
+    /**
+     * Unsubscribe from a card column (stop watching for changes)
+     * @param columnId - The column ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.cardColumns.unsubscribeFromColumn(123);
+     * ```
+     */
+    async unsubscribeFromColumn(columnId) {
+        await this.request({
+            service: "CardColumns",
+            operation: "UnsubscribeFromCardColumn",
+            resourceType: "from_card_column",
+            isMutation: true,
+            resourceId: columnId,
+        }, () => this.client.DELETE("/card_tables/lists/{columnId}/subscription.json", {
+            params: {
+                path: { columnId },
+            },
+        }));
+    }
+    /**
+     * Create a column in a card table
+     * @param cardTableId - The card table ID
+     * @param req - Card_column creation parameters
+     * @returns The CardColumn
+     * @throws {BasecampError} If required fields are missing or invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.cardColumns.create(123, { title: "example" });
+     * ```
+     */
+    async create(cardTableId, req) {
+        if (!req.title) {
+            throw Errors.validation("Title is required");
+        }
+        const response = await this.request({
+            service: "CardColumns",
+            operation: "CreateCardColumn",
+            resourceType: "card_column",
+            isMutation: true,
+            resourceId: cardTableId,
+        }, () => this.client.POST("/card_tables/{cardTableId}/columns.json", {
+            params: {
+                path: { cardTableId },
+            },
+            body: {
+                title: req.title,
+                description: req.description,
+            },
+        }));
+        return response;
+    }
+    /**
+     * Move a column within a card table
+     * @param cardTableId - The card table ID
+     * @param req - Card_column request parameters
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.cardColumns.move(123, { sourceId: 1, targetId: 1 });
+     * ```
+     */
+    async move(cardTableId, req) {
+        await this.request({
+            service: "CardColumns",
+            operation: "MoveCardColumn",
+            resourceType: "card_column",
+            isMutation: true,
+            resourceId: cardTableId,
+        }, () => this.client.POST("/card_tables/{cardTableId}/moves.json", {
+            params: {
+                path: { cardTableId },
+            },
+            body: {
+                source_id: req.sourceId,
+                target_id: req.targetId,
+                position: req.position,
+            },
+        }));
+    }
+}
+//# sourceMappingURL=card-columns.js.map

package/dist/generated/services/card-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-columns.js","sourceRoot":"","sources":["../../../src/generated/services/card-columns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAkDzC,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAEjD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,eAAe;YAC1B,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE;YACjD,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,GAA4B;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,kBAAkB;YAC7B,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE;YACjD,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,GAAG,CAAC,WAAW;aAC7B;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,GAA8B;QAC7D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,oBAAoB;YAC/B,YAAY,EAAE,mBAAmB;YACjC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4CAA4C,EAAE;YAC5D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,wBAAwB;YACnC,YAAY,EAAE,qBAAqB;YACnC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;YAC/D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,yBAAyB;YACpC,YAAY,EAAE,qBAAqB;YACnC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,8CAA8C,EAAE;YACjE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,IAAI,CAAC,OAAO,CAChB;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,uBAAuB;YAClC,YAAY,EAAE,gBAAgB;YAC9B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE;YAClE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,qBAAqB,CAAC,QAAgB;QAC1C,MAAM,IAAI,CAAC,OAAO,CAChB;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,2BAA2B;YACtC,YAAY,EAAE,kBAAkB;YAChC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,iDAAiD,EAAE;YACpE,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,GAA4B;QAC5D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,kBAAkB;YAC7B,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,WAAW;SACxB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;YAC1D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,WAAW,EAAE;aACtB;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,GAAG,CAAC,WAAW;aAC7B;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,GAA0B;QACxD,MAAM,IAAI,CAAC,OAAO,CAChB;YACE,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,WAAW;SACxB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACxD,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,WAAW,EAAE;aACtB;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,GAAG,CAAC,QAAQ;gBACvB,SAAS,EAAE,GAAG,CAAC,QAAQ;gBACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB;SACF,CAAC,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/generated/services/card-columns.ts

@@ -0,0 +1,360 @@
+/**
+ * CardColumns service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+
+import { BaseService } from "../../services/base.js";
+import type { components } from "../schema.js";
+import { Errors } from "../../errors.js";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/** CardColumn entity from the Basecamp API. */
+export type CardColumn = components["schemas"]["CardColumn"];
+
+/**
+ * Request parameters for update.
+ */
+export interface UpdateCardColumnRequest {
+  /** Title */
+  title?: string;
+  /** Rich text description (HTML) */
+  description?: string;
+}
+
+/**
+ * Request parameters for setColor.
+ */
+export interface SetColorCardColumnRequest {
+  /** Valid colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown */
+  color: string;
+}
+
+/**
+ * Request parameters for create.
+ */
+export interface CreateCardColumnRequest {
+  /** Title */
+  title: string;
+  /** Rich text description (HTML) */
+  description?: string;
+}
+
+/**
+ * Request parameters for move.
+ */
+export interface MoveCardColumnRequest {
+  /** Source id */
+  sourceId: number;
+  /** Target id */
+  targetId: number;
+  /** Position for ordering (1-based) */
+  position?: number;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for CardColumns operations.
+ */
+export class CardColumnsService extends BaseService {
+
+  /**
+   * Get a card column by ID
+   * @param columnId - The column ID
+   * @returns The CardColumn
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.get(123);
+   * ```
+   */
+  async get(columnId: number): Promise<CardColumn> {
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "GetCardColumn",
+        resourceType: "card_column",
+        isMutation: false,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.GET("/card_tables/columns/{columnId}", {
+          params: {
+            path: { columnId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Update an existing column
+   * @param columnId - The column ID
+   * @param req - Card_column update parameters
+   * @returns The CardColumn
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.update(123, { });
+   * ```
+   */
+  async update(columnId: number, req: UpdateCardColumnRequest): Promise<CardColumn> {
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "UpdateCardColumn",
+        resourceType: "card_column",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.PUT("/card_tables/columns/{columnId}", {
+          params: {
+            path: { columnId },
+          },
+          body: {
+            title: req.title,
+            description: req.description,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Set the color of a column
+   * @param columnId - The column ID
+   * @param req - Card_column_color request parameters
+   * @returns The CardColumn
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.setColor(123, { color: "example" });
+   * ```
+   */
+  async setColor(columnId: number, req: SetColorCardColumnRequest): Promise<CardColumn> {
+    if (!req.color) {
+      throw Errors.validation("Color is required");
+    }
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "SetCardColumnColor",
+        resourceType: "card_column_color",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.PUT("/card_tables/columns/{columnId}/color.json", {
+          params: {
+            path: { columnId },
+          },
+          body: {
+            color: req.color,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Enable on-hold section in a column
+   * @param columnId - The column ID
+   * @returns The CardColumn
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.enableOnHold(123);
+   * ```
+   */
+  async enableOnHold(columnId: number): Promise<CardColumn> {
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "EnableCardColumnOnHold",
+        resourceType: "card_column_on_hold",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.POST("/card_tables/columns/{columnId}/on_hold.json", {
+          params: {
+            path: { columnId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Disable on-hold section in a column
+   * @param columnId - The column ID
+   * @returns The CardColumn
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.disableOnHold(123);
+   * ```
+   */
+  async disableOnHold(columnId: number): Promise<CardColumn> {
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "DisableCardColumnOnHold",
+        resourceType: "card_column_on_hold",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.DELETE("/card_tables/columns/{columnId}/on_hold.json", {
+          params: {
+            path: { columnId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Subscribe to a card column (watch for changes)
+   * @param columnId - The column ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.cardColumns.subscribeToColumn(123);
+   * ```
+   */
+  async subscribeToColumn(columnId: number): Promise<void> {
+    await this.request(
+      {
+        service: "CardColumns",
+        operation: "SubscribeToCardColumn",
+        resourceType: "to_card_column",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.POST("/card_tables/lists/{columnId}/subscription.json", {
+          params: {
+            path: { columnId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Unsubscribe from a card column (stop watching for changes)
+   * @param columnId - The column ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.cardColumns.unsubscribeFromColumn(123);
+   * ```
+   */
+  async unsubscribeFromColumn(columnId: number): Promise<void> {
+    await this.request(
+      {
+        service: "CardColumns",
+        operation: "UnsubscribeFromCardColumn",
+        resourceType: "from_card_column",
+        isMutation: true,
+        resourceId: columnId,
+      },
+      () =>
+        this.client.DELETE("/card_tables/lists/{columnId}/subscription.json", {
+          params: {
+            path: { columnId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Create a column in a card table
+   * @param cardTableId - The card table ID
+   * @param req - Card_column creation parameters
+   * @returns The CardColumn
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.cardColumns.create(123, { title: "example" });
+   * ```
+   */
+  async create(cardTableId: number, req: CreateCardColumnRequest): Promise<CardColumn> {
+    if (!req.title) {
+      throw Errors.validation("Title is required");
+    }
+    const response = await this.request(
+      {
+        service: "CardColumns",
+        operation: "CreateCardColumn",
+        resourceType: "card_column",
+        isMutation: true,
+        resourceId: cardTableId,
+      },
+      () =>
+        this.client.POST("/card_tables/{cardTableId}/columns.json", {
+          params: {
+            path: { cardTableId },
+          },
+          body: {
+            title: req.title,
+            description: req.description,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Move a column within a card table
+   * @param cardTableId - The card table ID
+   * @param req - Card_column request parameters
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.cardColumns.move(123, { sourceId: 1, targetId: 1 });
+   * ```
+   */
+  async move(cardTableId: number, req: MoveCardColumnRequest): Promise<void> {
+    await this.request(
+      {
+        service: "CardColumns",
+        operation: "MoveCardColumn",
+        resourceType: "card_column",
+        isMutation: true,
+        resourceId: cardTableId,
+      },
+      () =>
+        this.client.POST("/card_tables/{cardTableId}/moves.json", {
+          params: {
+            path: { cardTableId },
+          },
+          body: {
+            source_id: req.sourceId,
+            target_id: req.targetId,
+            position: req.position,
+          },
+        })
+    );
+  }
+}