@dsptch-work/api-client 0.9.0 → 0.10.0

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

@@ -66,6 +66,12 @@ export type Problem = {
  *
  * A signed token in the request fails signature verification. Re-obtain the token from the endpoint that issued it.
  *
+ * ### malformed_body
+ *
+ * **Malformed Request Body**
+ *
+ * The request body could not be parsed in the declared content type — most commonly a body that is not valid JSON. Send a well-formed body matching the `Content-Type` header.
+ *
  * ### non_range_filter_value
  *
  * **Range Filter Needs Bounds**
@@ -94,7 +100,7 @@ export type Problem = {
  *
  * **Parameter Must Be An Object**
  *
- * A container query parameter — `filter`, `page`, or `as_of` — arrived as a scalar, array, or blank value instead of a nested object. Use the object syntax, for example `filter[key]=value`.
+ * Something that must be an object arrived as something else. Either a container query parameter — `filter`, `page`, or `as_of` — arrived as a scalar, array, or blank value, in which case use the object syntax, for example `filter[key]=value`; or the request body of a write that documents this failure parsed to `null`, an array, or a bare scalar, in which case send a JSON object. An absent or empty body is not this failure.
  *
  * ### unknown_axis
  *
@@ -104,9 +110,9 @@ export type Problem = {
  *
  * ### unknown_key
  *
- * **Unknown Query Parameter**
+ * **Unknown Key**
  *
- * The query string carries a top-level key outside the declared containers — typically a misspelled container. Remove or correct it; unknown keys are never silently ignored.
+ * The query string carries a top-level key outside the declared containers, or the request body carries a key the operation's contract does not declare — typically a misspelled container or field. Remove or correct the keys the detail names; unknown keys are never silently ignored.
  *
  * ### unsupported_axis
  *
@@ -333,7 +339,7 @@ export type Problem = {
  * Another write to the same resource held it for longer than this request was willing to wait, so nothing was applied. The request itself is fine — resend it unchanged after the `Retry-After` window.
  *
  */
-export type ProblemTypeCatalog = 'blank_axis' | 'invalid_cursor' | 'invalid_filter_key' | 'invalid_limit' | 'invalid_signature' | 'non_range_filter_value' | 'non_scalar_axis' | 'non_scalar_filter_value' | 'parameter_missing' | 'parameter_not_object' | 'unknown_axis' | 'unknown_key' | 'unsupported_axis' | 'valid_axis_on_timeline' | 'unauthorized' | 'company_scoped_key_required' | 'forbidden' | 'insufficient_api_key_scope' | 'not_found' | 'already_terminated' | 'recorded_since_termination' | 'span_beyond_timeline_end' | 'version_overlap' | 'precondition_failed' | 'attachment_not_image' | 'company_not_employer' | 'confirm_apprenticeship_conflict' | 'destroy_restricted' | 'interval_too_wide' | 'invalid_date' | 'invalid_filter_value' | 'invalid_iso8601_duration' | 'invalid_placement_move' | 'invalid_signed_id' | 'non_numeric_cents' | 'nothing_to_cancel' | 'pagination_failed' | 'subtype_foreign_keys' | 'synced_determination' | 'user_not_company_member' | 'validation_failed' | 'wage_schedule_outside_program' | 'precondition_required' | 'too_many_requests' | 'internal_error' | 'write_contended';
+export type ProblemTypeCatalog = 'blank_axis' | 'invalid_cursor' | 'invalid_filter_key' | 'invalid_limit' | 'invalid_signature' | 'malformed_body' | 'non_range_filter_value' | 'non_scalar_axis' | 'non_scalar_filter_value' | 'parameter_missing' | 'parameter_not_object' | 'unknown_axis' | 'unknown_key' | 'unsupported_axis' | 'valid_axis_on_timeline' | 'unauthorized' | 'company_scoped_key_required' | 'forbidden' | 'insufficient_api_key_scope' | 'not_found' | 'already_terminated' | 'recorded_since_termination' | 'span_beyond_timeline_end' | 'version_overlap' | 'precondition_failed' | 'attachment_not_image' | 'company_not_employer' | 'confirm_apprenticeship_conflict' | 'destroy_restricted' | 'interval_too_wide' | 'invalid_date' | 'invalid_filter_value' | 'invalid_iso8601_duration' | 'invalid_placement_move' | 'invalid_signed_id' | 'non_numeric_cents' | 'nothing_to_cancel' | 'pagination_failed' | 'subtype_foreign_keys' | 'synced_determination' | 'user_not_company_member' | 'validation_failed' | 'wage_schedule_outside_program' | 'precondition_required' | 'too_many_requests' | 'internal_error' | 'write_contended';
 export type ApiKeyScopeResponseObject = {
     resource: string;
     action: 'read' | 'create' | 'update' | 'delete';
@@ -468,7 +474,7 @@ export type ApprenticeshipProgramResponseObject = {
     /**
      * Agency that registered the program: federal (DOL Office of Apprenticeship) or regional (a recognized state apprenticeship agency); null when not recorded.
      */
-    registration_agency_type: 'federal' | 'regional';
+    registration_agency_type: 'federal' | 'regional' | null;
     /**
      * When the record was created (ISO 8601).
      */
@@ -709,7 +715,7 @@ export type ApprenticeshipApprenticeResponseObject = {
     /**
      * Result of the last DOL status-verification attempt: one of pending, in_progress, failed, or success; null when never attempted.
      */
-    status_verification_result: 'pending' | 'in_progress' | 'failed' | 'success';
+    status_verification_result: 'pending' | 'in_progress' | 'failed' | 'success' | null;
     /**
      * Date the apprentice is expected to begin the apprenticeship.
      */
@@ -799,7 +805,7 @@ export type ApprenticeshipProgramParameters = {
     /**
      * Agency that registered the program: federal or regional; optional, null to clear.
      */
-    registration_agency_type?: 'federal' | 'regional';
+    registration_agency_type?: 'federal' | 'regional' | null;
 };
 /**
  * Create or update an occupation (trade) within a sponsored program; the program is taken from the URL path.
@@ -967,7 +973,7 @@ export type ApprenticeshipWageScheduleParameters = {
  */
 export type TimecodeResponseObject = {
     /**
-     * Version-stable identifier; always equal to bitemporal_id, never a per-version row id (UUID string).
+     * Version-stable identifier — the identity every version of the timecode shares, never a per-version row id (UUID string).
      */
     id: string;
     /**
@@ -1031,9 +1037,9 @@ export type TimecodeResponseObject = {
      */
     restricted_to: 'none' | 'job' | 'non_job' | 'job_with_timecode';
     /**
-     * Id of the company that owns this timecode as a company-wide default; null for job-scoped timecodes (a timecode is either company-default or job-scoped, never both). Timecodes created through this API are always company-owned by the caller's company.
+     * Id of the company that owns this timecode as a company-wide default. Always your company — a timecode is either company-default or job-scoped, and this API only exposes the company-default ones.
      */
-    default_for_company_id: string | null;
+    default_for_company_id: string;
     /**
      * ISO8601 timestamp at which this version's validity window begins (bitemporal valid-time start); never null for this resource — a lower bound is always recorded.
      */
@@ -1059,8 +1065,39 @@ export type TimecodeResponseObject = {
      */
     updated_at: string;
 };
+export type TimecodeHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    timekeeping_timecode_id: string;
+    name: string;
+    description: string | null;
+    description_is_required: boolean;
+    billable: boolean;
+    overtime_eligible: boolean;
+    unpaid: boolean;
+    holiday: boolean;
+    pto: boolean;
+    safety: boolean;
+    lunch_shortcut: boolean;
+    break_shortcut: boolean;
+    pwa: boolean;
+    rest_and_recovery: boolean;
+    incentive_pay_eligible: boolean;
+    restricted_to: 'none' | 'job' | 'non_job' | 'job_with_timecode';
+    default_for_company_id: string;
+    valid_from: string | null;
+    valid_to: string | null;
+    transaction_from: string;
+    transaction_to: string | null;
+    created_at: string;
+    updated_at: string;
+};
 export type TimecodeHistoryVersionObject = {
-    id: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    timekeeping_timecode_id: string;
     name: string;
     description: string | null;
     description_is_required: boolean;
@@ -1076,7 +1113,7 @@ export type TimecodeHistoryVersionObject = {
     rest_and_recovery: boolean;
     incentive_pay_eligible: boolean;
     restricted_to: 'none' | 'job' | 'non_job' | 'job_with_timecode';
-    default_for_company_id: string | null;
+    default_for_company_id: string;
     valid_from: string | null;
     valid_to: string | null;
     transaction_from: string;
@@ -1084,7 +1121,7 @@ export type TimecodeHistoryVersionObject = {
     created_at: string;
     updated_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<TimecodeResponseObject>;
+    corrections: Array<TimecodeHistoryCorrectionObject>;
 };
 /**
  * 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.
@@ -1950,7 +1987,7 @@ export type AttestationConfigResponseObject = {
     /**
      * The attestation question presented to the worker when a shift ends.
      */
-    content: string | null;
+    content: string;
     /**
      * The answer expected for a compliant shift (true or false).
      */
@@ -2028,7 +2065,7 @@ export type PayPeriodConfigResponseObject = {
     /**
      * Granularity at which payroll actuals are collected: none (not collected), base (from paystub line items), or aggregate (pre-summed totals). Null when unset.
      */
-    payroll_mode: 'none' | 'base' | 'aggregate';
+    payroll_mode: 'none' | 'base' | 'aggregate' | null;
     /**
      * Granularity at which time is tracked: none, base (individual time entries, auto-aggregated), or aggregate (day-level totals only, no entries).
      */
@@ -2036,7 +2073,7 @@ export type PayPeriodConfigResponseObject = {
     /**
      * External payroll provider this schedule integrates with: one of rippling, quickbooks_online, paychex, or gusto. Null when none.
      */
-    payroll_system: 'rippling' | 'quickbooks_online' | 'paychex' | 'gusto';
+    payroll_system: 'rippling' | 'quickbooks_online' | 'paychex' | 'gusto' | null;
     /**
      * Whether paystub line-item actuals are imported from the payroll system. Null when unset.
      */
@@ -2066,8 +2103,34 @@ export type PayPeriodConfigResponseObject = {
      */
     created_at: string;
 };
+export type PayPeriodConfigHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    timekeeping_pay_period_config_id: string;
+    company_id: string;
+    name: string;
+    frequency: 'weekly' | 'biweekly';
+    start_day_of_week: number;
+    tz_name: string;
+    currency: string;
+    status: 'synced' | 'pending' | 'failed';
+    payroll_mode: 'none' | 'base' | 'aggregate' | null;
+    time_mode: 'none' | 'base' | 'aggregate';
+    payroll_system: 'rippling' | 'quickbooks_online' | 'paychex' | 'gusto' | null;
+    actuals_enabled: boolean | null;
+    requires_external_map_contributor: boolean;
+    paid_after_holiday: boolean;
+    demo: boolean | null;
+    valid_from: string | null;
+    valid_to: string | null;
+    created_at: string;
+};
 export type PayPeriodConfigHistoryVersionObject = {
-    id: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    timekeeping_pay_period_config_id: string;
     company_id: string;
     name: string;
     frequency: 'weekly' | 'biweekly';
@@ -2075,9 +2138,9 @@ export type PayPeriodConfigHistoryVersionObject = {
     tz_name: string;
     currency: string;
     status: 'synced' | 'pending' | 'failed';
-    payroll_mode: 'none' | 'base' | 'aggregate';
+    payroll_mode: 'none' | 'base' | 'aggregate' | null;
     time_mode: 'none' | 'base' | 'aggregate';
-    payroll_system: 'rippling' | 'quickbooks_online' | 'paychex' | 'gusto';
+    payroll_system: 'rippling' | 'quickbooks_online' | 'paychex' | 'gusto' | null;
     actuals_enabled: boolean | null;
     requires_external_map_contributor: boolean;
     paid_after_holiday: boolean;
@@ -2086,7 +2149,7 @@ export type PayPeriodConfigHistoryVersionObject = {
     valid_to: string | null;
     created_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<PayPeriodConfigResponseObject>;
+    corrections: Array<PayPeriodConfigHistoryCorrectionObject>;
 };
 /**
  * Create or update a holiday on a pay schedule. name, holiday_type, and month are required; mday is required for fixed holidays and wday + week for floating holidays (enforced by model validation).
@@ -2184,7 +2247,7 @@ export type PwaCompanyUserDetailsResponseObject = {
     /**
      * Worker sex for demographic reporting: one of female, male, non_binary, or not_specified; null when unset.
      */
-    sex: 'female' | 'male' | 'non_binary' | 'not_specified';
+    sex: 'female' | 'male' | 'non_binary' | 'not_specified' | null;
     /**
      * Local business license number, when a jurisdiction requires it on certified payroll; null when unset.
      */
@@ -2204,11 +2267,11 @@ export type PwaCompanyUserDetailsResponseObject = {
     /**
      * Veteran status per US Census definitions: one of protected_veteran, not_protected_veteran, reserves, guard, or not_specified; null when unset.
      */
-    veteran_status: 'protected_veteran' | 'not_protected_veteran' | 'reserves' | 'guard' | 'not_specified';
+    veteran_status: 'protected_veteran' | 'not_protected_veteran' | 'reserves' | 'guard' | 'not_specified' | null;
     /**
      * Whether the worker is of Hispanic origin per US Census definitions: one of yes, no, or not_specified; null when unset.
      */
-    hispanic_origin: 'yes' | 'no' | 'not_specified';
+    hispanic_origin: 'yes' | 'no' | 'not_specified' | null;
     /**
      * Number of payroll withholding exemptions reported on California DIR certified payroll (eCPR), 0 to 99; null when unset.
      */
@@ -2220,11 +2283,11 @@ export type PwaCompanyUserDetailsResponseObject = {
     /**
      * Illinois DOL race classification for Illinois prevailing-wage reporting, as a single code (e.g. white, black, hispanic_or_latino); null when unset. See the schema enum for the full set.
      */
-    il_dol_race: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other';
+    il_dol_race: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other' | null;
     /**
      * Illinois SHINES employment type: one of part_time, full_time, seasonal_temporary, or independent_contract; null when unset.
      */
-    il_shines_employment_type: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract';
+    il_shines_employment_type: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract' | null;
     /**
      * Illinois SHINES Equity Eligible Person (EEP) qualifiers for the worker, as an array of codes (e.g. eep_program_completed, foster_care, formerly_incarcerated); null when unset. See the schema enum for the full set.
      */
@@ -2236,7 +2299,7 @@ export type PwaCompanyUserDetailsResponseObject = {
     /**
      * Oregon BOLI workweek schedule: five_eight (five eight-hour days) or four_ten (four ten-hour days); null when unset.
      */
-    or_boli_schedule_type: 'five_eight' | 'four_ten';
+    or_boli_schedule_type: 'five_eight' | 'four_ten' | null;
     /**
      * Oregon BOLI race classification, as an array of codes (e.g. white, asian, hispanic_or_latino, black_or_african_american); null when unset. See the schema enum for the full set.
      */
@@ -2281,7 +2344,7 @@ export type PwaCompanyUserDetailsParameters = {
     /**
      * Worker sex for demographic reporting: one of female, male, non_binary, or not_specified.
      */
-    sex?: 'female' | 'male' | 'non_binary' | 'not_specified';
+    sex?: 'female' | 'male' | 'non_binary' | 'not_specified' | null;
     /**
      * Local business license number, when a jurisdiction requires it on certified payroll.
      */
@@ -2301,11 +2364,11 @@ export type PwaCompanyUserDetailsParameters = {
     /**
      * Veteran status per US Census definitions: one of protected_veteran, not_protected_veteran, reserves, guard, or not_specified.
      */
-    veteran_status?: 'protected_veteran' | 'not_protected_veteran' | 'reserves' | 'guard' | 'not_specified';
+    veteran_status?: 'protected_veteran' | 'not_protected_veteran' | 'reserves' | 'guard' | 'not_specified' | null;
     /**
      * Whether the worker is of Hispanic origin per US Census definitions: one of yes, no, or not_specified.
      */
-    hispanic_origin?: 'yes' | 'no' | 'not_specified';
+    hispanic_origin?: 'yes' | 'no' | 'not_specified' | null;
     /**
      * Number of payroll withholding exemptions reported on California DIR certified payroll (eCPR), 0 to 99.
      */
@@ -2317,11 +2380,11 @@ export type PwaCompanyUserDetailsParameters = {
     /**
      * Illinois DOL race classification for Illinois prevailing-wage reporting, as a single code (e.g. white, black, hispanic_or_latino). See the schema enum for the full set.
      */
-    il_dol_race?: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other';
+    il_dol_race?: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other' | null;
     /**
      * Illinois SHINES employment type: one of part_time, full_time, seasonal_temporary, or independent_contract.
      */
-    il_shines_employment_type?: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract';
+    il_shines_employment_type?: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract' | null;
     /**
      * Illinois SHINES Equity Eligible Person (EEP) qualifiers for the worker, as an array of codes (e.g. eep_program_completed, foster_care, formerly_incarcerated). See the schema enum for the full set.
      */
@@ -2333,7 +2396,7 @@ export type PwaCompanyUserDetailsParameters = {
     /**
      * Oregon BOLI workweek schedule: five_eight (five eight-hour days) or four_ten (four ten-hour days).
      */
-    or_boli_schedule_type?: 'five_eight' | 'four_ten';
+    or_boli_schedule_type?: 'five_eight' | 'four_ten' | null;
     /**
      * Oregon BOLI race classification, as an array of codes (e.g. white, asian, hispanic_or_latino, black_or_african_american).
      */
@@ -2475,52 +2538,7 @@ export type JobResponseObject = {
      */
     project_id: string | null;
     /**
-     * Deprecated. The creating company as a minimal object; use created_by_company_id instead.
-     *
-     * @deprecated
-     */
-    created_by_company: {
-        /**
-         * ID of the creating company.
-         */
-        id?: string;
-        /**
-         * Name of the creating company.
-         */
-        name?: string;
-    };
-    /**
-     * Deprecated. The requesting company as a minimal object; use requested_by_company_id instead.
-     *
-     * @deprecated
-     */
-    requested_by_company: {
-        /**
-         * ID of the requesting company.
-         */
-        id?: string;
-        /**
-         * Name of the requesting company.
-         */
-        name?: string;
-    };
-    /**
-     * Deprecated. The job's primary manager as a minimal object; null when the job has no manager.
-     *
-     * @deprecated
-     */
-    manager_user: {
-        /**
-         * ID of the manager user.
-         */
-        id?: string;
-        /**
-         * Name of the manager user.
-         */
-        name?: string;
-    } | null;
-    /**
-     * The job's managers, each as a minimal object; empty when the job has no managers. This is the current field — the singular manager_user is deprecated.
+     * The job's managers, each as a minimal object; empty when the job has no managers.
      */
     manager_users: Array<{
         /**
@@ -2539,30 +2557,30 @@ export type JobResponseObject = {
         /**
          * ID of the creating user.
          */
-        id?: string;
+        id: string;
         /**
          * Name of the creating user.
          */
-        name?: string;
+        name: string;
     };
     /**
-     * Sites (geofenced locations) associated with the job; null when none.
+     * Sites (geofenced locations) associated with the job; empty when none.
      */
     sites: Array<{
         /**
          * Name of the site.
          */
-        name?: string;
+        name: string;
         /**
-         * Geofenced features within the site; null when none.
+         * Geofenced features within the site; empty when none.
          */
-        features?: Array<{
+        features: Array<{
             /**
              * Name of the feature.
              */
-            name?: string;
-        }> | null;
-    }> | null;
+            name: string;
+        }>;
+    }>;
     /**
      * The job's structured address; null when unset.
      */
@@ -2570,18 +2588,18 @@ export type JobResponseObject = {
         /**
          * Human-readable one-line address label.
          */
-        label?: string;
+        label: string;
     } | null;
     /**
-     * Positions on the job — the worker assignments that track time against it; null when none.
+     * Positions on the job — the worker assignments that track time against it; empty when none.
      */
     positions: Array<{
-        position_function?: PositionFunction;
+        position_function: PositionFunction;
         /**
          * ID of the worker assigned to the position; null when unfilled.
          */
-        fulfilled_by_user_id?: string | null;
-    }> | null;
+        fulfilled_by_user_id: string | null;
+    }>;
     /**
      * The project this job belongs to; null when none.
      */
@@ -2589,22 +2607,22 @@ export type JobResponseObject = {
         /**
          * Name of the project.
          */
-        name?: string;
+        name: string;
     } | null;
     pwa_details: PwaJobDetailsResponseObject;
     /**
-     * Work types (trade or scope categories) associated with the job; null when none.
+     * Work types (trade or scope categories) associated with the job; empty when none.
      */
     work_types: Array<{
         /**
          * The work-type name.
          */
-        value?: string;
-    }> | null;
+        value: string;
+    }>;
     /**
-     * IDs of the timecodes currently associated with the job; null when none.
+     * IDs of the timecodes currently associated with the job; empty when none.
      */
-    timekeeping_timecode_ids: Array<string> | null;
+    timekeeping_timecode_ids: Array<string>;
     /**
      * Whether the feature-allocation selector is shown for this job.
      */
@@ -2705,15 +2723,13 @@ export type JobParameters = {
      */
     description?: string;
     /**
-     * ID of the user creating the job. Required.
+     * ID of the company that requested the job (for example a general contractor). Required.
      */
-    created_by_user_id: string;
+    requested_by_company_id: string;
     /**
-     * Deprecated and ignored; set the job's managers through manager_user_ids instead.
-     *
-     * @deprecated
+     * ID of the user creating the job. Required.
      */
-    manager_user_id?: string | null;
+    created_by_user_id: string;
     /**
      * IDs of the users who manage the job; null when the job has no managers.
      */
@@ -3048,6 +3064,10 @@ export type UserResponseObject = {
      * URL of the worker's LinkedIn profile. Null when unset.
      */
     linkedin_url: string | null;
+    /**
+     * Identity of the worker's employment at your company, stable across employment versions — a title change or a raise versions the employment without changing this id. It names the employment that this object's employment fields (type through employment_window, plus manager_user_id and any employment custom fields) describe: a worker rehired after an earlier stint holds a second employment with its own id, and exactly one of them is published here.
+     */
+    employment_id: string;
     type: UserCompanyType;
     /**
      * Job title at your company. Null when unset.
@@ -3110,7 +3130,7 @@ export type UserResponseObject = {
      */
     termination_date: string | null;
     /**
-     * Window over which the employment version in this response is in effect. Employment is versioned, so a worker whose title or pay changed has several versions and exactly one is published here. The version in effect now is served; where none is in effect the nearest is served instead — most recently ended first, else soonest to open — so this window is how you tell a current employment from an ended or a not-yet-started one. Distinct from hire_date and termination_date, which bound the whole employment rather than this one version.
+     * Window over which the employment version in this response is in effect. Employment is versioned, so a worker whose title or pay changed has several versions and exactly one is published here. The version in effect now is served; where none is in effect, the soonest to begin is served, else the most recently ended — a scheduled hire outranks an ended stint — so this window is how you tell a current employment from an ended or a not-yet-started one. Distinct from hire_date and termination_date, which bound the whole employment rather than this one version.
      */
     employment_window: {
         /**
@@ -3118,7 +3138,7 @@ export type UserResponseObject = {
          */
         valid_from: string | null;
         /**
-         * When this version of the employment stopped applying (ISO 8601); null while it is still in effect. A value in the past means this is the nearest version rather than a current one.
+         * When this version of the employment stopped applying (ISO 8601); null while it is still in effect. A value in the past means an ended version is being served because the worker has nothing current or scheduled.
          */
         valid_to: string | null;
     };
@@ -3137,91 +3157,91 @@ export type UserResponseObject = {
         /**
          * Unique identifier of the compliance record.
          */
-        id?: string;
+        id: string;
         /**
          * Home street address line 1, for certified-payroll reporting. Null when unset.
          */
-        address1?: string | null;
+        address1: string | null;
         /**
          * Home street address line 2. Null when unset.
          */
-        address2?: string | null;
+        address2: string | null;
         /**
          * Home address city. Null when unset.
          */
-        city?: string | null;
+        city: string | null;
         /**
          * Home address two-letter US state code. Null when unset.
          */
-        state?: string | null;
+        state: string | null;
         /**
          * Home address ZIP code. Null when unset.
          */
-        zip?: string | null;
+        zip: string | null;
         /**
          * Worker race for demographic reporting, as an array of codes such as CAUCASIAN, AFRICAN_AMERICAN, ASIAN, NATIVE_AMERICAN, OTHER, and NOT_SPECIFIED. Null when unset.
          */
-        race?: Array<string> | null;
+        race: Array<string> | null;
         /**
          * Worker sex for demographic reporting: one of female, male, non_binary, or not_specified. Null when unset.
          */
-        sex?: string | null;
+        sex: string | null;
         /**
          * Local business license number, when a jurisdiction requires it on certified payroll. Null when unset.
          */
-        local_business_license?: string | null;
+        local_business_license: string | null;
         /**
          * Two-letter US state that issued the worker's driver's license. Null when unset.
          */
-        drivers_license_state?: string | null;
+        drivers_license_state: string | null;
         /**
          * Worker's driver's license number (stored encrypted). Null when unset.
          */
-        drivers_license_number?: string | null;
+        drivers_license_number: string | null;
         /**
          * Veteran status per US Census definitions: one of protected_veteran, not_protected_veteran, reserves, guard, or not_specified. Null when unset.
          */
-        veteran_status?: string | null;
+        veteran_status: string | null;
         /**
          * Whether the worker is of Hispanic origin per US Census definitions: one of yes, no, or not_specified. Null when unset.
          */
-        hispanic_origin?: string | null;
+        hispanic_origin: string | null;
         /**
          * Worker Social Security Number (nine digits, stored encrypted), required on certified payroll in some jurisdictions. Null when unset.
          */
-        ssn?: string | null;
+        ssn: string | null;
         /**
          * Whether the worker has a disability, for demographic reporting. Null when unset.
          */
-        disabled?: boolean | null;
+        disabled: boolean | null;
         /**
          * Number of payroll withholding exemptions reported on California DIR certified payroll (eCPR); an integer from 0 to 99. Null when unset.
          */
-        ca_dir_withholding_exemptions?: number | null;
+        ca_dir_withholding_exemptions: number | null;
         /**
          * Illinois DOL race classification for Illinois prevailing-wage reporting, as a single code such as white, black, or hispanic_or_latino. Null when unset. See the schema enum for the full set.
          */
-        il_dol_race?: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other';
+        il_dol_race: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other' | null;
         /**
          * Illinois SHINES employment type: one of part_time, full_time, seasonal_temporary, or independent_contract. Null when unset.
          */
-        il_shines_employment_type?: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract';
+        il_shines_employment_type: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract' | null;
         /**
          * Illinois SHINES Equity Eligible Person (EEP) qualifiers for the worker, as an array of codes such as eep_program_completed, foster_care, and formerly_incarcerated. Null when unset.
          */
-        il_shines_eep_qualifiers?: Array<'eep_program_completed' | 'foster_care' | 'formerly_incarcerated' | 'equity_investment_eligible_community' | 'self_registered_or_unknown'> | null;
+        il_shines_eep_qualifiers: Array<'eep_program_completed' | 'foster_care' | 'formerly_incarcerated' | 'equity_investment_eligible_community' | 'self_registered_or_unknown'> | null;
         /**
          * Illinois SHINES workforce-program participation for the worker, as an array of program codes such as solar_training_pipeline_program and craft_apprenticeship_program. Null when unset.
          */
-        il_shines_other_programs?: Array<'solar_training_pipeline_program' | 'craft_apprenticeship_program' | 'multi_cultural_jobs_program' | 'clean_jobs_workforce_network_program' | 'illinois_climate_works_prep_apprenticeship_program' | 'returning_residents_clean_jobs_training_program' | 'other'> | null;
+        il_shines_other_programs: Array<'solar_training_pipeline_program' | 'craft_apprenticeship_program' | 'multi_cultural_jobs_program' | 'clean_jobs_workforce_network_program' | 'illinois_climate_works_prep_apprenticeship_program' | 'returning_residents_clean_jobs_training_program' | 'other'> | null;
         /**
          * Oregon BOLI workweek schedule: five_eight (five eight-hour days) or four_ten (four ten-hour days). Null when unset.
          */
-        or_boli_schedule_type?: 'five_eight' | 'four_ten';
+        or_boli_schedule_type: 'five_eight' | 'four_ten' | null;
         /**
          * Oregon BOLI race classification, as an array of codes such as white, asian, hispanic_or_latino, and black_or_african_american. Null when unset.
          */
-        or_boli_race?: Array<'american_indian_or_alaska_native' | 'asian' | 'hispanic_or_latino' | 'black_or_african_american' | 'native_hawaiian_or_pacific_islander' | 'white' | 'portuguese_or_brazilian'> | null;
+        or_boli_race: Array<'american_indian_or_alaska_native' | 'asian' | 'hispanic_or_latino' | 'black_or_african_american' | 'native_hawaiian_or_pacific_islander' | 'white' | 'portuguese_or_brazilian'> | null;
     } | null;
     [key: string]: unknown;
 };
@@ -3490,11 +3510,11 @@ export type UserParameters = {
         /**
          * Illinois DOL race classification for Illinois prevailing-wage reporting, as a single code such as white, black, or hispanic_or_latino. See the schema enum for the full set.
          */
-        il_dol_race?: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other';
+        il_dol_race?: 'white' | 'black' | 'hispanic_or_latino' | 'american_indian_or_alaska_native' | 'chinese' | 'filipino' | 'asian_india' | 'vietnamese' | 'korean' | 'japanese' | 'native_hawaiian' | 'samoan' | 'chamorro' | 'other_asian' | 'other_pacific_islander' | 'other' | null;
         /**
          * Illinois SHINES employment type: one of part_time, full_time, seasonal_temporary, or independent_contract.
          */
-        il_shines_employment_type?: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract';
+        il_shines_employment_type?: 'part_time' | 'full_time' | 'seasonal_temporary' | 'independent_contract' | null;
         /**
          * Illinois SHINES Equity Eligible Person (EEP) qualifiers for the worker, as an array of codes such as eep_program_completed, foster_care, and formerly_incarcerated.
          */
@@ -3506,7 +3526,7 @@ export type UserParameters = {
         /**
          * Oregon BOLI workweek schedule: five_eight (five eight-hour days) or four_ten (four ten-hour days).
          */
-        or_boli_schedule_type?: 'five_eight' | 'four_ten';
+        or_boli_schedule_type?: 'five_eight' | 'four_ten' | null;
         /**
          * Oregon BOLI race classification, as an array of codes such as white, asian, hispanic_or_latino, and black_or_african_american.
          */
@@ -3518,12 +3538,12 @@ export type UserParameters = {
  * A page of time entries, with pagination metadata and navigation links.
  */
 export type TimeEntryIndexObject = {
-    meta?: Meta;
-    links?: Links;
+    meta: Meta;
+    links: Links;
     /**
      * The page of time entries.
      */
-    data?: Array<TimeEntryResponseObject>;
+    data: Array<TimeEntryResponseObject>;
 };
 /**
  * A single time entry: one atomic block of tracked work with its start/end times, optional timecode classification, optional job, pay rate, and manager approval status.
@@ -3580,15 +3600,15 @@ export type TimeEntryResponseObject = {
         /**
          * Straight-time minutes worked (1.0× pay multiplier).
          */
-        1?: number;
+        1: number;
         /**
          * Time-and-a-half minutes worked (1.5× pay multiplier).
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Double-time minutes worked (2.0× pay multiplier).
          */
-        2?: number;
+        2: number;
     };
     /**
      * The "1.5" (time-and-a-half) slice of the entry's incentive-pay overtime minutes, in minutes; an integer.
@@ -3599,9 +3619,9 @@ export type TimeEntryResponseObject = {
      */
     hourly_rate_cents: string | null;
     /**
-     * ISO currency code for the money fields, delegated from the time card; null when unset.
+     * ISO currency code for the money fields, delegated from the time card's pay schedule.
      */
-    currency: string | null;
+    currency: string;
     /**
      * Where the base rate came from: one of user_default, position, prevailing_wage, or custom; null when no rate is set. (The schema types this as a free-form nullable string; the value set is defined by the model enum.)
      */
@@ -3637,44 +3657,8 @@ export type TimeEntryResponseObject = {
         /**
          * Name of the allocated feature.
          */
-        name?: string;
+        name: string;
     }>;
-    /**
-     * Deprecated. The worker as a nested object with id and name; prefer user_id.
-     *
-     * @deprecated
-     */
-    user: {
-        /**
-         * Unique identifier of the time entry.
-         */
-        id?: string;
-        /**
-         * The worker's name.
-         */
-        name?: string;
-    };
-    /**
-     * Deprecated. The timecode as a nested object with id and name; null when none is set; prefer timekeeping_timecode_id.
-     *
-     * @deprecated
-     */
-    timecode: {
-        /**
-         * Unique identifier of the time entry.
-         */
-        id?: string;
-        /**
-         * The timecode's name.
-         */
-        name?: string;
-    } | null;
-    /**
-     * Deprecated. Same value as hours_worked, retained for backward compatibility.
-     *
-     * @deprecated
-     */
-    total_hours: number;
 };
 /**
  * A record of a single approval or decline action taken against a time entry.
@@ -3776,93 +3760,93 @@ export type FormDefinitionResponseObject = {
         /**
          * Unique identifier.
          */
-        id?: string;
+        id: string;
         /**
          * Human-readable name of the form.
          */
-        name?: string;
+        name: string;
         /**
          * Free-text description of the form.
          */
-        description?: string;
+        description: string;
         /**
          * ID of the company that owns this form.
          */
-        company_id?: string;
+        company_id: string;
         /**
          * ID of the user who last modified the form; null when unknown.
          */
-        modified_by_user_id?: string | null;
+        modified_by_user_id: string | null;
         /**
          * Lowercase tags on the form; null when none are set.
          */
-        tags?: Array<string> | null;
+        tags: Array<string> | null;
         /**
          * Names of the questions whose answers make up a submission's title; null when none are set.
          */
-        title_keys?: Array<string> | null;
+        title_keys: Array<string> | null;
         /**
          * Whether the form can be edited.
          */
-        editable?: boolean;
+        editable: boolean;
         /**
          * Whether the form is always shown to users.
          */
-        always_visible?: boolean;
+        always_visible: boolean;
         /**
          * Whether the form collects sensitive data.
          */
-        sensitive_form?: boolean;
+        sensitive_form: boolean;
         /**
          * Whether a user's prior answers can be carried forward into a new submission.
          */
-        allow_carry_forward?: boolean;
+        allow_carry_forward: boolean;
         /**
          * Revision number of the form's active version; null when it has no active version.
          */
-        current_revision?: number;
+        current_revision: number | null;
         /**
          * The SurveyJS form schema (questions, pages, and logic).
          */
-        json?: {
+        json: {
             [key: string]: unknown;
         };
         /**
          * When the record was created (ISO 8601).
          */
-        created_at?: string;
+        created_at: string;
     }>;
 };
 /**
  * A page of form submissions — the lighter list representation. A submission is a user's completed form; submissions are created in the app, so this API is read-only.
  */
 export type FormSubmissionIndexObject = {
-    meta?: Meta;
-    links?: Links;
+    meta: Meta;
+    links: Links;
     /**
      * The page of form submissions.
      */
-    data?: Array<{
+    data: Array<{
         /**
          * Unique identifier.
          */
-        id?: string;
+        id: string;
         /**
          * ID of the user who owns the submission.
          */
-        user_id?: string;
+        user_id: string;
         /**
          * ID of the user who last updated the submission.
          */
-        updated_by_user_id?: string;
+        updated_by_user_id: string;
         /**
          * When the record was created (ISO 8601).
          */
-        created_at?: string;
+        created_at: string;
         /**
          * When the record was last updated (ISO 8601).
          */
-        updated_at?: string;
+        updated_at: string;
     }>;
 };
 /**
@@ -3876,11 +3860,11 @@ export type FormSubmissionResponseObject = {
         /**
          * Unique identifier.
          */
-        id?: string;
+        id: string;
         /**
          * The submitting user's name.
          */
-        name?: string;
+        name: string;
     };
     /**
      * Human-readable title derived from the submission's title-key answers; null when none.
@@ -4009,6 +3993,7 @@ export type UserCompanyCreateParameters = {
      * Paid training time for the year, in minutes.
      */
     training_annual_minutes?: number | null;
+    [key: string]: unknown;
 };
 /**
  * A worker's scheduled compensation timeline at your company — the version currently in effect plus any future-dated versions.
@@ -4017,12 +4002,12 @@ export type UserCompanyScheduledChangesResponse = {
     /**
      * Id of the worker whose compensation timeline this is.
      */
-    user_id?: string;
-    current_version?: UserCompanyScheduledChange;
+    user_id: string;
+    current_version: UserCompanyScheduledChange;
     /**
      * Future-dated compensation versions, each taking effect on its start date, ordered earliest first.
      */
-    scheduled_changes?: Array<UserCompanyScheduledChange>;
+    scheduled_changes: Array<UserCompanyScheduledChange>;
 };
 /**
  * Request body for scheduling a future-dated compensation change. effective_date sets when the new values take effect; earlier history is preserved as its own version. Covers the pay, benefit, accrual, and department fields.
@@ -4306,11 +4291,11 @@ export type UserGroupResponse = {
     /**
      * Unique identifier.
      */
-    id?: string;
+    id: string;
     /**
      * ID of the user who belongs to the group.
      */
-    user_id?: string;
+    user_id: string;
 };
 /**
  * Request body for adding users to a group. The group is taken from the URL path.
@@ -4349,24 +4334,24 @@ export type FormSubmissionDeltasResponse = {
  * A page of change events (create, update, destroy) for time entries, drawn from version history; scoped by the surviving parent time card, so a destroyed entry's history stays visible.
  */
 export type TimeEntryDeltasResponse = {
-    meta?: DeltaMeta;
-    links?: Links;
+    meta: DeltaMeta;
+    links: Links;
     /**
      * The page of time-entry change events.
      */
-    data?: Array<{
+    data: Array<{
         /**
          * The change this event records: one of create, update, or destroy.
          */
-        event?: 'create' | 'update' | 'destroy';
+        event: 'create' | 'update' | 'destroy';
         /**
          * ID of the time entry this event applies to — the entry's own id, not a version-record id; for a destroy event, the id of the now-deleted entry.
          */
-        id?: string;
+        id: string;
         /**
          * When this event occurred (ISO 8601).
          */
-        timestamp?: string;
+        timestamp: string;
     }>;
 };
 /**
@@ -4380,55 +4365,55 @@ export type UserCompanyScheduledChange = {
     /**
      * Unique identifier of this employment version.
      */
-    id?: string;
+    id: string;
     /**
      * Date this version takes effect (ISO 8601). For a scheduled change this equals the effective_date that created it.
      */
-    start_date?: string;
+    start_date: string;
     /**
      * Base pay rate for this version, formatted as a currency string; null when unset.
      */
-    hourly_rate?: string | null;
+    hourly_rate: string | null;
     /**
      * How the worker is paid: hourly or salary.
      */
-    compensation_type?: string;
+    compensation_type: string;
     /**
      * Whether the worker is eligible for overtime pay in this version.
      */
-    overtime_eligible?: boolean;
+    overtime_eligible: boolean;
     /**
      * Annual training-fund contribution, formatted as a currency string; null when unset.
      */
-    training_annual_amount?: string | null;
+    training_annual_amount: string | null;
     /**
      * Employer-paid annual combined health benefit, formatted as a currency string; null when unset.
      */
-    employer_combined_health_amount?: string | null;
+    employer_combined_health_amount: string | null;
     /**
      * Employer-paid annual combined savings and retirement benefit, formatted as a currency string; null when unset.
      */
-    employer_combined_savings?: string | null;
+    employer_combined_savings: string | null;
     /**
      * Annualized minutes the worker is expected to work in this version; null when unset.
      */
-    worked_annual_minutes?: number | null;
+    worked_annual_minutes: number | null;
     /**
      * Paid time off accrued for the year, in minutes; null when unset.
      */
-    pto_annual_minutes?: number | null;
+    pto_annual_minutes: number | null;
     /**
      * Holiday time accrued for the year, in minutes; null when unset.
      */
-    holiday_annual_minutes?: number | null;
+    holiday_annual_minutes: number | null;
     /**
      * Paid training time for the year, in minutes; null when unset.
      */
-    training_annual_minutes?: number | null;
+    training_annual_minutes: number | null;
     /**
      * Id of the department the worker is assigned to in this version; null when none.
      */
-    companies_department_id?: string | null;
+    companies_department_id: string | null;
 };
 /**
  * Request body for scheduling the end of a worker's employment at your company. Sets the employment's end date; cancel the scheduled termination to restore open-ended employment. Deleting the employment record instead (DELETE on the membership) removes it entirely and is not reversible.
@@ -4452,39 +4437,39 @@ export type PayPeriodsResponseObject = {
         /**
          * Unique identifier.
          */
-        id?: string;
+        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;
+        timekeeping_pay_period_config_id: string;
         /**
          * Calendar date (YYYY-MM-DD) that workers are paid for this period.
          */
-        pay_date?: string;
+        pay_date: string;
         /**
          * Start of the pay-period window (ISO 8601).
          */
-        start_time?: string;
+        start_time: string;
         /**
          * End of the pay-period window (ISO 8601).
          */
-        end_time?: string;
+        end_time: string;
         /**
          * When payroll must be run for this period (ISO 8601).
          */
-        pay_run_deadline?: string;
+        pay_run_deadline: string;
         /**
          * When time-card approvals are due for this period (ISO 8601).
          */
-        approvals_deadline?: string;
+        approvals_deadline: string;
         /**
          * When the record was created (ISO 8601).
          */
-        created_at?: string;
+        created_at: string;
         /**
          * When the record was last updated (ISO 8601).
          */
-        updated_at?: string;
+        updated_at: string;
     }>;
 };
 /**
@@ -4574,15 +4559,15 @@ export type TimeCardResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Incentive-pay-eligible overtime minutes bucketed by pay-rate multiplier.
@@ -4591,15 +4576,15 @@ export type TimeCardResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Total pay for the period in integer cents, as a decimal string.
@@ -4697,15 +4682,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Incentive-pay-eligible overtime minutes bucketed by pay-rate multiplier.
@@ -4714,15 +4699,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Total pay for this date in integer cents, as a decimal string.
@@ -4831,15 +4816,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Week-to-date running total of overtime minutes bucketed by pay-rate multiplier, through this date.
@@ -4848,15 +4833,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Pay-period-to-date running total of incentive-pay overtime minutes bucketed by pay-rate multiplier, through this date.
@@ -4865,15 +4850,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Week-to-date running total of incentive-pay overtime minutes bucketed by pay-rate multiplier, through this date.
@@ -4882,15 +4867,15 @@ export type JobTimeCardDayResponseObject = {
         /**
          * Minutes at the 1.0x (straight-time) pay-rate multiplier.
          */
-        1?: number;
+        1: number;
         /**
          * Minutes at the 1.5x (time-and-a-half) overtime multiplier.
          */
-        1.5?: number;
+        1.5: number;
         /**
          * Minutes at the 2.0x (double-time) overtime multiplier.
          */
-        2?: number;
+        2: number;
     };
     /**
      * Pay-period-to-date running total of total pay in integer cents, as a decimal string, through this date.
@@ -5102,7 +5087,7 @@ export type PayrollFringeBenefitPlanResponseObject = {
     /**
      * Which employer contribution this plan covers: one of employer_combined_health, employer_combined_savings, employer_combined_holiday_pto, employer_training, or employer_other_contributions. Null when unset.
      */
-    benefit_category: 'employer_combined_health' | 'employer_combined_savings' | 'employer_combined_holiday_pto' | 'employer_training' | 'employer_other_contributions';
+    benefit_category: 'employer_combined_health' | 'employer_combined_savings' | 'employer_combined_holiday_pto' | 'employer_training' | 'employer_other_contributions' | null;
     /**
      * Whether this is a jointly-managed (Taft-Hartley) fund, which is exempt from the detailed Illinois fund fields.
      */
@@ -5244,7 +5229,7 @@ export type PayrollExternalMapResponseObject = {
     /**
      * Who the amount is attributed to: one of any, employee, or employer. Null when unset.
      */
-    contributor: 'any' | 'employee' | 'employer';
+    contributor: 'any' | 'employee' | 'employer' | null;
     /**
      * Number of pay periods per year, used to annualize this element's amounts.
      */
@@ -5282,15 +5267,40 @@ export type PayrollExternalMapResponseObject = {
      */
     updated_at: string;
 };
+export type PayrollExternalMapHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    payrolls_external_map_id: string;
+    name: string;
+    payrolls_compensation_element_id: string;
+    compensation_element_name: string;
+    compensation_element_category: 'tax' | 'health' | 'retirement' | 'insurance' | 'earning' | 'garnishment' | 'other';
+    timekeeping_pay_period_config_id: string | null;
+    payrolls_fringe_benefit_plan_id: string | null;
+    contributor: 'any' | 'employee' | 'employer' | null;
+    annual_periods: number;
+    created_by_user_id: string | null;
+    global: boolean;
+    valid_from: string | null;
+    valid_to: string | null;
+    transaction_from: string;
+    transaction_to: string | null;
+    created_at: string;
+    updated_at: string;
+};
 export type PayrollExternalMapHistoryVersionObject = {
-    id: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    payrolls_external_map_id: string;
     name: string;
     payrolls_compensation_element_id: string;
     compensation_element_name: string;
     compensation_element_category: 'tax' | 'health' | 'retirement' | 'insurance' | 'earning' | 'garnishment' | 'other';
     timekeeping_pay_period_config_id: string | null;
     payrolls_fringe_benefit_plan_id: string | null;
-    contributor: 'any' | 'employee' | 'employer';
+    contributor: 'any' | 'employee' | 'employer' | null;
     annual_periods: number;
     created_by_user_id: string | null;
     global: boolean;
@@ -5301,7 +5311,7 @@ export type PayrollExternalMapHistoryVersionObject = {
     created_at: string;
     updated_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<PayrollExternalMapResponseObject>;
+    corrections: Array<PayrollExternalMapHistoryCorrectionObject>;
 };
 /**
  * A payroll run — a record of one payroll-processing event, synced from an external payroll system or reported to DSPTCH (never a run DSPTCH itself initiates). Paystubs belong to a run.
@@ -5725,7 +5735,7 @@ export type FeatureResponseObject = {
      */
     geometry: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * When the feature became active.
      */
@@ -5817,9 +5827,9 @@ export type ComplianceCheckResponseObject = {
      */
     user_id: string | null;
     /**
-     * UID of the employment (user-company) this check applies to; set only when type is "Compliances::UserCompanyCheck", else null.
+     * ID of the employment (user-company) this check applies to, stable across all of its versions; set only when type is "Compliances::UserCompanyCheck", else null.
      */
-    user_company_uid: string | null;
+    employment_id: string | null;
     /**
      * From the check's requirement.
      */
@@ -5839,7 +5849,7 @@ export type ComplianceCheckResponseObject = {
     /**
      * Urgency of the requirement: one of critical, high, medium, or low; null when the requirement sets no priority.
      */
-    priority: 'critical' | 'high' | 'medium' | 'low';
+    priority: 'critical' | 'high' | 'medium' | 'low' | null;
     /**
      * When the check was last evaluated (ISO 8601); null when never evaluated.
      */
@@ -6229,7 +6239,7 @@ export type PaystubLineItemResponseObject = {
      */
     id: string;
     /**
-     * ID (bitemporal identity) of the external map that defines what this line item represents.
+     * ID of the external map that defines what this line item represents — the identity every version of the map shares.
      */
     payrolls_external_map_id: string;
     /**
@@ -6251,23 +6261,23 @@ export type PaystubLineItemResponseObject = {
         /**
          * The external system's field name for the mapped compensation element.
          */
-        name?: string;
+        name: string;
         /**
          * The DSPTCH compensation element the external map points to.
          */
-        compensation_element?: {
+        compensation_element: {
             /**
              * Name of the compensation element (e.g. "401(k)").
              */
-            name?: string;
+            name: string;
             /**
              * Free-text description of the compensation element; null when none.
              */
-            description?: string | null;
+            description: string | null;
             /**
              * Internal categorization of the compensation element: one of tax, health, retirement, insurance, earning, garnishment, or other.
              */
-            category?: 'tax' | 'health' | 'retirement' | 'insurance' | 'earning' | 'garnishment' | 'other';
+            category: 'tax' | 'health' | 'retirement' | 'insurance' | 'earning' | 'garnishment' | 'other';
         };
     };
     /**
@@ -6370,13 +6380,13 @@ export type PositionResponseObject = {
      */
     pwa: boolean;
     /**
-     * UIDs of the federal (Davis-Bacon) wage determinations applied to this position; empty when none.
+     * IDs of the federal (Davis-Bacon) wage determinations applied to this position; empty when none.
      */
-    federal_wage_determination_uids: Array<string>;
+    federal_wage_determination_ids: Array<string>;
     /**
-     * UIDs of the regional (state) wage determinations applied to this position; empty when none.
+     * IDs of the regional (state) wage determinations applied to this position; empty when none.
      */
-    regional_wage_determination_uids: Array<string>;
+    regional_wage_determination_ids: Array<string>;
     /**
      * PWA classification detail for this position; carries skill_level, the apprenticeship or skill classification, which is null when unset.
      */
@@ -6385,7 +6395,7 @@ export type PositionResponseObject = {
          * The apprenticeship or skill classification; null when unset.
          */
         skill_level: string | null;
-    } | null;
+    };
     /**
      * Start of the position's scheduled window (ISO 8601); null when unscheduled.
      */
@@ -6467,7 +6477,7 @@ export type PositionParameters = {
      */
     wage_adder_rate_cents?: number | null;
     /**
-     * Wage determinations to attach or detach, each by job_wage_determination_uid (with the join record id when updating or removing an existing one).
+     * Wage determinations to attach, each by job_wage_determination_id (with the join record id when updating an existing attachment). Detaching is not available through this API.
      */
     job_wage_determinations_positions_attributes?: Array<{
         /**
@@ -6475,9 +6485,9 @@ export type PositionParameters = {
          */
         id?: number | null;
         /**
-         * UID of the job wage determination to attach or detach.
+         * ID of the job wage determination to attach.
          */
-        job_wage_determination_uid?: string | null;
+        job_wage_determination_id?: string | null;
     }>;
     /**
      * PWA classification detail to set; skill_level sets the apprenticeship or skill classification.
@@ -6735,51 +6745,51 @@ export type FormAssignmentTaskResponseObject = Array<{
     /**
      * Unique identifier of the assignment task.
      */
-    id?: string;
+    id: string;
     /**
      * ID of the form being assigned.
      */
-    form_definition_id?: string;
+    form_definition_id: string;
     /**
      * Recurrence frequency (e.g. DAILY, WEEKLY); null when the assignment does not recur.
      */
-    frequency?: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY';
+    frequency: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | null;
     /**
      * When the recurrence stops (ISO 8601); null when the assignment does not recur.
      */
-    recurrence_end_time?: string | null;
+    recurrence_end_time: string | null;
     /**
      * When the assigned form is due (ISO 8601).
      */
-    time_due?: string;
+    time_due: string;
     /**
      * Timezone for the due time.
      */
-    tz_name?: string;
+    tz_name: string;
     /**
      * Display name of the task; falls back to the form's name.
      */
-    name?: string;
+    name: string;
     /**
      * Free-text task description; null when none.
      */
-    description?: string | null;
+    description: string | null;
     /**
      * IDs of the users the form is assigned to.
      */
-    task_assignee_user_ids?: Array<string>;
+    task_assignee_user_ids: Array<string>;
     /**
      * Reminder schedule for the assignment.
      */
-    reminders?: Array<{
+    reminders: Array<{
         /**
          * Lead time before the due time, as an ISO 8601 duration.
          */
-        offset?: string;
+        offset: string;
         /**
          * Absolute time the reminder fires (ISO 8601).
          */
-        remind_at?: string;
+        remind_at: string;
     }>;
 }>;
 /**
@@ -6975,12 +6985,12 @@ export type UserCertificationParameters = {
  * A page of certifications held by your company's workers.
  */
 export type UserCertificationsResponseObj = {
-    meta?: Meta;
-    links?: Links;
+    meta: Meta;
+    links: Links;
     /**
      * The page of held certifications.
      */
-    data?: Array<UserCertificationResponseObject>;
+    data: Array<UserCertificationResponseObject>;
 };
 /**
  * A certification held by a worker — the record that a worker earned a certification, with its receipt date, optional expiry, and verification state.
@@ -7054,15 +7064,15 @@ export type PositionFunction = {
     /**
      * Unique identifier.
      */
-    id?: string;
+    id: string;
     /**
      * The function name (e.g. "Electrician", "Foreman").
      */
-    value?: string;
+    value: string;
     /**
      * Free-text description of what the function covers.
      */
-    description?: string;
+    description: string;
 } | null;
 /**
  * Request body for granting a user a role in a company.
@@ -7088,24 +7098,24 @@ export type UserRoleResponse = {
     /**
      * Unique identifier.
      */
-    id?: string;
+    id: string;
     /**
      * ID of the user who holds the role.
      */
-    user_id?: string;
+    user_id: string;
     /**
      * ID of the company the role is scoped to.
      */
-    company_id?: string;
+    company_id: string;
     /**
      * The granted role: one of TECHNICIAN, FIELD_LEAD, MANAGER, SAFETY_MANAGER, or ADMIN.
      */
-    role?: 'TECHNICIAN' | 'FIELD_LEAD' | 'MANAGER' | 'SAFETY_MANAGER' | 'ADMIN';
+    role: 'TECHNICIAN' | 'FIELD_LEAD' | 'MANAGER' | 'SAFETY_MANAGER' | 'ADMIN';
 };
 /**
  * Employment classification of a worker at a company: EMPLOYEE (W-2) or CONTRACTOR (1099). Null when unset.
  */
-export type UserCompanyType = 'EMPLOYEE' | 'CONTRACTOR';
+export type UserCompanyType = 'EMPLOYEE' | 'CONTRACTOR' | null;
 /**
  * Keyset pagination cursors for the collection.
  */
@@ -7113,17 +7123,17 @@ export type Page = {
     /**
      * Opaque cursor to send back as `page[cursor]` to fetch the next page; null when there are no more pages.
      */
-    next_cursor?: string | null;
+    next_cursor: string | null;
     /**
      * Opaque cursor for the page just returned; null on the first page.
      */
-    current_cursor?: string | null;
+    current_cursor: string | null;
 };
 /**
  * Pagination metadata for a paged collection, holding the keyset cursors under `page`.
  */
 export type Meta = {
-    page?: Page;
+    page: Page;
 };
 /**
  * Pagination metadata for a change-feed page, with the feed's safe polling watermark.
@@ -7142,15 +7152,15 @@ export type Links = {
     /**
      * URL of the current request, echoing the path and query that produced this page.
      */
-    self?: string;
+    self: string;
     /**
      * URL of the collection's first page.
      */
-    first?: string | null;
+    first: string | null;
     /**
      * URL of the next page, already carrying its `page[cursor]`; null when this is the last page.
      */
-    next?: string | null;
+    next: string | null;
 };
 /**
  * A timestamp range filter on a date/time field, supplied as `filter[field][gte]` and/or `filter[field][lte]`; omit or null a bound for an open-ended range.
@@ -7170,13 +7180,9 @@ export type DateTimeFilter = {
  */
 export type WageDeterminationResponseObject = {
     /**
-     * Unique identifier.
+     * Identifier of this determination record — permanent, because the record is an immutable DOL publication; a DOL revision arrives as a new record linked through superseded_by_wage_determination_id, not a rewrite of this one.
      */
     id: string;
-    /**
-     * Stable identifier shared by every temporal version of this determination; the id changes with each version, the uid does not.
-     */
-    uid: string;
     /**
      * DOL general decision number identifying this determination (e.g. "CA20240001"); combine with modification_number for the full versioned identifier (e.g. "CA20240001/1").
      */
@@ -7298,13 +7304,9 @@ export type JobWageDeterminationResponseObject = ({
  */
 export type FederalJobWageDeterminationResponseObject = {
     /**
-     * Unique identifier.
+     * Identifier of the determination, stable across every one of its temporal versions — it addresses the determination itself, not the version you happen to be reading, and is what the member and history paths take.
      */
     id: string;
-    /**
-     * Stable identifier shared by every temporal version of this determination; the id changes with each version, the uid does not.
-     */
-    uid: string;
     /**
      * ID of the job this wage determination applies to.
      */
@@ -7336,7 +7338,7 @@ export type FederalJobWageDeterminationResponseObject = {
     /**
      * Broad DOL construction category — one of building, heavy, highway, or residential; null when not recorded.
      */
-    construction_category: 'building' | 'heavy' | 'highway' | 'residential';
+    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.
      */
@@ -7363,13 +7365,9 @@ export type FederalJobWageDeterminationResponseObject = {
  */
 export type RegionalJobWageDeterminationResponseObject = {
     /**
-     * Unique identifier.
+     * Identifier of the determination, stable across every one of its temporal versions — it addresses the determination itself, not the version you happen to be reading, and is what the member and history paths take.
      */
     id: string;
-    /**
-     * Stable identifier shared by every temporal version of this determination; the id changes with each version, the uid does not.
-     */
-    uid: string;
     /**
      * ID of the job this wage determination applies to.
      */
@@ -7398,7 +7396,7 @@ export type RegionalJobWageDeterminationResponseObject = {
      * 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;
+    regional_fields: RegionalWageDeterminationFieldsResponse;
     /**
      * Valid time — when this version of the determination took effect (ISO 8601); null when the version has no recorded start.
      */
@@ -7422,8 +7420,10 @@ export type JobWageDeterminationHistoryVersionObject = ({
     type: 'Pwa::JobWageDeterminations::Regional';
 } & RegionalJobWageDeterminationHistoryVersionObject);
 export type FederalJobWageDeterminationHistoryVersionObject = {
-    id: string;
-    uid: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    job_wage_determination_id: string;
     job_id: string;
     pwa_trade_id: string;
     type: 'Pwa::JobWageDeterminations::Federal';
@@ -7431,18 +7431,20 @@ export type FederalJobWageDeterminationHistoryVersionObject = {
     hourly_rate_cents: string;
     fringe_rate_cents: string;
     class_code: string | null;
-    construction_category: 'building' | 'heavy' | 'highway' | 'residential';
+    construction_category: 'building' | 'heavy' | 'highway' | 'residential' | null;
     general_wage_determination: string | null;
     valid_from: string | null;
     valid_to: string | null;
     created_at: string;
     updated_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<JobWageDeterminationResponseObject>;
+    corrections: Array<JobWageDeterminationHistoryCorrectionObject>;
 };
 export type RegionalJobWageDeterminationHistoryVersionObject = {
-    id: string;
-    uid: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    job_wage_determination_id: string;
     job_id: string;
     pwa_trade_id: string;
     type: 'Pwa::JobWageDeterminations::Regional';
@@ -7450,18 +7452,116 @@ export type RegionalJobWageDeterminationHistoryVersionObject = {
     hourly_rate_cents: string;
     fringe_rate_cents: string;
     general_wage_determination: string | null;
-    regional_fields: RegionalWageDeterminationFields;
+    regional_fields: RegionalWageDeterminationFieldsResponse;
     valid_from: string | null;
     valid_to: string | null;
     created_at: string;
     updated_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<JobWageDeterminationResponseObject>;
+    corrections: Array<JobWageDeterminationHistoryCorrectionObject>;
+};
+export type JobWageDeterminationHistoryCorrectionObject = ({
+    type: 'Pwa::JobWageDeterminations::Federal';
+} & FederalJobWageDeterminationHistoryCorrectionObject) | ({
+    type: 'Pwa::JobWageDeterminations::Regional';
+} & RegionalJobWageDeterminationHistoryCorrectionObject);
+export type FederalJobWageDeterminationHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    job_wage_determination_id: string;
+    job_id: string;
+    pwa_trade_id: string;
+    type: 'Pwa::JobWageDeterminations::Federal';
+    labor_classification: string;
+    hourly_rate_cents: string;
+    fringe_rate_cents: string;
+    class_code: string | null;
+    construction_category: 'building' | 'heavy' | 'highway' | 'residential' | null;
+    general_wage_determination: string | null;
+    valid_from: string | null;
+    valid_to: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type RegionalJobWageDeterminationHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    job_wage_determination_id: string;
+    job_id: string;
+    pwa_trade_id: string;
+    type: 'Pwa::JobWageDeterminations::Regional';
+    labor_classification: string;
+    hourly_rate_cents: string;
+    fringe_rate_cents: string;
+    general_wage_determination: string | null;
+    regional_fields: RegionalWageDeterminationFieldsResponse;
+    valid_from: string | null;
+    valid_to: string | null;
+    created_at: string;
+    updated_at: string;
 };
 /**
  * State-specific rate fields for a Regional determination, as decimal-string money in cents
- * (e.g. "538.0"). Which keys appear is set by the job's region, not the request, so this object is
- * always a subset of the keys below — never a fixed shape:
+ * (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
+ * a region-determined subset of the nine keys the write side accepts — never a fixed shape:
  *
  * - Categorized-fringe regions (currently IL) carry `combined_health_fringe_rate_cents`,
  * `combined_savings_fringe_rate_cents`, `combined_holiday_pto_fringe_rate_cents`,
@@ -7471,12 +7571,10 @@ export type RegionalJobWageDeterminationHistoryVersionObject = {
  * `two_x_fringe_adder_rate_cents`.
  * - A region with neither returns an empty object.
  *
- * On write the same applicability governs the request — sending a key the job's region does not
- * allow returns a 422. Categorized-fringe values are non-null when present; overtime-adder values
- * may be null.
+ * Categorized-fringe values are non-null when present; overtime-adder values may be null.
  *
  */
-export type RegionalWageDeterminationFields = {
+export type RegionalWageDeterminationFieldsResponse = {
     [key: string]: string | null;
 };
 /**
@@ -7518,7 +7616,7 @@ export type FederalJobWageDeterminationParameters = {
     /**
      * Broad DOL construction category — one of building, heavy, highway, or residential; null when not recorded.
      */
-    construction_category?: 'building' | 'heavy' | 'highway' | 'residential';
+    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.
      */
@@ -7674,15 +7772,11 @@ export type RateRuleCondition = ({
  */
 export type RateRuleResponseObject = {
     /**
-     * Unique identifier.
+     * Identity shared by every version of the rule, never a per-version row id — the value the member and history paths address the rule by.
      */
     id: string;
     /**
-     * Stable identifier shared across temporal versions of the rule; the id changes with each version, the uid does not.
-     */
-    uid: string;
-    /**
-     * ID of the job wage determination this rule is applied to, taken from the request path. Because rules attach to a shared package, the same rule can surface under more than one determination.
+     * ID of the job wage determination this rule is applied to, taken from the request path — the determination's own family identifier, stable across its temporal versions. Because rules attach to a shared package, the same rule can surface under more than one determination.
      */
     job_wage_determination_id: string;
     /**
@@ -7711,9 +7805,25 @@ export type RateRuleResponseObject = {
      */
     updated_at: string;
 };
+export type RateRuleHistoryCorrectionObject = {
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    pay_rates_rule_id: string;
+    job_wage_determination_id: string;
+    pay_rates_rule_package_id: string;
+    effect: RateRuleEffect;
+    conditions: Array<RateRuleCondition>;
+    valid_from: string | null;
+    valid_to: string | null;
+    created_at: string;
+    updated_at: string;
+};
 export type RateRuleHistoryVersionObject = {
-    id: string;
-    uid: string;
+    /**
+     * Family key shared by every entry on this timeline — the same identity the member route addresses. An entry carries no identifier of its own; versions are distinguished by their window coordinates.
+     */
+    pay_rates_rule_id: string;
     job_wage_determination_id: string;
     pay_rates_rule_package_id: string;
     effect: RateRuleEffect;
@@ -7723,7 +7833,7 @@ export type RateRuleHistoryVersionObject = {
     created_at: string;
     updated_at: string;
     version_status: 'scheduled' | 'current' | 'historical';
-    corrections: Array<RateRuleResponseObject>;
+    corrections: Array<RateRuleHistoryCorrectionObject>;
 };
 /**
  * Create a rate rule on a job wage determination. `effect` is required. `conditions` is optional — an omitted or empty list makes the rule always apply. `effective_date` (YYYY-MM-DD) sets when the rule takes effect; it defaults to today and cannot predate the earliest applicable wage determination.
@@ -7774,7 +7884,7 @@ export type AssetsItemResponseObject = {
     /**
      * Lifecycle status of the item: one of available, assigned, or retired.
      */
-    status: 'available' | 'assigned' | 'retired';
+    status: 'available' | 'assigned' | 'retired' | null;
     /**
      * When the item was purchased (ISO 8601).
      */
@@ -8038,7 +8148,7 @@ export type AssetsFormAssignmentTriggerResponseObject = {
     /**
      * How often the generated form recurs: one of DAILY, WORKDAILY, WORKDAILYSIX, WEEKLY, BIWEEKLY, MONTHLY, or QUARTERLY. Null for a one-time assignment.
      */
-    recurrence_frequency: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY';
+    recurrence_frequency: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | null;
     /**
      * How the first due date is set: day_of_event (the day the rule fires), day_of_week (the next day_of_week_due), or day_of_month (day_of_month_due of the current or next month).
      */
@@ -8111,7 +8221,7 @@ export type AssetsFormAssignmentTriggerParameters = {
     /**
      * How often the generated form recurs: one of DAILY, WORKDAILY, WORKDAILYSIX, WEEKLY, BIWEEKLY, MONTHLY, or QUARTERLY. Null for a one-time assignment.
      */
-    recurrence_frequency?: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY';
+    recurrence_frequency?: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | null;
     /**
      * Day of week the form is first due, 0 (Sunday) to 6 (Saturday). Required when first_due_by is day_of_week; null otherwise.
      */
@@ -8148,7 +8258,7 @@ export type AssetsAttachmentResponseObject = {
         /**
          * MIME type of the file; null when not recorded.
          */
-        content_type?: string | null;
+        content_type: string | null;
         /**
          * Size of the file in bytes.
          */
@@ -8227,7 +8337,7 @@ export type AssetsDocumentResponseObject = {
         /**
          * MIME type of the file; null when not recorded.
          */
-        content_type?: string | null;
+        content_type: string | null;
         /**
          * Size of the file in bytes.
          */
@@ -8313,9 +8423,9 @@ export type AssetsItemFormAssignmentResponseObject = {
      */
     description: string | null;
     /**
-     * IANA time zone in which time_due is interpreted; null for an unscheduled task.
+     * IANA time zone in which time_due is interpreted; always set, defaulting to US/Central.
      */
-    tz_name: string | null;
+    tz_name: string;
     /**
      * When the form task is due (ISO 8601), interpreted in tz_name; null for an unscheduled task.
      */
@@ -8323,7 +8433,7 @@ export type AssetsItemFormAssignmentResponseObject = {
     /**
      * How often this form task recurs: one of DAILY, WORKDAILY, WORKDAILYSIX, WEEKLY, BIWEEKLY, MONTHLY, or QUARTERLY. Null for a one-time assignment; on write, applied only when recurring is true.
      */
-    frequency: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY';
+    frequency: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | null;
     /**
      * When recurrence stops (ISO 8601); null for a non-recurring or open-ended task.
      */
@@ -8339,11 +8449,11 @@ export type AssetsItemFormAssignmentResponseObject = {
         /**
          * ISO 8601 duration offset from the due time for the reminder (e.g. -PT1H for one hour before); must be one of the preset reminder times.
          */
-        offset?: string;
+        offset: string;
         /**
          * When the reminder fires (ISO 8601), computed as the due time plus the offset.
          */
-        remind_at?: string | null;
+        remind_at: string;
     }>;
 };
 /**
@@ -8389,7 +8499,7 @@ export type AssetsItemFormAssignmentParameters = {
         /**
          * How often this form task recurs: one of DAILY, WORKDAILY, WORKDAILYSIX, WEEKLY, BIWEEKLY, MONTHLY, or QUARTERLY. Null for a one-time assignment; on write, applied only when recurring is true.
          */
-        frequency?: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY';
+        frequency?: 'DAILY' | 'WORKDAILY' | 'WORKDAILYSIX' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | null;
         /**
          * When recurrence stops (ISO 8601); null for a non-recurring or open-ended task.
          */
@@ -13367,6 +13477,10 @@ export type CreateGroupData = {
     url: '/api/v1/groups';
 };
 export type CreateGroupErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -13445,6 +13559,10 @@ export type UpdateGroupData = {
     url: '/api/v1/groups/{id}';
 };
 export type UpdateGroupErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -13671,16 +13789,16 @@ export type ListRateRuleHistoryData = {
     body?: never;
     path: {
         job_id: string;
-        wage_determination_uid: string;
+        wage_determination_id: string;
         /**
-         * The rule's version-stable identity, as returned in `uid`.
+         * The rule's version-stable identity, as returned in `id`.
          */
-        rate_rule_uid: string;
+        rate_rule_id: string;
     };
     query?: {
         'as_of[valid]'?: string;
     };
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_uid}/rate_rules/{rate_rule_uid}/history';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_id}/rate_rules/{rate_rule_id}/history';
 };
 export type ListRateRuleHistoryErrors = {
     /**
@@ -13712,7 +13830,7 @@ export type ListRateRulesData = {
     body?: never;
     path: {
         job_id: string;
-        wage_determination_uid: string;
+        wage_determination_id: string;
     };
     query?: {
         /**
@@ -13724,7 +13842,7 @@ export type ListRateRulesData = {
         'as_of[valid][gte]'?: string;
         'as_of[transaction]'?: string;
     };
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_uid}/rate_rules';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_id}/rate_rules';
 };
 export type ListRateRulesErrors = {
     /**
@@ -13756,10 +13874,10 @@ export type CreateRateRuleData = {
     body: RateRuleParameters;
     path: {
         job_id: string;
-        wage_determination_uid: string;
+        wage_determination_id: string;
     };
     query?: never;
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_uid}/rate_rules';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_id}/rate_rules';
 };
 export type CreateRateRuleErrors = {
     /**
@@ -13783,8 +13901,8 @@ export type GetRateRuleData = {
     body?: never;
     path: {
         job_id: string;
-        wage_determination_uid: string;
-        uid: string;
+        wage_determination_id: string;
+        id: string;
     };
     query?: {
         /**
@@ -13792,7 +13910,7 @@ export type GetRateRuleData = {
          */
         'as_of[valid]'?: string;
     };
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_uid}/rate_rules/{uid}';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_id}/rate_rules/{id}';
 };
 export type GetRateRuleErrors = {
     /**
@@ -13817,14 +13935,14 @@ export type ListJobWageDeterminationHistoryData = {
     path: {
         job_id: string;
         /**
-         * The determination's version-stable identity, as returned in `uid`.
+         * The determination's version-stable identity, as returned in `id`.
          */
-        wage_determination_uid: string;
+        wage_determination_id: string;
     };
     query?: {
         'as_of[valid]'?: string;
     };
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_uid}/history';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{wage_determination_id}/history';
 };
 export type ListJobWageDeterminationHistoryErrors = {
     /**
@@ -13931,10 +14049,10 @@ export type DeleteWageDeterminationData = {
     };
     path: {
         job_id: string;
-        uid: string;
+        id: string;
     };
     query?: never;
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{uid}';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{id}';
 };
 export type DeleteWageDeterminationErrors = {
     /**
@@ -13970,7 +14088,7 @@ export type GetJobWageDeterminationData = {
     body?: never;
     path: {
         job_id: string;
-        uid: string;
+        id: string;
     };
     query?: {
         /**
@@ -13978,7 +14096,7 @@ export type GetJobWageDeterminationData = {
          */
         'as_of[valid]'?: string;
     };
-    url: '/api/v1/jobs/{job_id}/wage_determinations/{uid}';
+    url: '/api/v1/jobs/{job_id}/wage_determinations/{id}';
 };
 export type GetJobWageDeterminationErrors = {
     /**
@@ -15173,6 +15291,10 @@ export type CreatePerDiemData = {
     url: '/api/v1/per_diems';
 };
 export type CreatePerDiemErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -15264,6 +15386,10 @@ export type UpdatePerDiemData = {
     url: '/api/v1/per_diems/{id}';
 };
 export type UpdatePerDiemErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -15327,6 +15453,10 @@ export type CreatePositionFunctionData = {
     url: '/api/v1/position_functions';
 };
 export type CreatePositionFunctionErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -15409,6 +15539,10 @@ export type UpdatePositionFunctionData = {
     url: '/api/v1/position_functions/{id}';
 };
 export type UpdatePositionFunctionErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -16014,6 +16148,10 @@ export type CreatePositionData = {
     url: '/api/v1/jobs/{job_id}/positions';
 };
 export type CreatePositionErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -16041,6 +16179,10 @@ export type UpdatePositionData = {
     url: '/api/v1/jobs/{job_id}/positions/{id}';
 };
 export type UpdatePositionErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -16590,6 +16732,10 @@ export type CreateTimeEntryData = {
     url: '/api/v1/time_entries';
 };
 export type CreateTimeEntryErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -16648,6 +16794,10 @@ export type UpdateTimeEntryData = {
     url: '/api/v1/time_entries/{id}';
 };
 export type UpdateTimeEntryErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -17484,6 +17634,10 @@ export type CreateHolidayData = {
     url: '/api/v1/timekeeping/pay_period_configs/{pay_period_config_id}/holidays';
 };
 export type CreateHolidayErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */
@@ -17544,6 +17698,10 @@ export type UpdateHolidayData = {
     url: '/api/v1/timekeeping/pay_period_configs/{pay_period_config_id}/holidays/{id}';
 };
 export type UpdateHolidayErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
     /**
      * Forbidden
      */