@augno/sdk 0.16.1 → 0.18.0

package/resources/sales/volume-discounts.js

@@ -0,0 +1,152 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeDiscounts = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * List and manage volume discounts.
+ */
+class VolumeDiscounts extends resource_1.APIResource {
+    /**
+     * Returns a paginated list of volume discounts, newest first.
+     *
+     * The search term matches the discount name, the name of a customer group it is
+     * scoped to, or the name of a product line it is scoped to. Customer portal users
+     * see only discounts with no customer-group restriction plus those scoped to a
+     * group their own account belongs to.
+     *
+     * This endpoint requires the permissions: `discounts:read`, `customers:read`,
+     * `suppliers:read`.
+     *
+     * @example
+     * ```ts
+     * const listVolumeDiscount =
+     *   await client.sales.volumeDiscounts.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/sales/volume-discounts', { query, ...options });
+    }
+    /**
+     * Returns a volume discount by ID.
+     *
+     * This endpoint requires the permissions: `discounts:read`, `customers:read`,
+     * `suppliers:read`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.retrieve(
+     *     'quds_bn7hto9s10pp',
+     *   );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/sales/volume-discounts/${id}`, { query, ...options });
+    }
+    /**
+     * Creates a volume discount with its tiers and scoping associations.
+     *
+     * The discount name must be unique within the account; creating a discount with an
+     * existing name returns a conflict error.
+     *
+     * Each scoping list narrows the order lines the discount applies to, and an empty
+     * list places no restriction on that dimension. Because tier thresholds are
+     * compared against quantities converted into `unit_ids`, a discount created
+     * without any units never reaches a threshold above zero.
+     *
+     * This endpoint requires the permission: `discounts:create`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.create({
+     *     name: 'Bulk Order Discount',
+     *     tiers: [
+     *       {
+     *         name: '100+ Units',
+     *         discount_percentage:
+     *           '5.000000000000000000000000000000',
+     *         threshold: '100.000000000000000000000000000000',
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/sales/volume-discounts', { query: { include }, body, ...options });
+    }
+    /**
+     * Partially updates a volume discount.
+     *
+     * The tier and association lists are only applied when their corresponding `has_*`
+     * flag is `true`, in which case they replace the existing set entirely. Tiers use
+     * upsert semantics: tiers with an `id` are updated, tiers without one are created,
+     * and existing tiers omitted from the list are deleted.
+     *
+     * The name must remain unique within the account; reusing another discount's name
+     * returns a conflict error. Order lines that have already been priced keep the
+     * unit price they were given; the revised discount applies to lines priced after
+     * the change.
+     *
+     * This endpoint requires the permission: `discounts:update`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.update(
+     *     'quds_bn7hto9s10pp',
+     *     {
+     *       has_attributes: true,
+     *       has_categories: true,
+     *       has_customer_groups: true,
+     *       has_product_lines: true,
+     *       has_tiers: true,
+     *       has_units: true,
+     *       name: 'Updated Bulk Discount',
+     *       tiers: [
+     *         {
+     *           name: '50+ Units',
+     *           discount_percentage:
+     *             '10.000000000000000000000000000000',
+     *           threshold: '50.000000000000000000000000000000',
+     *         },
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    update(id, params, options) {
+        const { include, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/sales/volume-discounts/${id}`, {
+            query: { include },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Deletes a volume discount along with its tiers and scoping associations.
+     *
+     * Deletion is permanent; further requests against the deleted ID return an error.
+     *
+     * Order lines that have already been priced keep the unit price they were given;
+     * only lines priced after the deletion lose the discount.
+     *
+     * This endpoint requires the permission: `discounts:delete`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.delete(
+     *     'quds_bn7hto9s10pp',
+     *   );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/v1/sales/volume-discounts/${id}`, options);
+    }
+}
+exports.VolumeDiscounts = VolumeDiscounts;
+//# sourceMappingURL=volume-discounts.js.map

package/resources/sales/volume-discounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume-discounts.js","sourceRoot":"","sources":["../../src/resources/sales/volume-discounts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AASlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,eAAgB,SAAQ,sBAAW;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,8BAA8B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,MAAM,CACJ,EAAU,EACV,MAAkC,EAClC,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,8BAA8B,EAAE,EAAE,EAAE;YAChE,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,8BAA8B,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CACF;AA3JD,0CA2JC"}

package/resources/sales/volume-discounts.mjs

@@ -0,0 +1,148 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * List and manage volume discounts.
+ */
+export class VolumeDiscounts extends APIResource {
+    /**
+     * Returns a paginated list of volume discounts, newest first.
+     *
+     * The search term matches the discount name, the name of a customer group it is
+     * scoped to, or the name of a product line it is scoped to. Customer portal users
+     * see only discounts with no customer-group restriction plus those scoped to a
+     * group their own account belongs to.
+     *
+     * This endpoint requires the permissions: `discounts:read`, `customers:read`,
+     * `suppliers:read`.
+     *
+     * @example
+     * ```ts
+     * const listVolumeDiscount =
+     *   await client.sales.volumeDiscounts.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/sales/volume-discounts', { query, ...options });
+    }
+    /**
+     * Returns a volume discount by ID.
+     *
+     * This endpoint requires the permissions: `discounts:read`, `customers:read`,
+     * `suppliers:read`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.retrieve(
+     *     'quds_bn7hto9s10pp',
+     *   );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get(path `/v1/sales/volume-discounts/${id}`, { query, ...options });
+    }
+    /**
+     * Creates a volume discount with its tiers and scoping associations.
+     *
+     * The discount name must be unique within the account; creating a discount with an
+     * existing name returns a conflict error.
+     *
+     * Each scoping list narrows the order lines the discount applies to, and an empty
+     * list places no restriction on that dimension. Because tier thresholds are
+     * compared against quantities converted into `unit_ids`, a discount created
+     * without any units never reaches a threshold above zero.
+     *
+     * This endpoint requires the permission: `discounts:create`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.create({
+     *     name: 'Bulk Order Discount',
+     *     tiers: [
+     *       {
+     *         name: '100+ Units',
+     *         discount_percentage:
+     *           '5.000000000000000000000000000000',
+     *         threshold: '100.000000000000000000000000000000',
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/sales/volume-discounts', { query: { include }, body, ...options });
+    }
+    /**
+     * Partially updates a volume discount.
+     *
+     * The tier and association lists are only applied when their corresponding `has_*`
+     * flag is `true`, in which case they replace the existing set entirely. Tiers use
+     * upsert semantics: tiers with an `id` are updated, tiers without one are created,
+     * and existing tiers omitted from the list are deleted.
+     *
+     * The name must remain unique within the account; reusing another discount's name
+     * returns a conflict error. Order lines that have already been priced keep the
+     * unit price they were given; the revised discount applies to lines priced after
+     * the change.
+     *
+     * This endpoint requires the permission: `discounts:update`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.update(
+     *     'quds_bn7hto9s10pp',
+     *     {
+     *       has_attributes: true,
+     *       has_categories: true,
+     *       has_customer_groups: true,
+     *       has_product_lines: true,
+     *       has_tiers: true,
+     *       has_units: true,
+     *       name: 'Updated Bulk Discount',
+     *       tiers: [
+     *         {
+     *           name: '50+ Units',
+     *           discount_percentage:
+     *             '10.000000000000000000000000000000',
+     *           threshold: '50.000000000000000000000000000000',
+     *         },
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    update(id, params, options) {
+        const { include, ...body } = params;
+        return this._client.patch(path `/v1/sales/volume-discounts/${id}`, {
+            query: { include },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Deletes a volume discount along with its tiers and scoping associations.
+     *
+     * Deletion is permanent; further requests against the deleted ID return an error.
+     *
+     * Order lines that have already been priced keep the unit price they were given;
+     * only lines priced after the deletion lose the discount.
+     *
+     * This endpoint requires the permission: `discounts:delete`.
+     *
+     * @example
+     * ```ts
+     * const volumeDiscount =
+     *   await client.sales.volumeDiscounts.delete(
+     *     'quds_bn7hto9s10pp',
+     *   );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/v1/sales/volume-discounts/${id}`, options);
+    }
+}
+//# sourceMappingURL=volume-discounts.mjs.map

package/resources/sales/volume-discounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume-discounts.mjs","sourceRoot":"","sources":["../../src/resources/sales/volume-discounts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OASf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,8BAA8B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,MAAM,CACJ,EAAU,EACV,MAAkC,EAClC,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,8BAA8B,EAAE,EAAE,EAAE;YAChE,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,8BAA8B,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/src/client.ts

@@ -722,7 +722,7 @@ export class Augno {
       {
         Accept: 'application/json',
         'User-Agent': this.getUserAgent(),
-        'Augno-Version': '1.0.forge-preview.2',
+        'Augno-Version': '1.0.forge-preview.3',
         'Augno-Account': this.augnoAccountID,
       },
       await this.authHeaders(options),

package/src/resources/catalog/item-categories/actions.ts

@@ -29,8 +29,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/item-categories/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/item-categories/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -97,9 +102,16 @@ export interface UpsertItemCategoryInput {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Item categories to create or update, matched by name within the account.
+   * Body param: Item categories to create or update, matched by name within the
+   * account.
    */
   item_categories: Array<UpsertItemCategoryInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/materials/actions.ts

@@ -29,8 +29,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/materials/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/materials/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -126,9 +131,15 @@ export interface UpsertMaterialProperty {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Materials to create or update, matched by SKU within the account.
+   * Body param: Materials to create or update, matched by SKU within the account.
    */
   materials: Array<UpsertMaterialInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/parts/actions.ts

@@ -28,8 +28,13 @@ export class Actions extends APIResource {
    * });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/parts/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/parts/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -114,9 +119,15 @@ export interface UpsertPartProperty {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Parts to create or update, matched by SKU within the account.
+   * Body param: Parts to create or update, matched by SKU within the account.
    */
   parts: Array<UpsertPartInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/product-lines/actions.ts

@@ -29,8 +29,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/product-lines/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/product-lines/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -83,9 +88,16 @@ export interface UpsertProductLineInput {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Product lines to create or update, matched by name within the account.
+   * Body param: Product lines to create or update, matched by name within the
+   * account.
    */
   product_lines: Array<UpsertProductLineInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/products/actions.ts

@@ -29,8 +29,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/products/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/products/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -133,9 +138,15 @@ export interface UpsertProductProperty {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Products to create or update, matched by SKU within the account.
+   * Body param: Products to create or update, matched by SKU within the account.
    */
   products: Array<UpsertProductInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/properties/actions.ts

@@ -27,8 +27,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/properties/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/properties/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -86,10 +91,16 @@ export interface UpsertPropertyInput {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Properties to create or update, matched by name (case-insensitive) within the
-   * account.
+   * Body param: Properties to create or update, matched by name (case-insensitive)
+   * within the account.
    */
   properties: Array<UpsertPropertyInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/unit-groups/actions.ts

@@ -33,8 +33,13 @@ export class Actions extends APIResource {
    *   });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/unit-groups/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/unit-groups/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -123,9 +128,15 @@ export interface UpsertUnitGroupInput {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Unit groups to create or update, matched by name within the account.
+   * Body param: Unit groups to create or update, matched by name within the account.
    */
   unit_groups: Array<UpsertUnitGroupInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {

package/src/resources/catalog/units/actions.ts

@@ -31,8 +31,13 @@ export class Actions extends APIResource {
    * });
    * ```
    */
-  bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
-    return this._client.post('/v1/catalog/units/actions/bulk-upsert', { body, ...options });
+  bulkUpsert(params: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/units/actions/bulk-upsert', {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -96,9 +101,16 @@ export interface UpsertUnitInput {
 
 export interface ActionBulkUpsertParams {
   /**
-   * Units to create or update, matched by name or abbreviation within the account.
+   * Body param: Units to create or update, matched by name or abbreviation within
+   * the account.
    */
   units: Array<UpsertUnitInput>;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<'created_by' | 'created_by.role'>;
 }
 
 export declare namespace Actions {