@dsptch-work/api-client 0.34.0 → 0.35.0

package/dist/gen/types.gen.d.ts

@@ -26,11 +26,11 @@ export type Problem = {
      */
     instance: string;
     /**
-     * Optional nonempty validation entries. Each item gives a readable detail and, when the server can prove a public body location, a pointer to it. Clients must accept entries without a pointer.
+     * Optional nonempty entries, one per refused field or value: validation failures, and other request-body refusals such as `subtype_foreign_keys`. Each item gives a readable detail and, when the server can prove a public body location, a pointer to it. Clients must accept entries without a pointer.
      */
     errors?: Array<{
         /**
-         * The validation message for this entry.
+         * The message for this entry.
          */
         detail: string;
         /**
@@ -335,7 +335,7 @@ export type Problem = {
  *
  * **Foreign Subtype Attributes**
  *
- * A nested-attributes write carries keys the record's resolved subtype does not accept. Send only the keys valid for that subtype; the message names the offending ones.
+ * A write carries keys the record's resolved subtype does not accept, whether nested or beside the record's own fields (a serial item's fields sent for a bulk item). Send only the keys valid for that subtype; the message names the offending ones, and each one's entry in `errors` points at it. Nothing is written.
  *
  * ### synced_determination
  *
@@ -768,6 +768,10 @@ export type CompetencyCriterionResponseObject = {
      * Guidance on what evidence satisfies the criterion; null when unset.
      */
     evidence_note: string | null;
+    /**
+     * Suggested assessment method for this criterion; null when unset. An assessment does not have to use it.
+     */
+    assessment_method: 'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other' | null;
     /**
      * When the criterion was created.
      */
@@ -793,6 +797,10 @@ export type CompetencyCriterionParameters = {
      * Guidance on what evidence satisfies the criterion; optional, null to clear.
      */
     evidence_note?: string | null;
+    /**
+     * Suggested assessment method; optional, null to clear.
+     */
+    assessment_method?: 'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other' | null;
 };
 /**
  * Swap a draft catalog row with its neighbor. The row cannot move past either end of the list.
@@ -2844,10 +2852,6 @@ export type AssetsProductResponseObject = {
  * Create a catalog product. `type` (serial or bulk) is required and immutable. `attribute_values` upserts the product's category-attribute values.
  */
 export type AssetsProductParameters = {
-    /**
-     * Product kind, set on create and immutable: serial (individually tracked) or bulk (quantity-counted).
-     */
-    type: 'serial' | 'bulk';
     /**
      * Human-readable product name.
      */
@@ -2857,9 +2861,13 @@ export type AssetsProductParameters = {
      */
     description?: string | null;
     /**
-     * ID of the category classifying this product; null when uncategorized.
+     * Manufacturer or brand; required when model is given. Null when not set.
      */
-    assets_category_id?: string | null;
+    make?: string | null;
+    /**
+     * Model name or number; unique per manufacturer within the company. Null when not set.
+     */
+    model?: string | null;
     /**
      * Universal Product Code; unique within the company. Null when not set.
      */
@@ -2872,24 +2880,20 @@ export type AssetsProductParameters = {
      * Default low-stock reorder threshold for this product's items, applied across sites unless a site overrides it. Null when not set.
      */
     default_minimum_quantity?: number | null;
-    /**
-     * Manufacturer or brand; required when model is given. Null when not set.
-     */
-    make?: string | null;
-    /**
-     * Model name or number; unique per manufacturer within the company. Null when not set.
-     */
-    model?: string | null;
     /**
      * Unit of measure for counting a bulk product's inventory: one of each, pair, or pack. A serial product is always counted each.
      */
     counted_by?: 'each' | 'pair' | 'pack';
+    /**
+     * ID of the category classifying this product; null when uncategorized.
+     */
+    assets_category_id?: string | null;
     /**
      * Optional. Flag the product as a container whose items can hold other items (a toolbox or gang box). Only serialized products may be containers.
      */
     container?: boolean;
     /**
-     * Upserts the values of this product's category attributes, one entry per attribute. Send a blank value and null assets_attribute_option_id to clear one.
+     * Upserts the values of this product's category attributes, as a list of row objects, one per attribute. Each row requires its assets_attribute_id; a row without one answers 400, and a blank one 422. Send a blank value and null assets_attribute_option_id to clear one. A value is a string or null; any other JSON type, or an unknown row field, answers 422 at that row.
      */
     attribute_values?: Array<{
         /**
@@ -2906,9 +2910,26 @@ export type AssetsProductParameters = {
         assets_attribute_option_id?: string | null;
     }>;
     /**
-     * Image attachments. Send file with a signed_id to add one; include id with _destroy to remove an existing one.
+     * Image attachments, as a list of row objects. Send file with a signed_id to add one; include id with _destroy to remove an existing one. An unknown or wrongly typed row field answers 422 at that row.
+     */
+    images_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.products`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
+    /**
+     * Product kind, set on create and immutable: serial (individually tracked) or bulk (quantity-counted).
      */
-    images_attributes?: Array<AssetsAttachmentParameters>;
+    type: 'serial' | 'bulk';
     /**
      * ID of the user this write is performed on behalf of, recorded for auditing. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
@@ -2927,9 +2948,13 @@ export type AssetsProductUpdateParameters = {
      */
     description?: string | null;
     /**
-     * ID of the category classifying this product; null when uncategorized.
+     * Manufacturer or brand; required when model is given. Null when not set.
      */
-    assets_category_id?: string | null;
+    make?: string | null;
+    /**
+     * Model name or number; unique per manufacturer within the company. Null when not set.
+     */
+    model?: string | null;
     /**
      * Universal Product Code; unique within the company. Null when not set.
      */
@@ -2942,24 +2967,20 @@ export type AssetsProductUpdateParameters = {
      * Default low-stock reorder threshold for this product's items, applied across sites unless a site overrides it. Null when not set.
      */
     default_minimum_quantity?: number | null;
-    /**
-     * Manufacturer or brand; required when model is given. Null when not set.
-     */
-    make?: string | null;
-    /**
-     * Model name or number; unique per manufacturer within the company. Null when not set.
-     */
-    model?: string | null;
     /**
      * Unit of measure for counting a bulk product's inventory: one of each, pair, or pack. A serial product is always counted each.
      */
     counted_by?: 'each' | 'pair' | 'pack';
+    /**
+     * ID of the category classifying this product; null when uncategorized.
+     */
+    assets_category_id?: string | null;
     /**
      * Optional. Flag the product as a container whose items can hold other items (a toolbox or gang box). Only serialized products may be containers.
      */
     container?: boolean;
     /**
-     * Upserts the values of this product's category attributes, one entry per attribute. Send a blank value and null assets_attribute_option_id to clear one.
+     * Upserts the values of this product's category attributes, as a list of row objects, one per attribute. Each row requires its assets_attribute_id; a row without one answers 400, and a blank one 422. Send a blank value and null assets_attribute_option_id to clear one. A value is a string or null; any other JSON type, or an unknown row field, answers 422 at that row.
      */
     attribute_values?: Array<{
         /**
@@ -2976,9 +2997,22 @@ export type AssetsProductUpdateParameters = {
         assets_attribute_option_id?: string | null;
     }>;
     /**
-     * Image attachments. Send file with a signed_id to add one; include id with _destroy to remove an existing one.
+     * Image attachments, as a list of row objects. Send file with a signed_id to add one; include id with _destroy to remove an existing one. An unknown or wrongly typed row field answers 422 at that row.
      */
-    images_attributes?: Array<AssetsAttachmentParameters>;
+    images_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.products`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
 };
 /**
  * A named daily allowance (meals, lodging, travel, and the like) that a company can attach to time.
@@ -3305,7 +3339,7 @@ export type AssetsCategoryResponseObject = {
     updated_at: string;
 };
 /**
- * Create or update a category; only name is required. `category_attributes` sets this category's direct attribute assignments.
+ * Create a category. Only name is required; omitting it answers 400, and a blank or null name or any wrong-typed value answers 422. A null or blank parent_id files the category at the root. `category_attributes` sets this category's direct attribute assignments.
  */
 export type AssetsCategoryParameters = {
     /**
@@ -3317,7 +3351,7 @@ export type AssetsCategoryParameters = {
      */
     parent_id?: string | null;
     /**
-     * Attribute assignments for this category. Include id to update an existing assignment, omit id to add one, or set _destroy to remove one.
+     * Attribute assignments for this category, as a list of row objects. Include id to update an existing assignment, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     category_attributes?: Array<{
         /**
@@ -3327,11 +3361,11 @@ export type AssetsCategoryParameters = {
         /**
          * ID of the attribute definition.
          */
-        assets_attribute_id: string;
+        assets_attribute_id?: string;
         /**
          * Where this attribute is filled in for the category: product (on the catalog product) or item (on each individual item).
          */
-        fillable_on: 'product' | 'item';
+        fillable_on?: 'product' | 'item';
         /**
          * Whether a value for this attribute must be provided.
          */
@@ -3347,7 +3381,7 @@ export type AssetsCategoryParameters = {
     }>;
 };
 /**
- * Update a category. All fields are optional — send only what changes. `category_attributes` sets this category's direct attribute assignments.
+ * Update a category. All fields are optional — send only what changes. A blank or null name or any wrong-typed value answers 422, and a null or blank parent_id moves the category to the root. `category_attributes` sets this category's direct attribute assignments.
  */
 export type AssetsCategoryUpdateParameters = {
     /**
@@ -3359,7 +3393,7 @@ export type AssetsCategoryUpdateParameters = {
      */
     parent_id?: string | null;
     /**
-     * Attribute assignments for this category. Include id to update an existing assignment, omit id to add one, or set _destroy to remove one.
+     * Attribute assignments for this category, as a list of row objects. Include id to update an existing assignment, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     category_attributes?: Array<{
         /**
@@ -3369,11 +3403,11 @@ export type AssetsCategoryUpdateParameters = {
         /**
          * ID of the attribute definition.
          */
-        assets_attribute_id: string;
+        assets_attribute_id?: string;
         /**
          * Where this attribute is filled in for the category: product (on the catalog product) or item (on each individual item).
          */
-        fillable_on: 'product' | 'item';
+        fillable_on?: 'product' | 'item';
         /**
          * Whether a value for this attribute must be provided.
          */
@@ -10454,75 +10488,65 @@ export type ProductionJobScopePriceResponseObject = {
     updated_at: string;
 };
 /**
- * A completion's payload shape follows the production tracking kind of the scope price's job — the server derives the completable subtype from the job, never from the request. Feature-tracked jobs record which feature was completed (feature payload); quantity-tracked jobs record how many units were completed (quantity payload). The two payloads are mutually exclusive: sending the other kind's completable key returns 422.
- */
-export type ProductionCompletionParameters = ProductionFeatureCompletionParameters | ProductionQuantityCompletionParameters;
-/**
- * Update a completion. Send only the fields to change. The scope price, filer, and feature reference are fixed at creation. Sending production_job_scope_price_id or performed_by_user_id on update returns 400 unknown_key. Feature completions accept no completable changes; quantity completions accept quantity_completed. A key for the other subtype returns 422.
+ * Record a completion against a scope price. The server takes the completable subtype from the production tracking kind of the scope price's job, never from the request: a feature-tracked job records which feature was completed, and a quantity-tracked job how many units were completed. completable_attributes declares both kinds' keys; sending the other kind's key answers 422 subtype_foreign_keys with an entry pointing at it, and nothing is written.
  */
-export type ProductionCompletionUpdateParameters = {
+export type ProductionCompletionParameters = {
     /**
-     * Free-text notes; omit to preserve them, or send null to clear them.
+     * Scope price the work bills against; set on create only, and it determines the job. Omission answers 400; null, a blank ID, or a wrong type answers 422; a scope price the API key cannot see answers 404.
+     */
+    production_job_scope_price_id: string;
+    /**
+     * ID of the company member filing the completion. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
+     */
+    performed_by_user_id: string;
+    /**
+     * Free-text notes on the completion; null when none.
      */
     notes?: string | null;
     /**
-     * Date the work was performed (YYYY-MM-DD); omit to preserve it.
+     * Date the work was performed (YYYY-MM-DD). Omit it to file the completion on today's date in the job's time zone; null or a value that is not a calendar date answers 422.
      */
     work_date?: string;
     /**
-     * Unique nonblank IDs of the job positions that performed the work. Omit to preserve the crew; a supplied list replaces it and must retain at least one position. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     * Unique nonblank IDs of the job positions that performed the work (the crew). At least one is required. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
      */
     position_ids?: Array<string>;
+    /**
+     * The completion's subtype fields, whose kind follows the job's production tracking kind. A string, array, or null answers 422; an unknown key inside answers 422 at its pointer.
+     */
     completable_attributes?: {
         /**
-         * Number of units completed, for quantity completions only. Omit to preserve it.
+         * Feature the work completed, for a feature-tracked job; required there, and immutable after create.
+         */
+        feature_id?: string;
+        /**
+         * Number of units completed, a positive integer, for a quantity-tracked job; required there.
          */
         quantity_completed?: number;
     };
 };
 /**
- * Fields shared by both completion payload kinds.
+ * Update a completion. Send only the fields to change. The scope price, filer, and feature reference are fixed at creation. Sending production_job_scope_price_id or performed_by_user_id on update returns 400 unknown_key. Feature completions accept no completable changes, so quantity_completed on one answers 422 subtype_foreign_keys with an entry pointing at it; quantity completions accept quantity_completed.
  */
-export type ProductionCompletionBaseParameters = {
-    /**
-     * Scope price the work bills against; set on create only, and it determines the job. Omission answers 400; a scope price the API key cannot see answers 404.
-     */
-    production_job_scope_price_id: string;
-    /**
-     * ID of the company member filing the completion. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
-     */
-    performed_by_user_id: string;
+export type ProductionCompletionUpdateParameters = {
     /**
-     * Free-text notes on the completion; null when none.
+     * Free-text notes; omit to preserve them, or send null to clear them.
      */
     notes?: string | null;
     /**
-     * Date the work was performed (YYYY-MM-DD); defaults to today in the job's time zone.
+     * Date the work was performed (YYYY-MM-DD); omit to preserve it. Null or a value that is not a calendar date answers 422.
      */
     work_date?: string;
     /**
-     * Unique nonblank IDs of the job positions that performed the work (the crew). At least one is required; on update the list replaces the crew. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     * Unique nonblank IDs of the job positions that performed the work. Omit to preserve the crew; a supplied list replaces it and must retain at least one position. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
      */
     position_ids?: Array<string>;
-};
-/**
- * Payload for completions on feature-tracked jobs (the scope price's job tracks production by feature). quantity_completed is not accepted; the feature reference is immutable after create, so update accepts no completable_attributes at all.
- */
-export type ProductionFeatureCompletionParameters = ProductionCompletionBaseParameters & {
-    completable_attributes?: {
-        /**
-         * Feature the work completed; required on create, immutable after.
-         */
-        feature_id?: string;
-    };
-};
-/**
- * Payload for completions on quantity-tracked jobs (the scope price's job tracks production by quantity). feature_id is not accepted.
- */
-export type ProductionQuantityCompletionParameters = ProductionCompletionBaseParameters & {
+    /**
+     * The completion's subtype fields. A string, array, or null answers 422; any key but quantity_completed, feature_id included, answers 422 at its pointer.
+     */
     completable_attributes?: {
         /**
-         * Number of units completed.
+         * Number of units completed, a positive integer, for quantity completions only. Omit to preserve it.
          */
         quantity_completed?: number;
     };
@@ -12711,29 +12735,53 @@ export type PayRatesRuleResponseObject = {
  * Parameters for creating a conditional wage or fringe adjustment in a pay-rate rule package.
  */
 export type PayRatesRuleParameters = {
-    effect: RateRuleEffect;
-    /**
-     * Match conditions for the rule. Omit or send an empty list for an unconditional rule.
-     */
-    conditions?: Array<RateRuleCondition>;
     /**
      * Calendar date when the rule begins in the package's timezone, which is that of the project or job holding the package, else its company's; defaults to today there.
      */
     effective_date?: string;
+    /**
+     * The adjustment applied when a rule matches — an addition to the wage or fringe rate.
+     */
+    effect: {
+        /**
+         * Which base rate the effect adds to: `wage_increment` the hourly wage rate, `fringe_increment` the fringe rate.
+         */
+        type: 'wage_increment' | 'fringe_increment';
+        /**
+         * Amount added to the base rate, in whole cents as a decimal string (e.g. "300" is $3.00). Zero or positive; fractional input is truncated.
+         */
+        amount_cents: string;
+    };
+    /**
+     * Match conditions for the rule. Omit or send an empty list for an unconditional rule.
+     */
+    conditions?: Array<RateRuleTimeRangeCondition | RateRuleDaysCondition | RateRuleSpecificDateCondition | RateRuleApprenticePeriodCondition | RateRuleApprenticeHoursCondition | RateRuleOvertimeMultiplierCondition>;
 };
 /**
  * Change a rule from an effective date forward. Omitted effect or conditions keep that part of the targeted version. When the targeted recipe changes, the resulting complete recipe applies from that coordinate across later scheduled versions; an unchanged recipe does not alter later scheduled versions. An empty conditions list makes the rule unconditional. Omit effective_from to correct the selected version from its exact existing start. A rule with an unbounded lower limit requires effective_from.
  */
 export type PayRatesRuleUpdateParameters = {
-    effect?: RateRuleEffect;
-    /**
-     * Replacement match conditions. Omit this field to keep the targeted version's conditions; send an empty list to make the rule unconditional.
-     */
-    conditions?: Array<RateRuleCondition>;
     /**
      * Date the change begins, YYYY-MM-DD. Omit it to correct the selected version from its exact existing start. Required when that version has no lower bound.
      */
     effective_from?: string;
+    /**
+     * The adjustment applied when a rule matches — an addition to the wage or fringe rate.
+     */
+    effect?: {
+        /**
+         * Which base rate the effect adds to: `wage_increment` the hourly wage rate, `fringe_increment` the fringe rate.
+         */
+        type: 'wage_increment' | 'fringe_increment';
+        /**
+         * Amount added to the base rate, in whole cents as a decimal string (e.g. "300" is $3.00). Zero or positive; fractional input is truncated.
+         */
+        amount_cents: string;
+    };
+    /**
+     * Replacement match conditions. Omit this field to keep the targeted version's conditions; send an empty list to make the rule unconditional.
+     */
+    conditions?: Array<RateRuleTimeRangeCondition | RateRuleDaysCondition | RateRuleSpecificDateCondition | RateRuleApprenticePeriodCondition | RateRuleApprenticeHoursCondition | RateRuleOvertimeMultiplierCondition>;
 };
 /**
  * Parameters for moving where a pay-rate rule family's valid-time timeline begins.
@@ -12761,11 +12809,23 @@ export type PayRatesRuleScheduledChangeParameters = {
      * Date the change begins, YYYY-MM-DD.
      */
     effective_date: string;
-    effect?: RateRuleEffect;
+    /**
+     * The adjustment applied when a rule matches — an addition to the wage or fringe rate.
+     */
+    effect?: {
+        /**
+         * Which base rate the effect adds to: `wage_increment` the hourly wage rate, `fringe_increment` the fringe rate.
+         */
+        type: 'wage_increment' | 'fringe_increment';
+        /**
+         * Amount added to the base rate, in whole cents as a decimal string (e.g. "300" is $3.00). Zero or positive; fractional input is truncated.
+         */
+        amount_cents: string;
+    };
     /**
      * Replacement match conditions. Omit this field to keep the targeted version's conditions; send an empty list to make the rule unconditional.
      */
-    conditions?: Array<RateRuleCondition>;
+    conditions?: Array<RateRuleTimeRangeCondition | RateRuleDaysCondition | RateRuleSpecificDateCondition | RateRuleApprenticePeriodCondition | RateRuleApprenticeHoursCondition | RateRuleOvertimeMultiplierCondition>;
 };
 export type PayRatesRuleHistoryCorrectionObject = {
     /**
@@ -13011,11 +13071,23 @@ export type RateRuleParameters = {
      * Date the rule takes effect, YYYY-MM-DD. Defaults to today. Cannot predate the earliest wage determination the rule's package applies to.
      */
     effective_date?: string | null;
-    effect: RateRuleEffect;
+    /**
+     * The adjustment applied when a rule matches — an addition to the wage or fringe rate.
+     */
+    effect: {
+        /**
+         * Which base rate the effect adds to: `wage_increment` the hourly wage rate, `fringe_increment` the fringe rate.
+         */
+        type: 'wage_increment' | 'fringe_increment';
+        /**
+         * Amount added to the base rate, in whole cents as a decimal string (e.g. "300" is $3.00). Zero or positive; fractional input is truncated.
+         */
+        amount_cents: string;
+    };
     /**
      * Match conditions for the rule; optional. Omit or send an empty list for a rule that always applies. At most one condition per category (time, day-selection, apprentice, overtime).
      */
-    conditions?: Array<RateRuleCondition>;
+    conditions?: Array<RateRuleTimeRangeCondition | RateRuleDaysCondition | RateRuleSpecificDateCondition | RateRuleApprenticePeriodCondition | RateRuleApprenticeHoursCondition | RateRuleOvertimeMultiplierCondition>;
 };
 /**
  * A tracked physical asset owned by a company and typed by a product — either an individually-tracked serial unit or a quantity-tracked bulk stock record. The serial-only fields (serial_number, status, purchase_date, purchase_price_cents, currency, external_id, external_system_url) are null on a bulk item.
@@ -13132,7 +13204,7 @@ export type AssetsItemParameters = {
     /**
      * Free-text description of the item.
      */
-    description?: string;
+    description?: string | null;
     /**
      * ID of the product this item is an instance of.
      */
@@ -13140,7 +13212,7 @@ export type AssetsItemParameters = {
     /**
      * Serial number identifying the individual physical unit; unique within its product.
      */
-    serial_number: string;
+    serial_number?: string | null;
     /**
      * Placement status of the item: available, or assigned when held by a user.
      */
@@ -13148,21 +13220,21 @@ export type AssetsItemParameters = {
     /**
      * When the item was purchased (ISO 8601).
      */
-    purchase_date?: string;
+    purchase_date?: string | null;
     /**
      * Purchase price in cents, in the item's currency.
      */
-    purchase_price_cents?: number;
+    purchase_price_cents?: number | null;
     /**
      * Identifier for this item in an external system.
      */
-    external_id?: string;
+    external_id?: string | null;
     /**
      * URL to this item in an external system.
      */
-    external_system_url?: string;
+    external_system_url?: string | null;
     /**
-     * Upserts the values of the item-level attributes of the product's category, one entry per attribute. Send a blank value and null assets_attribute_option_id to clear one.
+     * Upserts the values of the item-level attributes of the product's category, as a list of row objects, one per attribute. Each row requires its assets_attribute_id; a row without one answers 400, and a blank one 422. Send a blank value and null assets_attribute_option_id to clear one. A value is a string or null; any other JSON type, or an unknown row field, answers 422 at that row.
      */
     attribute_values?: Array<{
         /**
@@ -13179,32 +13251,45 @@ export type AssetsItemParameters = {
         assets_attribute_option_id?: string | null;
     }>;
     /**
-     * Image attachments. Send file with a signed_id to add one; include id with _destroy to remove an existing one.
+     * Image attachments, as a list of row objects. Send file with a signed_id to add one; include id with _destroy to remove an existing one. An unknown or wrongly typed row field answers 422 at that row.
+     */
+    images_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.items`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
+    /**
+     * ID of the user this write is performed on behalf of — recorded as the item's creator or updater and attributed to any placement. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
-    images_attributes?: Array<AssetsAttachmentParameters>;
+    performed_by_user_id: string;
     /**
      * Optional, create only. Stock the new item at this site, recording a receive transaction. Mutually exclusive with user_id and container_item_id.
      */
-    assets_site_id?: string;
+    assets_site_id?: string | null;
     /**
      * Optional, create only. Assign the new item to this user. Mutually exclusive with assets_site_id and container_item_id.
      */
-    user_id?: string;
+    user_id?: string | null;
     /**
      * Optional, create only. Place the new item inside this container item. Mutually exclusive with assets_site_id and user_id.
      */
-    container_item_id?: string;
+    container_item_id?: string | null;
     /**
      * Optional, create only. The storage location within the placement site or container the item lands in; must belong to that holder. Omit for an unbinned placement. Ignored for a user assignment.
      */
-    assets_sub_location_id?: string;
-    /**
-     * ID of the user this write is performed on behalf of — recorded as the item's creator or updater and attributed to any placement. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
-     */
-    performed_by_user_id: string;
+    assets_sub_location_id?: string | null;
 };
 /**
- * Update an asset item. All item fields are optional — send only what changes — but performed_by_user_id is required to record the updater. Omitted attributes retain their existing values. `attribute_values` upserts the item-level attributes of the product's category.
+ * Update an asset item. All item fields are optional — send only what changes — but performed_by_user_id is required to record the updater. Omitted attributes retain their existing values. `attribute_values` upserts the item-level attributes of the product's category. The serial-only fields (serial_number, status, purchase_date, purchase_price_cents, external_id, external_system_url) apply to a serial item; sending one for a bulk item answers 422 subtype_foreign_keys with an entry pointing at each such field, and nothing is written.
  */
 export type AssetsItemUpdateParameters = {
     /**
@@ -13214,7 +13299,7 @@ export type AssetsItemUpdateParameters = {
     /**
      * Free-text description of the item.
      */
-    description?: string;
+    description?: string | null;
     /**
      * ID of the product this item is an instance of.
      */
@@ -13222,7 +13307,7 @@ export type AssetsItemUpdateParameters = {
     /**
      * Serial number identifying the individual physical unit; unique within its product.
      */
-    serial_number?: string;
+    serial_number?: string | null;
     /**
      * Placement status of the item: available, or assigned when held by a user.
      */
@@ -13230,21 +13315,21 @@ export type AssetsItemUpdateParameters = {
     /**
      * When the item was purchased (ISO 8601).
      */
-    purchase_date?: string;
+    purchase_date?: string | null;
     /**
      * Purchase price in cents, in the item's currency.
      */
-    purchase_price_cents?: number;
+    purchase_price_cents?: number | null;
     /**
      * Identifier for this item in an external system.
      */
-    external_id?: string;
+    external_id?: string | null;
     /**
      * URL to this item in an external system.
      */
-    external_system_url?: string;
+    external_system_url?: string | null;
     /**
-     * Upserts the values of the item-level attributes of the product's category, one entry per attribute. Send a blank value and null assets_attribute_option_id to clear one.
+     * Upserts the values of the item-level attributes of the product's category, as a list of row objects, one per attribute. Each row requires its assets_attribute_id; a row without one answers 400, and a blank one 422. Send a blank value and null assets_attribute_option_id to clear one. A value is a string or null; any other JSON type, or an unknown row field, answers 422 at that row.
      */
     attribute_values?: Array<{
         /**
@@ -13261,9 +13346,22 @@ export type AssetsItemUpdateParameters = {
         assets_attribute_option_id?: string | null;
     }>;
     /**
-     * Image attachments. Send file with a signed_id to add one; include id with _destroy to remove an existing one.
+     * Image attachments, as a list of row objects. Send file with a signed_id to add one; include id with _destroy to remove an existing one. An unknown or wrongly typed row field answers 422 at that row.
      */
-    images_attributes?: Array<AssetsAttachmentParameters>;
+    images_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.items`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
     /**
      * ID of the user this update is performed on behalf of, recorded as updater. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
@@ -13608,23 +13706,6 @@ export type AssetsAttachmentResponseObject = {
      */
     updated_at: string;
 };
-/**
- * One attachment in a nested collection. Send file with a signed_id to add one; send id (with _destroy) to remove an existing one.
- */
-export type AssetsAttachmentParameters = {
-    /**
-     * ID of an existing attachment to remove; omit to add a new one.
-     */
-    id?: string;
-    /**
-     * A signed_id from POST /api/v1/direct_uploads identifying the uploaded blob to attach. Register the upload naming the resource of the endpoint you are calling — `assets.items` for item images, `assets.products` for product images, `assets.items.service_events` for service event attachments — because a signed_id issued for any other resource will not resolve here.
-     */
-    file?: string;
-    /**
-     * Set true to remove the attachment named by id.
-     */
-    _destroy?: boolean;
-};
 /**
  * A file attached to an asset item — a document such as a manual, warranty, or certificate. Uploaded through the direct-upload flow and optionally marked as a certified copy.
  */
@@ -14317,13 +14398,26 @@ export type AssetsServiceEventParameters = {
      */
     assets_service_schedule_id?: string | null;
     /**
-     * ID of the user who performed the service. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
+     * Document attachments for the service, as a list of row objects. Send file with a signed_id to add one. An unknown or wrongly typed row field answers 422 at that row.
      */
-    performed_by_user_id: string;
+    attachments_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.items.service_events`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
     /**
-     * Document attachments for the service. On update, set _destroy with an id to remove an existing one; omit id to add a new one.
+     * ID of the user who performed the service. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
-    attachments_attributes?: Array<AssetsAttachmentParameters>;
+    performed_by_user_id: string;
 };
 /**
  * Update a service event. Event fields are optional — send only what changes — but performed_by_user_id is required to record the updater. A linked schedule dictates kind, and changing or removing the link recomputes affected due dates.
@@ -14346,13 +14440,26 @@ export type AssetsServiceEventUpdateParameters = {
      */
     assets_service_schedule_id?: string | null;
     /**
-     * ID of the user this update is performed on behalf of. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
+     * Document attachments for the service, as a list of row objects. Set _destroy with an id to remove an existing one; omit id to add a new one. An unknown or wrongly typed row field answers 422 at that row.
      */
-    performed_by_user_id: string;
+    attachments_attributes?: Array<{
+        /**
+         * ID of an existing attachment to remove; omit to add a new one.
+         */
+        id?: string;
+        /**
+         * A signed_id from POST /api/v1/direct_uploads registered for `assets.items.service_events`; a signed_id issued for any other resource answers 422.
+         */
+        file?: string;
+        /**
+         * Set true to remove the attachment named by id.
+         */
+        _destroy?: boolean;
+    }>;
     /**
-     * Document attachments for the service. Set _destroy with an id to remove an existing one; omit id to add a new one.
+     * ID of the user this update is performed on behalf of. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
-    attachments_attributes?: Array<AssetsAttachmentParameters>;
+    performed_by_user_id: string;
 };
 /**
  * A product-level service cadence that seeds and syncs the matching schedules on that product's items. Changing its defining fields (name, kind, interval) reconciles linked item schedules in the background.
@@ -16873,7 +16980,7 @@ export type UpdateItemErrors = {
      */
     404: Problem;
     /**
-     * Unprocessable Content
+     * Unprocessable Content (malformed row)
      */
     422: Problem;
 };
@@ -17827,7 +17934,7 @@ export type UpdateProductErrors = {
      */
     404: Problem;
     /**
-     * Unprocessable Content
+     * Unprocessable Content (malformed row)
      */
     422: Problem;
 };