@dsptch-work/api-client 0.34.0 → 0.36.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
  *
@@ -413,7 +413,7 @@ export type DirectUploadParameters = {
     /**
      * What the file is for, named as the endpoint that will attach it (for example `assets.vendors`). Required. It decides where the file is stored, and the signed ID this call returns is issued for that resource alone — it will not resolve at any other endpoint, so a vendor logo cannot be attached as an avatar, or an avatar as a logo.
      */
-    resource: 'assets.items' | 'assets.items.documents' | 'assets.items.service_events' | 'assets.products' | 'assets.vendors' | 'compliance.checks' | 'internal.companies' | 'internal.company_todos' | 'internal.job_todos' | 'internal.project_todos' | 'pay_periods.imports.aggregate_times' | 'pay_periods.imports.dsptch_cprs' | 'pay_periods.imports.time_entries' | 'payrolls.payroll_runs.imports.paystubs' | 'payrolls.payroll_runs.imports.wide_paystubs' | 'users';
+    resource: 'assets.items' | 'assets.items.documents' | 'assets.items.service_events' | 'assets.products' | 'assets.vendors' | 'compliance.checks' | 'internal.companies' | 'internal.company_todos' | 'internal.job_todos' | 'internal.project_todos' | 'pay_periods.imports.aggregate_times' | 'pay_periods.imports.dsptch_cprs' | 'pay_periods.imports.time_entries' | 'payrolls.payroll_runs.imports.paystubs' | 'payrolls.payroll_runs.imports.wide_paystubs' | 'projects.documents' | 'users';
     /**
      * Metadata describing the file being registered, before its bytes are uploaded.
      */
@@ -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.
@@ -1698,7 +1706,7 @@ export type ApprenticeshipProgramEmployerUpdateParameters = {
     require_timecard_allocation?: boolean;
 };
 /**
- * Create a period on a wage schedule; the wage schedule is taken from the URL path. wage_cents and fringe_cents are sent as integer cents.
+ * Create a period on a wage schedule; the wage schedule is taken from the URL path. wage_cents and fringe_cents are sent as integer cents. Omitting period_number, wage_percent, or wage_cents answers 400. A wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those leaves it unset, but a period with none of min_minutes, max_minutes, or num_competencies answers 422.
  */
 export type ApprenticeshipWageSchedulePeriodParameters = {
     /**
@@ -1739,7 +1747,7 @@ export type ApprenticeshipWageSchedulePeriodParameters = {
     fringe_cents?: number | null;
 };
 /**
- * Update a period on a wage schedule. Send only the fields to change; the wage schedule is taken from the URL path, and wage_cents and fringe_cents are sent as integer cents.
+ * Update a period on a wage schedule. Send only the fields to change; the wage schedule is taken from the URL path, and wage_cents and fringe_cents are sent as integer cents. A wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those clears it, but a period left with none of min_minutes, max_minutes, or num_competencies answers 422.
  */
 export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
     /**
@@ -1747,15 +1755,15 @@ export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
      */
     period_number?: number;
     /**
-     * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     min_minutes?: number | null;
     /**
-     * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     max_minutes?: number | null;
     /**
-     * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     num_competencies?: number | null;
     /**
@@ -1780,7 +1788,7 @@ export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
     fringe_cents?: number | null;
 };
 /**
- * Create a wage schedule for an occupation; the occupation is taken from the URL path. Money is sent as integer cents; periods may be created inline via periods_attributes.
+ * Create a wage schedule for an occupation; the occupation is taken from the URL path. Money is sent as integer cents; periods may be created inline via periods_attributes. Omitting name, wage_unit, journeyworker_wage_unit, or period_unit answers 400. A blank name, a unit outside its listed values, a wrong JSON type, or a null for any field but description and journeyworker_fringe_cents answers 422; a null in either of those leaves the field unset.
  */
 export type ApprenticeshipWageScheduleParameters = {
     /**
@@ -1816,7 +1824,7 @@ export type ApprenticeshipWageScheduleParameters = {
      */
     end_wage_cents?: number;
     /**
-     * Periods to create, update, or remove alongside the schedule; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; optional.
+     * Periods to create, update, or remove alongside the schedule, as a list of row objects; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; optional. In a row, an unknown key, a wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those leaves it unset, but a period with none of min_minutes, max_minutes, or num_competencies answers 422.
      */
     periods_attributes?: Array<{
         /**
@@ -1826,7 +1834,7 @@ export type ApprenticeshipWageScheduleParameters = {
         /**
          * 0-indexed position of this period in the progression. Required.
          */
-        period_number: number;
+        period_number?: number;
         /**
          * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; optional, but at least one of min_minutes, max_minutes, or num_competencies must be set; null to clear.
          */
@@ -1846,11 +1854,11 @@ export type ApprenticeshipWageScheduleParameters = {
         /**
          * Percentage of the journeyworker wage paid during this period (e.g. 75 for 75%). Required.
          */
-        wage_percent: number;
+        wage_percent?: number;
         /**
          * Wage rate for this period, in cents; denominated in the parent schedule's wage_unit. Required.
          */
-        wage_cents: number;
+        wage_cents?: number;
         /**
          * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges (e.g. 70 for 70%); optional, omit or send null when the period does not list fringe as a percentage. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
          */
@@ -1866,7 +1874,7 @@ export type ApprenticeshipWageScheduleParameters = {
     }>;
 };
 /**
- * Update a wage schedule for an occupation. Send only the fields to change; money is sent as integer cents and periods may be created, updated, or removed inline via periods_attributes.
+ * Update a wage schedule for an occupation. Send only the fields to change; money is sent as integer cents and periods may be created, updated, or removed inline via periods_attributes. A blank name, a unit outside its listed values, a wrong JSON type, or a null for any field but description and journeyworker_fringe_cents answers 422; a null in either of those clears the field.
  */
 export type ApprenticeshipWageScheduleUpdateParameters = {
     /**
@@ -1902,17 +1910,9 @@ export type ApprenticeshipWageScheduleUpdateParameters = {
      */
     end_wage_cents?: number;
     /**
-     * Periods to create, update, or remove alongside the schedule; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it.
+     * Periods to create, update, or remove alongside the schedule, as a list of row objects; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; omit the list to leave every period unchanged. In a row, an unknown key, a wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those clears it, but a period left with none of min_minutes, max_minutes, or num_competencies answers 422.
      */
-    periods_attributes?: Array<(unknown | {
-        min_minutes: number;
-    } | {
-        max_minutes: number;
-    } | {
-        num_competencies: number;
-    } | {
-        _destroy: true;
-    }) & {
+    periods_attributes?: Array<{
         /**
          * Unique identifier.
          */
@@ -1922,15 +1922,15 @@ export type ApprenticeshipWageScheduleUpdateParameters = {
          */
         period_number?: number;
         /**
-         * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         min_minutes?: number | null;
         /**
-         * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         max_minutes?: number | null;
         /**
-         * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         num_competencies?: number | null;
         /**
@@ -2545,6 +2545,10 @@ export type TimecodeHistoryVersionObject = {
  * Request body for creating or updating a timecode; only `name` is required. On create, omitted fields take their model/DB defaults (noted per field). On update the request applies a bitemporal correction, so omitted fields keep the current version's values rather than reverting to defaults.
  */
 export type TimecodeParameters = {
+    /**
+     * When the new timecode becomes effective. Defaults to the time of the request. Accepted on create only.
+     */
+    effective_date?: string;
     /**
      * Human-readable name of the timecode. Required; must be unique within the company.
      */
@@ -2605,10 +2609,6 @@ export type TimecodeParameters = {
      * Where the timecode may be applied: none, job, non_job, or job_with_timecode. Defaults to none on create.
      */
     restricted_to?: 'none' | 'job' | 'non_job' | 'job_with_timecode';
-    /**
-     * When the new timecode becomes effective. Defaults to the time of the request. Accepted on create only.
-     */
-    effective_date?: string;
 };
 /**
  * Request body for correcting a timecode over a valid-time span. Send only the fields to change; omitted fields retain their current values. `effective_from` defaults to the addressed version's start, and `effective_to` is optional.
@@ -2702,7 +2702,7 @@ export type TimecodeScheduledTerminationParameters = {
     effective_date: string;
 };
 /**
- * Request body for scheduling a future change to a timecode: an effective_date paired with the attribute values to apply from that date. `effective_date` and `name` are required; omitted attributes inherit the current version's values.
+ * Request body for scheduling a future change to a timecode: an effective_date paired with the attribute values to apply from that date. Only `effective_date` is required; omitted attributes inherit the current version's values.
  */
 export type TimecodeScheduledChangeParameters = {
     /**
@@ -2710,9 +2710,9 @@ export type TimecodeScheduledChangeParameters = {
      */
     effective_date: string;
     /**
-     * Timecode name to apply from the effective date. Required.
+     * Timecode name to apply from the effective date; omit it to keep the current name.
      */
-    name: string;
+    name?: string;
     /**
      * Free-text description to apply; null clears it.
      */
@@ -2844,10 +2844,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 +2853,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 +2872,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 +2902,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 +2940,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 +2959,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 +2989,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.
@@ -3179,7 +3205,7 @@ export type AssetsAttributeResponseObject = {
     updated_at: string;
 };
 /**
- * Create or update an attribute definition. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
+ * Create an attribute definition. Omitting name or data_type answers 400, and a blank or null name or any wrong-typed value answers 422. Options apply only to a select attribute and are ignored otherwise.
  */
 export type AssetsAttributeParameters = {
     /**
@@ -3191,7 +3217,7 @@ export type AssetsAttributeParameters = {
      */
     data_type: 'text' | 'number' | 'date' | 'boolean' | 'select';
     /**
-     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one.
+     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     options?: Array<{
         /**
@@ -3213,7 +3239,7 @@ export type AssetsAttributeParameters = {
     }>;
 };
 /**
- * Update an attribute definition. All fields are optional — send only what changes. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
+ * Update an attribute definition. All fields are optional — send only what changes. A blank or null name or any wrong-typed value answers 422. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
  */
 export type AssetsAttributeUpdateParameters = {
     /**
@@ -3225,7 +3251,7 @@ export type AssetsAttributeUpdateParameters = {
      */
     data_type?: 'text' | 'number' | 'date' | 'boolean' | 'select';
     /**
-     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one.
+     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     options?: Array<{
         /**
@@ -3305,7 +3331,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 +3343,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 +3353,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 +3373,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 +3385,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 +3395,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.
          */
@@ -5198,7 +5224,7 @@ export type UserResponseObject = {
     } | null;
 };
 /**
- * Request body for updating a worker's profile. Limited to person-level identity fields; employment, roles, and compliance are managed through onboarding (create) and the user-company endpoints.
+ * Request body for updating a worker's profile. Limited to person-level identity fields; employment, roles, and compliance are managed through onboarding (create) and the user-company endpoints. Include only the fields to change. A null or blank legal name, or any wrong-typed value, answers 422.
  */
 export type UserUpdateParameters = {
     /**
@@ -5238,7 +5264,7 @@ export type UserUpdateParameters = {
      */
     state?: string | null;
     /**
-     * Date of birth (YYYY-MM-DD).
+     * Date of birth as a YYYY-MM-DD calendar date; send null to clear it.
      */
     birth_date?: string | null;
     /**
@@ -5404,9 +5430,9 @@ export type UserParameters = ({
      */
     hire_date?: string;
     /**
-     * Ids of the groups to add the worker to at your company.
+     * Unique nonblank IDs of the groups at your company to add the worker to. Omit or send an empty array to add the worker to none. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before the worker is created.
      */
-    group_ids?: Array<string> | null;
+    group_ids?: Array<string>;
     /**
      * Values for the employment's custom fields, as a list of configurations and their values. Each configuration may appear only once. Every visible configuration gets a stored value; one left out of the list, or an omitted or empty list, stores null.
      */
@@ -5679,23 +5705,27 @@ export type ManagerTimeEntryApprovalParameters = {
     approver_user_id: string;
 };
 /**
- * The time-entry body fields shared by the create and update bodies; each of those declares its own requiredness.
+ * Request body for creating a time entry. timekeeping_time_card_id, start_time, and end_time are required, and omitting one answers 400.
  */
-export type TimeEntryParameters = {
+export type TimeEntryCreateParameters = {
     /**
-     * these will be rounded to the nearest second
+     * Id of the time card to attach the entry to; user_id is derived server-side from it. Required and set at creation. Null or a value that is not a nonblank string answers 422; a card outside the key's scope answers 404.
      */
-    start_time?: string;
+    timekeeping_time_card_id: string;
     /**
-     * these will be rounded to the nearest second
+     * Start of the work as a timestamp string, rounded to the nearest second. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    end_time?: string;
+    start_time: string;
+    /**
+     * End of the work as a timestamp string, rounded to the nearest second. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
+     */
+    end_time: string;
     /**
-     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null (or omit) for no job.
+     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null for no job; a blank string answers 422.
      */
     job_id?: string | null;
     /**
-     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none.
+     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none; a blank string answers 422.
      */
     timekeeping_timecode_id?: string | null;
     /**
@@ -5711,31 +5741,54 @@ export type TimeEntryParameters = {
      */
     hourly_rate_cents?: string | null;
     /**
-     * Feature ids to allocate to this time entry. Only features your company can view are accepted.
+     * Complete desired set of unique nonblank IDs of the features to allocate to this time entry. Only features your company can view are accepted. Omit to keep the allocations (none on create); send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
      */
-    feature_ids?: Array<string> | null;
+    feature_ids?: Array<string>;
+    /**
+     * Send true to record an explicit "no feature" answer when the job requires a feature allocation and you're not supplying one; false or omission records none. Null or any non-boolean value answers 422.
+     */
+    feature_allocation_acknowledged?: boolean;
 };
 /**
- * Request body for creating a time entry — the time_entry_parameters fields plus the time card and the explicit "no feature" acknowledgement. timekeeping_time_card_id, start_time, and end_time are required.
+ * Request body for updating a time entry. Every field is optional, and an omitted field keeps its value.
  */
-export type TimeEntryCreateParameters = TimeEntryParameters & {
+export type TimeEntryUpdateParameters = {
     /**
-     * Id of the time card to attach the entry to; user_id is derived server-side from it. Set at creation.
+     * Start of the work as a timestamp string, rounded to the nearest second. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    timekeeping_time_card_id: string;
+    start_time?: string;
     /**
-     * Set true to record an explicit "no feature" answer when the job requires a feature allocation and you're not supplying one.
+     * End of the work as a timestamp string, rounded to the nearest second. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    feature_allocation_acknowledged?: boolean | null;
-};
-/**
- * Request body for updating a time entry — the time_entry_parameters fields, every one optional, plus the acknowledgement that clears an apprenticeship allocation conflict.
- */
-export type TimeEntryUpdateParameters = TimeEntryParameters & {
+    end_time?: string;
+    /**
+     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null for no job; a blank string answers 422.
+     */
+    job_id?: string | null;
+    /**
+     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none; a blank string answers 422.
+     */
+    timekeeping_timecode_id?: string | null;
+    /**
+     * Two-letter US state code where the work occurred; null to clear.
+     */
+    state?: string | null;
+    /**
+     * Free-text note on the entry (maximum 10,000 characters); null to clear.
+     */
+    description?: string | null;
+    /**
+     * Base hourly rate in cents, sent as a string to preserve precision; omit it to let the system derive the rate from the position/user default, and null also derives the default. Admin only on user-scoped keys.
+     */
+    hourly_rate_cents?: string | null;
+    /**
+     * Complete desired set of unique nonblank IDs of the features to allocate to this time entry. Only features your company can view are accepted. Omit to keep the allocations (none on create); send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
+     */
+    feature_ids?: Array<string>;
     /**
-     * Set true to accept dropping the time card's apprenticeship hour allocations when the new times invalidate them; without it such an update returns 422.
+     * Send true to accept dropping the time card's apprenticeship hour allocations when the new times invalidate them; without it such an update returns 422. Null or any non-boolean value answers 422.
      */
-    confirm_allocation_conflict?: boolean | null;
+    confirm_allocation_conflict?: boolean;
 };
 /**
  * A form definition — a SurveyJS form template built and versioned in the web app's form builder. The same object the list door serializes. Read-only.
@@ -5900,16 +5953,19 @@ export type FormSubmissionResponseObject = {
     updated_at: string;
 };
 /**
- * Request body for updating a worker's employment at your company. Corrects administrative fields (employment type, title, manager, payroll id, hire date, and time-and-attendance enrollment) across the whole employment history, and changes the custom-field values it lists. For time-effective pay changes, use the scheduled-changes endpoints instead.
+ * Request body for updating a worker's employment at your company. Corrects administrative fields (employment type, title, manager, payroll id, hire date, and time-and-attendance enrollment) across the whole employment history, and changes the custom-field values it lists. For time-effective pay changes, use the scheduled-changes endpoints instead. A value of the wrong JSON type, a null for a field that is not nullable, or a value outside a listed set answers 422 at its pointer, and nothing is written.
  */
 export type UserCompanyParameters = {
-    type?: UserCompanyType;
+    /**
+     * Whether the worker is an `EMPLOYEE` (W-2) or a `CONTRACTOR` (1099), in upper case. Null is not accepted.
+     */
+    type?: 'EMPLOYEE' | 'CONTRACTOR';
     /**
      * Job title at your company.
      */
     title?: string | null;
     /**
-     * Id of the worker's manager at your company (another user).
+     * Id of the worker's manager at your company (another user). Send null to clear it; blank text answers 422.
      */
     manager_user_id?: string | null;
     /**
@@ -5917,13 +5973,13 @@ export type UserCompanyParameters = {
      */
     payroll_id?: string | null;
     /**
-     * Employment start date (YYYY-MM-DD). Changing it moves the start of the employment history.
+     * Whether the worker is enrolled in Time and Attendance (time tracking). Null is not accepted.
      */
-    hire_date?: string | null;
+    enrolled_in_t_and_a?: boolean;
     /**
-     * Whether the worker is enrolled in Time and Attendance (time tracking).
+     * Employment start date (YYYY-MM-DD). Changing it moves the start of the employment history. Null or blank text leaves it where it is.
      */
-    enrolled_in_t_and_a?: boolean;
+    hire_date?: string | null;
     /**
      * Custom-field values to change, as a list of configurations and their replacement values. Each configuration may appear only once. Only the listed configurations change; every other configuration keeps its stored value, and an omitted or empty list changes none.
      */
@@ -5939,52 +5995,55 @@ export type UserCompanyParameters = {
     }>;
 };
 /**
- * Request body for adding a worker to your company, creating their employment record and its custom-field values. hire_date is required and sets when employment begins; the remaining fields seed the initial title, pay, benefits, and accruals. Returns the worker with the new employment flattened onto it.
+ * Request body for adding a worker to your company, creating their employment record and its custom-field values. hire_date is required and sets when employment begins; the remaining fields seed the initial title, pay, benefits, and accruals. Returns the worker with the new employment flattened onto it. Omitting hire_date answers 400. A value of the wrong JSON type, a null for a field that is not nullable, or a value outside a listed set answers 422 at its pointer, and nothing is written.
  */
 export type UserCompanyCreateParameters = {
     /**
-     * Employment start date (YYYY-MM-DD). Sets when employment begins. Required.
+     * Employment start date (YYYY-MM-DD). Sets when employment begins. Required; null, blank text, or any other form answers 422.
      */
     hire_date: string;
-    type?: UserCompanyType;
+    /**
+     * Whether the worker is an `EMPLOYEE` (W-2) or a `CONTRACTOR` (1099), in upper case. Omit to use `EMPLOYEE`; null is not accepted.
+     */
+    type?: 'EMPLOYEE' | 'CONTRACTOR';
     /**
      * Job title at your company.
      */
     title?: string | null;
     /**
-     * Id of the worker's manager at your company (another user).
+     * Id of the worker's manager at your company (another user). Omit or send null for no manager; blank text answers 422.
      */
     manager_user_id?: string | null;
     /**
-     * How the worker is paid: hourly or salary.
+     * The worker's identifier in your payroll system of record.
      */
-    compensation_type?: 'hourly' | 'salary';
+    payroll_id?: string | null;
     /**
-     * Whether to enroll the worker in Time and Attendance (time tracking).
+     * Whether to enroll the worker in Time and Attendance (time tracking). Null is not accepted.
      */
     enrolled_in_t_and_a?: boolean;
     /**
-     * The worker's identifier in your payroll system of record.
+     * How the worker is paid: `hourly` or `salary`, in lower case. Null is not accepted.
      */
-    payroll_id?: string | null;
+    compensation_type?: 'hourly' | 'salary';
     /**
-     * Base pay rate as a decimal string (for example "32.50"), in the company's currency.
+     * Base pay rate as a decimal string (for example "32.50"), in the company's currency. A JSON number answers 422; send the amount as a string.
      */
     hourly_rate?: string | null;
     /**
-     * Whether the worker is eligible for overtime pay.
+     * Whether the worker is eligible for overtime pay. Omit to use true; null is not accepted.
      */
     overtime_eligible?: boolean;
     /**
-     * Annual training-fund contribution as a decimal string. Used in prevailing-wage fringe calculations.
+     * Annual training-fund contribution as a decimal string. Used in prevailing-wage fringe calculations. A JSON number answers 422.
      */
     training_annual_amount?: string | null;
     /**
-     * Employer-paid annual combined health benefit as a decimal string.
+     * Employer-paid annual combined health benefit as a decimal string. A JSON number answers 422.
      */
     employer_combined_health_amount?: string | null;
     /**
-     * Employer-paid annual combined savings and retirement benefit as a decimal string.
+     * Employer-paid annual combined savings and retirement benefit as a decimal string. A JSON number answers 422.
      */
     employer_combined_savings?: string | null;
     /**
@@ -6373,7 +6432,7 @@ export type UserGroupResponse = {
  */
 export type UserGroupParameters = {
     /**
-     * Required nonempty array of user ID strings to add to the group. Users already in the group are ignored, and the full membership list is returned.
+     * Required nonempty array of unique nonblank IDs of the users to add to the group. Users already in the group are ignored, and the full membership list is returned. Omission answers 400; an empty array, null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anyone is added.
      */
     user_ids: Array<string>;
 };
@@ -6495,6 +6554,47 @@ export type UserCompanyScheduledTerminationParameters = {
      */
     termination_date: string;
 };
+/**
+ * A pay period — a bounded pay window generated automatically by its pay schedule (PayPeriodConfig).
+ */
+export type PayPeriodResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * ID of the pay schedule (PayPeriodConfig) that owns this pay period, stable across all of its versions.
+     */
+    timekeeping_pay_period_config_id: string;
+    /**
+     * Calendar date (YYYY-MM-DD) that workers are paid for this period.
+     */
+    pay_date: string;
+    /**
+     * Start of the pay-period window (ISO 8601).
+     */
+    start_time: string;
+    /**
+     * End of the pay-period window (ISO 8601).
+     */
+    end_time: string;
+    /**
+     * When payroll must be run for this period (ISO 8601).
+     */
+    pay_run_deadline: string;
+    /**
+     * When time-card approvals are due for this period (ISO 8601).
+     */
+    approvals_deadline: string;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
+    /**
+     * When the record was last updated (ISO 8601).
+     */
+    updated_at: string;
+};
 /**
  * A page of pay periods. A pay period is a bounded pay window generated automatically by its pay schedule (PayPeriodConfig), so this API is read-only.
  */
@@ -6504,44 +6604,7 @@ export type PayPeriodsResponseObject = {
     /**
      * The page of pay periods.
      */
-    data: Array<{
-        /**
-         * Unique identifier.
-         */
-        id: string;
-        /**
-         * ID of the pay schedule (PayPeriodConfig) that owns this pay period, stable across all of its versions.
-         */
-        timekeeping_pay_period_config_id: string;
-        /**
-         * Calendar date (YYYY-MM-DD) that workers are paid for this period.
-         */
-        pay_date: string;
-        /**
-         * Start of the pay-period window (ISO 8601).
-         */
-        start_time: string;
-        /**
-         * End of the pay-period window (ISO 8601).
-         */
-        end_time: string;
-        /**
-         * When payroll must be run for this period (ISO 8601).
-         */
-        pay_run_deadline: string;
-        /**
-         * When time-card approvals are due for this period (ISO 8601).
-         */
-        approvals_deadline: string;
-        /**
-         * When the record was created (ISO 8601).
-         */
-        created_at: string;
-        /**
-         * When the record was last updated (ISO 8601).
-         */
-        updated_at: string;
-    }>;
+    data: Array<PayPeriodResponseObject>;
 };
 /**
  * One problem found while processing an accepted import, whatever its type.
@@ -8019,7 +8082,7 @@ export type ProjectResponseObject = {
     updated_at: string;
 };
 /**
- * Request body for creating a project. `name` and `created_by_user_id` are required; the creator must be a member of the owning company. The owning company is inferred from the API key and is not part of the body. Undeclared body keys return 400 before any project or relationship is saved.
+ * Request body for creating a project. `name` and `created_by_user_id` are required, and omitting either returns 400; the creator must be a member of the owning company. The owning company is inferred from the API key and is not part of the body. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any project or relationship is saved.
  */
 export type ProjectParameters = {
     /**
@@ -8027,7 +8090,7 @@ export type ProjectParameters = {
      */
     external_id?: string | null;
     /**
-     * Human-readable project name; required, and must be unique within the owning company.
+     * Human-readable project name; required, and must be unique within the owning company. Null, a blank string, or a wrong type answers 422.
      */
     name: string;
     /**
@@ -8035,11 +8098,7 @@ export type ProjectParameters = {
      */
     description?: string | null;
     /**
-     * User recorded as the project's creator; must be a member of the owning company. Required on create and immutable thereafter. Send it only on create; every update that includes it returns 400, even when unchanged.
-     */
-    created_by_user_id: string;
-    /**
-     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; the child schedule must fit within the parent's schedule.
+     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; a blank ID or a wrong type answers 422. The child schedule must fit within the parent's schedule.
      */
     parent_id?: string | null;
     /**
@@ -8047,35 +8106,35 @@ export type ProjectParameters = {
      */
     participating_company_ids?: Array<string>;
     /**
-     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set.
+     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
     start_date?: string | null;
     /**
-     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date.
+     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date. Any other string, a timestamp included, answers 422.
      */
     end_date?: string | null;
     /**
-     * IANA time zone name. Required when start_date is set.
+     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
      */
     tz_name?: string | null;
     /**
-     * Day of week billing starts: 0 (Sunday) through 6 (Saturday).
+     * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
     billing_start_day?: number | null;
     /**
-     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Any other value returns 422.
+     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Null or any other value returns 422.
      */
     federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Any value other than `none` requires `region`.
+     * Regional PWA tracking mode, with the same values as `federal_pwa_mode`; null or any other value returns 422. Any value other than `none` requires `region`.
      */
     regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * US state abbreviation; must be one of the owning company's operating regions.
+     * US state abbreviation, or null; must be one of the owning company's operating regions.
      */
     region?: string | null;
     /**
-     * Gates IRA tax-credit checks. Applies only while `federal_pwa_mode` is not `none` — sending `true` or null while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
+     * Gates IRA tax-credit checks. A boolean; null or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending `true` while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
      */
     asset_owner?: boolean;
     /**
@@ -8091,24 +8150,28 @@ export type ProjectParameters = {
      */
     administrator_phone?: string | null;
     /**
-     * Decimal string (e.g. "5000.0"). Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Decimal string (e.g. "5000.0"), or null to clear it; a JSON number or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
-    budget?: string;
+    budget?: string | null;
     /**
-     * Prevailing-wage lock-in date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Prevailing-wage lock-in date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     prevailing_wage_lock_in_date?: string | null;
     /**
-     * IRA beginning-of-construction date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA beginning-of-construction date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     beginning_of_construction_date?: string | null;
     /**
-     * IRA placed-in-service date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA placed-in-service date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     placed_in_service_date?: string | null;
+    /**
+     * User recorded as the project's creator; must be a member of the owning company. Required on create and immutable thereafter. Omission answers 400; null, a blank ID, or a wrong type answers 422. Send it only on create; every update that includes it returns 400, even when unchanged.
+     */
+    created_by_user_id: string;
 };
 /**
- * Request body for updating a project. Every field is optional; omit a field to preserve its current value. The resulting project must still satisfy conditional PWA, regional, and schedule validation rules. `created_by_user_id` is create-only; omit it on PATCH. Every update that includes it returns 400, even when unchanged. Undeclared body keys return 400 before any project or relationship changes.
+ * Request body for updating a project. Every field is optional; omit a field to preserve its current value. The resulting project must still satisfy conditional PWA, regional, and schedule validation rules. `created_by_user_id` is create-only; omit it on PATCH. Every update that includes it returns 400, even when unchanged. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any project or relationship changes.
  */
 export type ProjectUpdateParameters = {
     /**
@@ -8116,7 +8179,7 @@ export type ProjectUpdateParameters = {
      */
     external_id?: string | null;
     /**
-     * Human-readable project name; omit to preserve the current value. The resulting project name must remain present and unique within the owning company.
+     * Human-readable project name; omit to preserve the current value. Null, a blank string, or a wrong type answers 422, and the name must remain unique within the owning company.
      */
     name?: string;
     /**
@@ -8124,7 +8187,7 @@ export type ProjectUpdateParameters = {
      */
     description?: string | null;
     /**
-     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; the child schedule must fit within the parent's schedule.
+     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; a blank ID or a wrong type answers 422. The child schedule must fit within the parent's schedule.
      */
     parent_id?: string | null;
     /**
@@ -8132,35 +8195,35 @@ export type ProjectUpdateParameters = {
      */
     participating_company_ids?: Array<string>;
     /**
-     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set.
+     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
     start_date?: string | null;
     /**
-     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date.
+     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date. Any other string, a timestamp included, answers 422.
      */
     end_date?: string | null;
     /**
-     * IANA time zone name. Required when start_date is set.
+     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
      */
     tz_name?: string | null;
     /**
-     * Day of week billing starts: 0 (Sunday) through 6 (Saturday).
+     * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
     billing_start_day?: number | null;
     /**
-     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Any other value returns 422.
+     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Null or any other value returns 422.
      */
     federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Any value other than `none` requires `region`.
+     * Regional PWA tracking mode, with the same values as `federal_pwa_mode`; null or any other value returns 422. Any value other than `none` requires `region`.
      */
     regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * US state abbreviation; must be one of the owning company's operating regions.
+     * US state abbreviation, or null; must be one of the owning company's operating regions.
      */
     region?: string | null;
     /**
-     * Gates IRA tax-credit checks. Applies only while `federal_pwa_mode` is not `none` — sending `true` or null while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
+     * Gates IRA tax-credit checks. A boolean; null or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending `true` while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
      */
     asset_owner?: boolean;
     /**
@@ -8176,19 +8239,19 @@ export type ProjectUpdateParameters = {
      */
     administrator_phone?: string | null;
     /**
-     * Decimal string (e.g. "5000.0"). Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Decimal string (e.g. "5000.0"), or null to clear it; a JSON number or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
-    budget?: string;
+    budget?: string | null;
     /**
-     * Prevailing-wage lock-in date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Prevailing-wage lock-in date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     prevailing_wage_lock_in_date?: string | null;
     /**
-     * IRA beginning-of-construction date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA beginning-of-construction date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     beginning_of_construction_date?: string | null;
     /**
-     * IRA placed-in-service date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA placed-in-service date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     placed_in_service_date?: string | null;
 };
@@ -8231,52 +8294,173 @@ export type ProjectSiteUpdateParameters = {
      */
     feature_ids?: Array<string>;
 };
-export type SiteCheckInResponseObject = {
-    id: string;
-    site_id: string;
-    /**
-     * The checked-in DSPTCH user; null when the person was recorded by name instead.
-     */
-    user_id: string | null;
-    first_name: string | null;
-    last_name: string | null;
-    site_contact_id: string | null;
-    site_contact_first_name: string | null;
-    site_contact_last_name: string | null;
-    employer_name: string | null;
-    description: string | null;
-    rationale: string | null;
-    /**
-     * How the check-in was captured.
-     */
-    source: 'manual' | 'auto' | 'public_form';
-    nerc_check_in: boolean;
-    cip_exceptional: boolean;
-    created_by_user_id: string | null;
-    latitude: number | null;
-    longitude: number | null;
-    start_time: string;
-    end_time: string | null;
-    verified_at: string | null;
-    created_at: string;
-    updated_at: string;
-};
 /**
- * A geographic location where work is performed — a site on the Atlas map. Read-only through the API; sites are drawn on the map or imported from external sources, not created here.
+ * A file attached to a project. Uploaded through the direct-upload flow. `name` is always "document" and is not client-writable.
  */
-export type SiteResponseObject = {
+export type ProjectDocumentResponseObject = {
     /**
      * Unique identifier.
      */
     id: string;
     /**
-     * Human-readable name of the site.
+     * ID of the project this document belongs to.
      */
-    name: string;
+    project_id: string;
     /**
-     * Site type code; one of the configured site types.
+     * Read-only document label; this API does not set it, so it is always "document".
      */
-    type: 'MICROGRID' | 'POWER_PLANT' | 'TRANSMISSION' | 'battery' | 'mobile_assets' | 'ong' | 'solar' | 'training_hub' | 'warehouse' | 'wind';
+    name: string;
+    /**
+     * The file's human-readable download name; null when not set.
+     */
+    filename: string | null;
+    /**
+     * Free-text description of the document; null when none.
+     */
+    description: string | null;
+    /**
+     * ID of the user who uploaded the document.
+     */
+    created_by_user_id: string;
+    /**
+     * The attached file; null while no blob is attached.
+     */
+    file: {
+        /**
+         * Stored name of the uploaded file.
+         */
+        filename: string;
+        /**
+         * MIME type of the file; null when not recorded.
+         */
+        content_type: string | null;
+        /**
+         * Size of the file in bytes.
+         */
+        byte_size: number;
+        /**
+         * A URL to download the file.
+         */
+        url: string;
+    } | null;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
+    /**
+     * When the record was last updated (ISO 8601).
+     */
+    updated_at: string;
+};
+/**
+ * Attach a file to a project as a document. file is required and takes a signed_id from the direct-upload endpoint.
+ */
+export type ProjectDocumentParameters = {
+    /**
+     * A signed_id from POST /api/v1/direct_uploads identifying the uploaded blob to attach. Register the upload naming `projects.documents` — a signed_id issued for any other resource will not resolve here. Null and a blank string answer 422. Omitting file answers 400.
+     */
+    file: string;
+    /**
+     * The file's human-readable download name; null when not set.
+     */
+    filename?: string | null;
+    /**
+     * Free-text description of the document; null when none.
+     */
+    description?: string | null;
+    /**
+     * ID of the user this document is attached on behalf of, recorded as its creator. 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;
+};
+/**
+ * Update a project document. All fields are optional — send only what changes. Omit file to retain the existing attachment, or supply a new signed_id to replace it. A document always holds a file, so null answers 422, as does a blank string. `name` is read-only; sending it answers 400.
+ */
+export type ProjectDocumentUpdateParameters = {
+    /**
+     * A signed_id from POST /api/v1/direct_uploads identifying a replacement blob. Register the upload naming `projects.documents` — a signed_id issued for any other resource will not resolve here.
+     */
+    file?: string;
+    /**
+     * The file's human-readable download name; null when not set.
+     */
+    filename?: string | null;
+    /**
+     * Free-text description of the document; null when none.
+     */
+    description?: string | null;
+};
+/**
+ * One entry in a project document's PaperTrail change history, recorded whenever the document is created, updated, or deleted — including when only its attached file is replaced. This is transaction-time audit data, not a temporal valid-time version.
+ */
+export type ProjectDocumentVersionResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: number;
+    /**
+     * ID of the document this version belongs to.
+     */
+    document_id: string;
+    /**
+     * The change this version records: one of create, update, or destroy.
+     */
+    event: 'create' | 'update' | 'destroy';
+    /**
+     * ID of the user who made the change; null when it was not attributed to a user.
+     */
+    whodunnit: string | null;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
+};
+export type SiteCheckInResponseObject = {
+    id: string;
+    site_id: string;
+    /**
+     * The checked-in DSPTCH user; null when the person was recorded by name instead.
+     */
+    user_id: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    site_contact_id: string | null;
+    site_contact_first_name: string | null;
+    site_contact_last_name: string | null;
+    employer_name: string | null;
+    description: string | null;
+    rationale: string | null;
+    /**
+     * How the check-in was captured.
+     */
+    source: 'manual' | 'auto' | 'public_form';
+    nerc_check_in: boolean;
+    cip_exceptional: boolean;
+    created_by_user_id: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    start_time: string;
+    end_time: string | null;
+    verified_at: string | null;
+    created_at: string;
+    updated_at: string;
+};
+/**
+ * A geographic location where work is performed — a site on the Atlas map. Read-only through the API; sites are drawn on the map or imported from external sources, not created here.
+ */
+export type SiteResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * Human-readable name of the site.
+     */
+    name: string;
+    /**
+     * Site type code; one of the configured site types.
+     */
+    type: 'MICROGRID' | 'POWER_PLANT' | 'TRANSMISSION' | 'battery' | 'mobile_assets' | 'ong' | 'solar' | 'training_hub' | 'warehouse' | 'wind';
     /**
      * Free-form attributes keyed per site type.
      */
@@ -8676,19 +8860,19 @@ export type ComplianceCheckDocumentObject = {
     created_at: string;
 };
 /**
- * Update a compliance check. Every field is optional.
+ * Update a compliance check. Every field is optional. Undeclared body keys return 400, and a wrong-typed value, a null for a field that is not nullable, or a status outside the list returns 422 at its pointer before anything is written.
  */
 export type ComplianceCheckParameters = {
     /**
-     * Only the person-settable statuses are writable, mirroring the web app: `dismissed` excludes the check from automatic re-evaluation; `pending` re-evaluates it on save. Evaluation owns `passed`/`failed`.
+     * Only the person-settable statuses are writable, mirroring the web app: `dismissed` excludes the check from automatic re-evaluation; `pending` re-evaluates it on save. Evaluation owns `passed`/`failed`, so sending either, or null, answers 422.
      */
     status?: 'dismissed' | 'pending';
     /**
-     * When the check is due (ISO 8601); send null to clear it, or omit to leave it unchanged.
+     * When the check is due, as an ISO 8601 date-time; send null to clear it, or omit to leave it unchanged. A value that is not a string answers 422.
      */
     time_due?: string | null;
     /**
-     * Replaces the check's assignees: send every user id that should be assigned, or an empty array to clear them. Every id must belong to a person in your company. Omit to leave the assignees unchanged.
+     * Replaces the check's assignees: send every user id that should be assigned, each once, or an empty array to clear them. Every id must belong to a person in your company. Omit to leave the assignees unchanged. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
      */
     assignee_user_ids?: Array<string>;
     /**
@@ -9784,7 +9968,7 @@ export type SiteFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -9839,7 +10023,7 @@ export type SiteFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -9956,7 +10140,7 @@ export type FeatureFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10011,7 +10195,7 @@ export type FeatureFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10070,7 +10254,7 @@ export type JobFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10125,7 +10309,7 @@ export type JobFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10454,75 +10638,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.
+ * 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 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.
- */
-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;
     };
@@ -10712,7 +10886,7 @@ export type FormAssignmentTaskResponseObject = Array<{
     }>;
 }>;
 /**
- * Request body for creating a certification — a named qualification a worker can hold. You can only manage your own company's certifications; global (platform) certifications are read-only.
+ * Request body for creating a certification — a named qualification a worker can hold. You can only manage your own company's certifications; global (platform) certifications are read-only. Omitting company_id or name answers 400, and a null or blank one, or any wrong-typed value, answers 422.
  */
 export type CertificationParameters = {
     /**
@@ -10737,7 +10911,7 @@ export type CertificationParameters = {
     duration?: string | null;
 };
 /**
- * Request body for updating a certification — a named qualification a worker can hold. Include only the fields to change. You can only manage your own company's certifications; global (platform) certifications are read-only. The certification's company is fixed at creation.
+ * Request body for updating a certification — a named qualification a worker can hold. Include only the fields to change. You can only manage your own company's certifications; global (platform) certifications are read-only. The certification's company is fixed at creation. A null or blank name, or any wrong-typed value, answers 422.
  */
 export type CertificationUpdateParameters = {
     /**
@@ -10973,11 +11147,11 @@ export type UserCertificationUpdateParameters = {
     archived_at?: string | null;
 };
 /**
- * Request body for approving a certification held by a worker. A user key approves in its own user's name and sends no body.
+ * Request body for approving a certification held by a worker. A user key approves in its own user's name and must omit approved_by_user_id. A company key must name the approver.
  */
 export type UserCertificationApprovalParameters = {
     /**
-     * Company keys only: a visible admin, manager, or safety manager at the key's company to record as approver. Required with a company key.
+     * Id of a visible admin, manager, or safety manager at the key's company to record as approver. Required for a company key. A user key that sends it is refused.
      */
     approved_by_user_id?: string;
 };
@@ -11762,62 +11936,6 @@ export type RegionalJobWageDeterminationHistoryCorrectionObject = {
     created_at: string;
     updated_at: string;
 };
-/**
- * State-specific rate fields for a Regional determination, as decimal-string money in cents
- * (e.g. "538.0"). These nine properties are the whole write vocabulary, but which of them a
- * request may send is set by the job's region, not the request — sending a key the job's
- * region does not allow returns a 422:
- *
- * - Categorized-fringe regions (currently IL) accept `combined_health_fringe_rate_cents`,
- * `combined_savings_fringe_rate_cents`, `combined_holiday_pto_fringe_rate_cents`,
- * `training_fringe_rate_cents`, and `other_fringe_rate_cents`.
- * - Overtime-adder regions (currently IL and NY) accept `one_five_x_adder_rate_cents`,
- * `two_x_adder_rate_cents`, `one_five_x_fringe_adder_rate_cents`, and
- * `two_x_fringe_adder_rate_cents`.
- *
- * In a categorized-fringe region the five fringe keys are required, not merely accepted —
- * omitting any of them returns a 422. Categorized-fringe values are non-null when present;
- * overtime-adder values may be null.
- *
- */
-export type RegionalWageDeterminationFields = {
-    /**
-     * Combined health fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_health_fringe_rate_cents?: string;
-    /**
-     * Combined savings fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_savings_fringe_rate_cents?: string;
-    /**
-     * Combined holiday/PTO fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_holiday_pto_fringe_rate_cents?: string;
-    /**
-     * Training fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    training_fringe_rate_cents?: string;
-    /**
-     * Other (uncategorized) fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    other_fringe_rate_cents?: string;
-    /**
-     * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    one_five_x_adder_rate_cents?: string | null;
-    /**
-     * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    two_x_adder_rate_cents?: string | null;
-    /**
-     * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    one_five_x_fringe_adder_rate_cents?: string | null;
-    /**
-     * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    two_x_fringe_adder_rate_cents?: string | null;
-};
 /**
  * State-specific rate fields recorded on a Regional determination, as decimal-string money in
  * cents (e.g. "538.0"). Which keys appear is set by the job's region, so this object is always
@@ -11846,7 +11964,7 @@ export type JobWageDeterminationParameters = ({
     type: 'Pwa::JobWageDeterminations::Regional';
 } & RegionalJobWageDeterminationParameters);
 /**
- * Parameters for creating a Federal (Davis-Bacon) wage determination on a job.
+ * Parameters for creating a Federal (Davis-Bacon) wage determination on a job. A Federal determination holds no regional rates, so a body sending `regional_fields` returns a 422.
  */
 export type FederalJobWageDeterminationParameters = {
     /**
@@ -11881,6 +11999,10 @@ export type FederalJobWageDeterminationParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     */
+    overtime_package_id?: string | null;
 };
 /**
  * Parameters for creating a Regional (state prevailing-wage) wage determination on a job.
@@ -11903,18 +12025,66 @@ export type RegionalJobWageDeterminationParameters = {
      */
     hourly_rate_cents: string;
     /**
-     * Hourly fringe rate, in cents as a decimal string (e.g. "1200.0" is $12.00).
+     * The hourly fringe rate, in cents as a decimal string. Required except in a categorized-fringe region (currently IL), which sums it from the five categorized fringe rates.
      */
     fringe_rate_cents?: string;
+    /**
+     * Not recorded on a Regional determination; a value sent here is dropped.
+     */
+    class_code?: string | null;
+    /**
+     * Not recorded on a Regional determination; a listed value sent here is dropped.
+     */
+    construction_category?: 'building' | 'heavy' | 'highway' | 'residential' | null;
     /**
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
     /**
-     * Overtime package whose rules govern overtime on work under this determination. This is not a versioned attribute: setting it points every version at that package, not only the one this request writes, and `effective_from` does not date it. Send null to detach, leaving the determination with no overtime package of its own. Omit the key to leave the current attachment alone. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     * State-specific rates, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
      */
     overtime_package_id?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
 };
 /**
  * Parameters for editing a job wage determination from a point in valid time forward. The type is fixed by the determination the id names and is not sent.
@@ -11956,7 +12126,47 @@ export type JobWageDeterminationUpdateParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for an effective-dated change to a job wage determination, applying from a calendar date forward. The type is fixed by the determination the id names and is not sent.
@@ -11990,7 +12200,47 @@ export type JobWageDeterminationScheduledChangeParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for moving where a job wage determination's timeline begins.
@@ -12254,7 +12504,7 @@ export type ProjectWageDeterminationParameters = ({
     type: 'Pwa::ProjectWageDeterminations::Regional';
 } & RegionalProjectWageDeterminationParameters);
 /**
- * Parameters for creating a Federal (Davis-Bacon) wage determination on a project.
+ * Parameters for creating a Federal (Davis-Bacon) wage determination on a project. A Federal determination holds no regional rates, so a body sending `regional_fields` returns a 422.
  */
 export type FederalProjectWageDeterminationParameters = {
     /**
@@ -12289,6 +12539,10 @@ export type FederalProjectWageDeterminationParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     */
+    overtime_package_id?: string | null;
 };
 /**
  * Parameters for creating a Regional (state prevailing-wage) wage determination on a project.
@@ -12311,18 +12565,66 @@ export type RegionalProjectWageDeterminationParameters = {
      */
     hourly_rate_cents: string;
     /**
-     * Hourly fringe rate, in cents as a decimal string (e.g. "1200.0" is $12.00).
+     * The hourly fringe rate, in cents as a decimal string. Required except in a categorized-fringe region (currently IL), which sums it from the five categorized fringe rates.
      */
     fringe_rate_cents?: string;
+    /**
+     * Not recorded on a Regional determination; a value sent here is dropped.
+     */
+    class_code?: string | null;
+    /**
+     * Not recorded on a Regional determination; a listed value sent here is dropped.
+     */
+    construction_category?: 'building' | 'heavy' | 'highway' | 'residential' | null;
     /**
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
     /**
-     * Overtime package whose rules govern overtime on work under this determination. This is not a versioned attribute: setting it points every version at that package, not only the one this request writes, and `effective_from` does not date it. Send null to detach, leaving the determination with no overtime package of its own. Omit the key to leave the current attachment alone. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     * State-specific rates, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
      */
     overtime_package_id?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
 };
 /**
  * Parameters for editing a project wage determination from a point in valid time forward. The type is fixed by the determination the id names and is not sent.
@@ -12364,7 +12666,47 @@ export type ProjectWageDeterminationUpdateParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for an effective-dated change to a project wage determination, applying from a calendar date forward. The type is fixed by the determination the id names and is not sent.
@@ -12398,7 +12740,47 @@ export type ProjectWageDeterminationScheduledChangeParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for moving where a project wage determination's timeline begins.
@@ -12711,29 +13093,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 +13167,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 +13429,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 +13562,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 +13570,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 +13578,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 +13609,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 +13657,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 +13665,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 +13673,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 +13704,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.
      */
@@ -13596,34 +14052,17 @@ export type AssetsAttachmentResponseObject = {
         byte_size: number;
         /**
          * A URL to download the file.
-         */
-        url: string;
-    } | null;
-    /**
-     * When the record was created (ISO 8601).
-     */
-    created_at: string;
-    /**
-     * When the record was last updated (ISO 8601).
-     */
-    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;
+         */
+        url: string;
+    } | null;
     /**
-     * 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.
+     * When the record was created (ISO 8601).
      */
-    file?: string;
+    created_at: string;
     /**
-     * Set true to remove the attachment named by id.
+     * When the record was last updated (ISO 8601).
      */
-    _destroy?: boolean;
+    updated_at: string;
 };
 /**
  * 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.
@@ -13853,7 +14292,7 @@ export type AssetsItemFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -13908,7 +14347,7 @@ export type AssetsItemFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -14317,13 +14756,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 +14798,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.
@@ -14627,55 +15092,55 @@ export type AssetsTransferResponseObject = {
     updated_at: string;
 };
 /**
- * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). With a single open end it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. Moves are applied immediately, so the source must hold enough of each item.
+ * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side; more than one on a side, or no endpoint at all, answers 422. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). With a single open end it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. Moves are applied immediately, so the source must hold enough of each item.
  */
 export type AssetsTransferParameters = {
     /**
-     * ID of the source site. At most one source endpoint (site, user, or container).
+     * ID of the source site. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a site outside the company that owns the API key answers 404.
      */
     from_assets_site_id?: string;
     /**
-     * ID of the source user. At most one source endpoint (site, user, or container).
+     * ID of the source user. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a user holding none of the line items answers 404.
      */
     from_user_id?: string;
     /**
-     * ID of the source container item. At most one source endpoint (site, user, or container).
+     * ID of the source container item. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and an item outside the company that owns the API key answers 404.
      */
     from_container_item_id?: string;
     /**
-     * ID of the destination site. At most one destination endpoint (site, user, or container).
+     * Optional. The storage location within the source site or container the stock draws from. Omit or send null for the source's unbinned stock. A blank ID or a wrong type answers 422, a storage location outside the company that owns the API key answers 404, and one named without a source site or container, or not belonging to it, answers 422.
+     */
+    from_assets_sub_location_id?: string | null;
+    /**
+     * ID of the destination site. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a site outside the company that owns the API key answers 404.
      */
     to_assets_site_id?: string;
     /**
-     * ID of the destination user. At most one destination endpoint (site, user, or container).
+     * ID of the destination user. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a user neither currently employed by nor holding a role in the company that owns the API key answers 404.
      */
     to_user_id?: string;
     /**
-     * ID of the destination container item. At most one destination endpoint (site, user, or container).
+     * ID of the destination container item. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and an item outside the company that owns the API key answers 404.
      */
     to_container_item_id?: string;
     /**
-     * Optional. The storage location within the source site or container the stock draws from; must belong to that endpoint. Omit for the source's unbinned stock.
+     * Optional. The storage location within the destination site or container the stock lands in. Omit or send null for an unbinned destination. A blank ID or a wrong type answers 422, a storage location outside the company that owns the API key answers 404, and one named without a destination site or container, or not belonging to it, answers 422.
      */
-    from_assets_sub_location_id?: string;
-    /**
-     * Optional. The storage location within the destination site or container the stock lands in; must belong to that endpoint. Omit for an unbinned destination.
-     */
-    to_assets_sub_location_id?: string;
+    to_assets_sub_location_id?: string | null;
     /**
      * ID of the user this move is performed on behalf of, recorded as its initiator. 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;
     /**
-     * The items and quantities to move; at least one is required.
+     * The items and quantities to move, as a list of row objects; at least one is required. Omission answers 400, and null, an empty list, or a value that is not a list answers 422. A row missing a field answers 400 naming it, and an unknown or wrongly typed row field answers 422 at that row.
      */
     line_items: Array<{
         /**
-         * ID of the asset item to move.
+         * ID of the asset item to move. A blank ID or a wrong type answers 422 at its row, and an item outside the company that owns the API key answers 404.
          */
         assets_item_id: string;
         /**
-         * Number of units of the item to move; greater than 0.
+         * Number of units of the item to move, as an integer of 1 or more. Any other value, a fraction or a numeric string included, answers 422 at its row.
          */
         quantity: number;
     }>;
@@ -15725,6 +16190,10 @@ export type CreatePeriodErrors = {
      * Forbidden
      */
     403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
     /**
      * Unprocessable Content
      */
@@ -15996,6 +16465,10 @@ export type UpdateWageScheduleErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
 };
 export type UpdateWageScheduleError = UpdateWageScheduleErrors[keyof UpdateWageScheduleErrors];
 export type UpdateWageScheduleResponses = {
@@ -16873,7 +17346,7 @@ export type UpdateItemErrors = {
      */
     404: Problem;
     /**
-     * Unprocessable Content
+     * Unprocessable Content (malformed row)
      */
     422: Problem;
 };
@@ -17827,7 +18300,7 @@ export type UpdateProductErrors = {
      */
     404: Problem;
     /**
-     * Unprocessable Content
+     * Unprocessable Content (malformed row)
      */
     422: Problem;
 };
@@ -25740,6 +26213,10 @@ export type ListPayPeriodsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * The pay schedule family id, the same value each period returns as timekeeping_pay_period_config_id.
+         */
+        'filter[timekeeping_pay_period_config_id]'?: string;
         'filter[start_time][gte]'?: string;
         'filter[start_time][lte]'?: string;
         filter?: string;
@@ -25779,6 +26256,32 @@ export type ListPayPeriodsResponses = {
     200: PayPeriodsResponseObject;
 };
 export type ListPayPeriodsResponse = ListPayPeriodsResponses[keyof ListPayPeriodsResponses];
+export type GetPayPeriodData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/pay_periods/{id}';
+};
+export type GetPayPeriodErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type GetPayPeriodError = GetPayPeriodErrors[keyof GetPayPeriodErrors];
+export type GetPayPeriodResponses = {
+    /**
+     * Success
+     */
+    200: PayPeriodResponseObject;
+};
+export type GetPayPeriodResponse = GetPayPeriodResponses[keyof GetPayPeriodResponses];
 export type ListCompensationElementsData = {
     body?: never;
     path?: never;
@@ -27429,6 +27932,10 @@ export type ListEmploymentsData = {
          * Return employments for this user ID.
          */
         'filter[user_id]'?: string;
+        /**
+         * Return employments whose version at the lens time (now, or `as_of[valid]`) belongs to this department.
+         */
+        'filter[companies_department_id]'?: string;
         filter?: string;
         'filter[unexpected]'?: string;
         /**
@@ -28180,6 +28687,226 @@ export type UpdateCompletionResponses = {
     200: ProductionCompletionResponseObject;
 };
 export type UpdateCompletionResponse = UpdateCompletionResponses[keyof UpdateCompletionResponses];
+export type ListProjectDocumentVersionsData = {
+    body?: never;
+    path: {
+        project_id: string;
+        document_id: string;
+    };
+    query?: {
+        /**
+         * This pagination cursor corresponds to the cursor value found in the response in
+         * `meta.page.next_cursor`.
+         */
+        'page[cursor]'?: string;
+        /**
+         * Maximum number of records to return per page. Defaults to 20. A value above 100 is capped to 100 rather than rejected; a value that is zero, negative, or not an integer is rejected with a `400`.
+         */
+        'page[limit]'?: number;
+        page?: string;
+    };
+    url: '/api/v1/projects/{project_id}/documents/{document_id}/versions';
+};
+export type ListProjectDocumentVersionsErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type ListProjectDocumentVersionsError = ListProjectDocumentVersionsErrors[keyof ListProjectDocumentVersionsErrors];
+export type ListProjectDocumentVersionsResponses = {
+    /**
+     * Success
+     */
+    200: {
+        meta: Meta;
+        links: Links;
+        data: Array<ProjectDocumentVersionResponseObject>;
+    };
+};
+export type ListProjectDocumentVersionsResponse = ListProjectDocumentVersionsResponses[keyof ListProjectDocumentVersionsResponses];
+export type ListProjectDocumentsData = {
+    body?: never;
+    path: {
+        project_id: string;
+    };
+    query?: {
+        'filter[created_at][gte]'?: string;
+        'filter[created_at][lte]'?: string;
+        'filter[updated_at][gte]'?: string;
+        'filter[updated_at][lte]'?: string;
+        /**
+         * This pagination cursor corresponds to the cursor value found in the response in
+         * `meta.page.next_cursor`.
+         */
+        'page[cursor]'?: string;
+        /**
+         * Maximum number of records to return per page. Defaults to 20. A value above 100 is capped to 100 rather than rejected; a value that is zero, negative, or not an integer is rejected with a `400`.
+         */
+        'page[limit]'?: number;
+        page?: string;
+        filter?: string;
+        'filter[unexpected]'?: string;
+    };
+    url: '/api/v1/projects/{project_id}/documents';
+};
+export type ListProjectDocumentsErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type ListProjectDocumentsError = ListProjectDocumentsErrors[keyof ListProjectDocumentsErrors];
+export type ListProjectDocumentsResponses = {
+    /**
+     * Success
+     */
+    200: {
+        meta: Meta;
+        links: Links;
+        data: Array<ProjectDocumentResponseObject>;
+    };
+};
+export type ListProjectDocumentsResponse = ListProjectDocumentsResponses[keyof ListProjectDocumentsResponses];
+export type CreateProjectDocumentData = {
+    body: ProjectDocumentParameters;
+    path: {
+        project_id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents';
+};
+export type CreateProjectDocumentErrors = {
+    /**
+     * Bad Request (missing performed_by_user_id)
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type CreateProjectDocumentError = CreateProjectDocumentErrors[keyof CreateProjectDocumentErrors];
+export type CreateProjectDocumentResponses = {
+    /**
+     * Created
+     */
+    201: ProjectDocumentResponseObject;
+};
+export type CreateProjectDocumentResponse = CreateProjectDocumentResponses[keyof CreateProjectDocumentResponses];
+export type DeleteProjectDocumentData = {
+    body?: never;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type DeleteProjectDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type DeleteProjectDocumentError = DeleteProjectDocumentErrors[keyof DeleteProjectDocumentErrors];
+export type DeleteProjectDocumentResponses = {
+    /**
+     * No Content
+     */
+    204: void;
+};
+export type DeleteProjectDocumentResponse = DeleteProjectDocumentResponses[keyof DeleteProjectDocumentResponses];
+export type GetProjectDocumentData = {
+    body?: never;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type GetProjectDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type GetProjectDocumentError = GetProjectDocumentErrors[keyof GetProjectDocumentErrors];
+export type GetProjectDocumentResponses = {
+    /**
+     * Success
+     */
+    200: ProjectDocumentResponseObject;
+};
+export type GetProjectDocumentResponse = GetProjectDocumentResponses[keyof GetProjectDocumentResponses];
+export type UpdateProjectDocumentData = {
+    body: ProjectDocumentUpdateParameters;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type UpdateProjectDocumentErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type UpdateProjectDocumentError = UpdateProjectDocumentErrors[keyof UpdateProjectDocumentErrors];
+export type UpdateProjectDocumentResponses = {
+    /**
+     * Success
+     */
+    200: ProjectDocumentResponseObject;
+};
+export type UpdateProjectDocumentResponse = UpdateProjectDocumentResponses[keyof UpdateProjectDocumentResponses];
 export type CreateProjectTradeData = {
     body: PwaTradeParameters;
     path: {
@@ -32457,10 +33184,10 @@ export type RemoveUserFromCompanyData = {
     body?: never;
     path: {
         user_id: string;
-        company_id: string;
+        id: string;
     };
     query?: never;
-    url: '/api/v1/users/{user_id}/companies/{company_id}';
+    url: '/api/v1/users/{user_id}/companies/{id}';
 };
 export type RemoveUserFromCompanyErrors = {
     /**
@@ -32487,10 +33214,10 @@ export type UpdateCompanyData = {
     body: UserCompanyParameters;
     path: {
         user_id: string;
-        company_id: string;
+        id: string;
     };
     query?: never;
-    url: '/api/v1/users/{user_id}/companies/{company_id}';
+    url: '/api/v1/users/{user_id}/companies/{id}';
 };
 export type UpdateCompanyErrors = {
     /**