@dsptch-work/api-client 0.35.0 → 0.37.0

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

@@ -313,12 +313,6 @@ export type Problem = {
  *
  * An attachment signed id names no upload this endpoint can read. A signed id is issued for one `resource` and verifies only there, so an id for a different resource is indistinguishable from one that is malformed, expired, or tampered with, and all of them answer alike. The message names the resource the upload needed; upload the file again to the direct-uploads endpoint naming it, and pass the signed id that call returns.
  *
- * ### non_numeric_cents
- *
- * **Non-Numeric Money Value**
- *
- * A money parameter is not a numeric value in cents. Send money as a numeric cents value.
- *
  * ### nothing_to_cancel
  *
  * **Nothing To Cancel**
@@ -400,7 +394,7 @@ export type Problem = {
  * Another write to the same resource held it for longer than this request was willing to wait, or collided with it, 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' | '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' | 'forbidden_key' | 'insufficient_api_key_scope' | 'user_scoped_key_required' | 'not_found' | 'already_subscribed' | 'already_terminated' | 'authorization_revoked' | 'import_in_progress' | 'pay_schedule_already_exists' | 'product_archived' | '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' | 'database_timeout' | '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' | 'forbidden_key' | 'insufficient_api_key_scope' | 'user_scoped_key_required' | 'not_found' | 'already_subscribed' | 'already_terminated' | 'authorization_revoked' | 'import_in_progress' | 'pay_schedule_already_exists' | 'product_archived' | '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' | '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' | 'database_timeout' | 'write_contended';
 export type ApiKeyScopeResponseObject = {
     resource: string;
     action: 'read' | 'create' | 'update' | 'delete';
@@ -413,7 +407,7 @@ export type DirectUploadParameters = {
     /**
      * What the file is for, named as the endpoint that will attach it (for example `assets.vendors`). Required. It decides where the file is stored, and the signed ID this call returns is issued for that resource alone — it will not resolve at any other endpoint, so a vendor logo cannot be attached as an avatar, or an avatar as a logo.
      */
-    resource: 'assets.items' | 'assets.items.documents' | 'assets.items.service_events' | 'assets.products' | 'assets.vendors' | 'compliance.checks' | 'internal.companies' | 'internal.company_todos' | 'internal.job_todos' | 'internal.project_todos' | 'pay_periods.imports.aggregate_times' | 'pay_periods.imports.dsptch_cprs' | 'pay_periods.imports.time_entries' | 'payrolls.payroll_runs.imports.paystubs' | 'payrolls.payroll_runs.imports.wide_paystubs' | 'users';
+    resource: 'assets.items' | 'assets.items.documents' | 'assets.items.service_events' | 'assets.products' | 'assets.vendors' | 'compliance.checks' | 'internal.companies' | 'internal.company_todos' | 'internal.job_todos' | 'internal.project_todos' | 'jobs.documents' | 'pay_periods.imports.aggregate_times' | 'pay_periods.imports.dsptch_cprs' | 'pay_periods.imports.time_entries' | 'payrolls.payroll_runs.imports.paystubs' | 'payrolls.payroll_runs.imports.wide_paystubs' | 'projects.documents' | 'users';
     /**
      * Metadata describing the file being registered, before its bytes are uploaded.
      */
@@ -769,9 +763,9 @@ export type CompetencyCriterionResponseObject = {
      */
     evidence_note: string | null;
     /**
-     * Suggested assessment method for this criterion; null when unset. An assessment does not have to use it.
+     * Suggested assessment methods for this criterion. Empty when none are suggested. An assessment does not have to use them.
      */
-    assessment_method: 'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other' | null;
+    assessment_methods: Array<'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other'>;
     /**
      * When the criterion was created.
      */
@@ -798,9 +792,9 @@ export type CompetencyCriterionParameters = {
      */
     evidence_note?: string | null;
     /**
-     * Suggested assessment method; optional, null to clear.
+     * Suggested assessment methods. Optional. Send an empty array to clear.
      */
-    assessment_method?: 'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other' | null;
+    assessment_methods?: Array<'direct_observation' | 'simulation' | 'oral_questioning' | 'written_questioning' | 'products_of_work' | 'recognized_prior_learning' | 'witness_testimony' | 'other'>;
 };
 /**
  * Swap a draft catalog row with its neighbor. The row cannot move past either end of the list.
@@ -1019,9 +1013,9 @@ export type CompetencyAssessmentResponseObject = {
     updated_at: string;
 };
 /**
- * One task line on an assessment. decision and qa_feedback are omitted, not null, when the caller is the candidate and the package is not yet decided.
+ * One criterion line on an assessment. decision and qa_feedback are omitted, not null, when the caller is the candidate and the package is not yet decided.
  */
-export type CompetencyAssessmentKeyActivityResponseObject = {
+export type CompetencyAssessmentCriterionResponseObject = {
     /**
      * ID of the line.
      */
@@ -1031,9 +1025,9 @@ export type CompetencyAssessmentKeyActivityResponseObject = {
      */
     competencies_assessment_id: string;
     /**
-     * ID of the catalog key activity snapshotted onto the line.
+     * ID of the catalog criterion snapshotted onto the line.
      */
-    competencies_key_activity_id: string;
+    competencies_criterion_id: string;
     /**
      * Methods the assessor recorded for this line. Empty when none have been recorded.
      */
@@ -1090,7 +1084,7 @@ export type CompetencyEvidenceItemResponseObject = {
     /**
      * ID of the assessment line this evidence is attached to.
      */
-    competencies_assessment_key_activity_id: string;
+    competencies_assessment_criterion_id: string;
     /**
      * What the evidence points at: upload, form_submission, or certification.
      */
@@ -1706,7 +1700,7 @@ export type ApprenticeshipProgramEmployerUpdateParameters = {
     require_timecard_allocation?: boolean;
 };
 /**
- * Create a period on a wage schedule; the wage schedule is taken from the URL path. wage_cents and fringe_cents are sent as integer cents.
+ * Create a period on a wage schedule; the wage schedule is taken from the URL path. wage_percent and fringe_percent are sent as decimal strings (e.g. "62.5"), and wage_cents and fringe_cents as cents in a decimal string (e.g. "2800" or "2800.0"). Omitting period_number, wage_percent, or wage_cents answers 400. A wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those leaves it unset, but a period with none of min_minutes, max_minutes, or num_competencies answers 422.
  */
 export type ApprenticeshipWageSchedulePeriodParameters = {
     /**
@@ -1730,24 +1724,24 @@ export type ApprenticeshipWageSchedulePeriodParameters = {
      */
     description?: string | null;
     /**
-     * Percentage of the journeyworker wage paid during this period (e.g. 75 for 75%). Required.
+     * Percentage of the journeyworker wage paid during this period, as a decimal string (e.g. "75" or "75.0" for 75%). Required.
      */
-    wage_percent: number;
+    wage_percent: string;
     /**
-     * Wage rate for this period, in cents; denominated in the parent schedule's wage_unit. Required.
+     * Wage rate for this period, in cents as a decimal string (e.g. "3150" or "3150.0"); denominated in the parent schedule's wage_unit. Required.
      */
-    wage_cents: number;
+    wage_cents: string;
     /**
-     * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges (e.g. 70 for 70%); optional, omit or send null when the period does not list fringe as a percentage. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
+     * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges, sent as a decimal string (e.g. "70" or "70.0" for 70%); optional, omit or send null when the period does not list fringe as a percentage. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
      */
-    fringe_percent?: number | null;
+    fringe_percent?: string | null;
     /**
-     * Fixed hourly apprentice fringe for this period, in cents, in the period's wage currency; optional, omit or send null when the period does not list a fixed fringe. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
+     * Fixed hourly apprentice fringe for this period, in cents as a decimal string (e.g. "450" or "450.0"), in the period's wage currency; optional, omit or send null when the period does not list a fixed fringe. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
      */
-    fringe_cents?: number | null;
+    fringe_cents?: string | null;
 };
 /**
- * Update a period on a wage schedule. Send only the fields to change; the wage schedule is taken from the URL path, and wage_cents and fringe_cents are sent as integer cents.
+ * Update a period on a wage schedule. Send only the fields to change; the wage schedule is taken from the URL path, wage_percent and fringe_percent are sent as decimal strings (e.g. "62.5"), and wage_cents and fringe_cents as cents in a decimal string (e.g. "2800" or "2800.0"). A wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those clears it, but a period left with none of min_minutes, max_minutes, or num_competencies answers 422.
  */
 export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
     /**
@@ -1755,15 +1749,15 @@ export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
      */
     period_number?: number;
     /**
-     * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     min_minutes?: number | null;
     /**
-     * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     max_minutes?: number | null;
     /**
-     * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+     * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
      */
     num_competencies?: number | null;
     /**
@@ -1771,24 +1765,24 @@ export type ApprenticeshipWageSchedulePeriodUpdateParameters = {
      */
     description?: string | null;
     /**
-     * Percentage of the journeyworker wage paid during this period (e.g. 75 for 75%); omit to leave it unchanged.
+     * Percentage of the journeyworker wage paid during this period, as a decimal string (e.g. "75" or "75.0" for 75%); omit to leave it unchanged.
      */
-    wage_percent?: number;
+    wage_percent?: string;
     /**
-     * Wage rate for this period, in cents; omit to leave it unchanged.
+     * Wage rate for this period, in cents as a decimal string (e.g. "3150" or "3150.0"); omit to leave it unchanged.
      */
-    wage_cents?: number;
+    wage_cents?: string;
     /**
-     * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges (e.g. 70 for 70%); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a fixed amount sends fringe_cents with fringe_percent null; a request that leaves both set is rejected with a 422.
+     * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges, sent as a decimal string (e.g. "70" or "70.0" for 70%); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a fixed amount sends fringe_cents with fringe_percent null; a request that leaves both set is rejected with a 422.
      */
-    fringe_percent?: number | null;
+    fringe_percent?: string | null;
     /**
-     * Fixed hourly apprentice fringe for this period, in cents; omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a percentage sends fringe_percent with fringe_cents null; a request that leaves both set is rejected with a 422.
+     * Fixed hourly apprentice fringe for this period, in cents as a decimal string (e.g. "450" or "450.0"); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a percentage sends fringe_percent with fringe_cents null; a request that leaves both set is rejected with a 422.
      */
-    fringe_cents?: number | null;
+    fringe_cents?: string | null;
 };
 /**
- * Create a wage schedule for an occupation; the occupation is taken from the URL path. Money is sent as integer cents; periods may be created inline via periods_attributes.
+ * Create a wage schedule for an occupation; the occupation is taken from the URL path. Money is sent as cents in a decimal string (e.g. "2800" or "2800.0"); periods may be created inline via periods_attributes. Omitting name, wage_unit, journeyworker_wage_unit, or period_unit answers 400. A blank name, a unit outside its listed values, a wrong JSON type, or a null for any field but description and journeyworker_fringe_cents answers 422; a null in either of those leaves the field unset.
  */
 export type ApprenticeshipWageScheduleParameters = {
     /**
@@ -1812,19 +1806,19 @@ export type ApprenticeshipWageScheduleParameters = {
      */
     period_unit: 'hours' | 'weeks' | 'months' | 'quarter' | 'semi_annual' | 'year';
     /**
-     * The journeyworker wage to progress toward, in cents; denominated in journeyworker_wage_unit; optional, defaults to 0.
+     * The journeyworker wage to progress toward, in cents as a decimal string (e.g. "5000" or "5000.0"); denominated in journeyworker_wage_unit; optional, defaults to 0.
      */
-    journeyworker_wage_cents?: number;
+    journeyworker_wage_cents?: string;
     /**
-     * The journeyworker fringe that percentage-listed periods are authored against, in cents; an authoring reference only, never priced; optional, omit or send null to leave it unset.
+     * The journeyworker fringe that percentage-listed periods are authored against, in cents as a decimal string (e.g. "2000" or "2000.0"); an authoring reference only, never priced; optional, omit or send null to leave it unset.
      */
-    journeyworker_fringe_cents?: number | null;
+    journeyworker_fringe_cents?: string | null;
     /**
-     * Wage at the end of the progression (100% of the journeyworker wage), in cents; denominated in wage_unit; optional, defaults to 0.
+     * Wage at the end of the progression (100% of the journeyworker wage), in cents as a decimal string (e.g. "4200" or "4200.0"); denominated in wage_unit; optional, defaults to 0.
      */
-    end_wage_cents?: number;
+    end_wage_cents?: string;
     /**
-     * Periods to create, update, or remove alongside the schedule; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; optional.
+     * Periods to create, update, or remove alongside the schedule, as a list of row objects; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; optional. In a row, an unknown key, a wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those leaves it unset, but a period with none of min_minutes, max_minutes, or num_competencies answers 422.
      */
     periods_attributes?: Array<{
         /**
@@ -1834,7 +1828,7 @@ export type ApprenticeshipWageScheduleParameters = {
         /**
          * 0-indexed position of this period in the progression. Required.
          */
-        period_number: number;
+        period_number?: number;
         /**
          * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; optional, but at least one of min_minutes, max_minutes, or num_competencies must be set; null to clear.
          */
@@ -1852,21 +1846,21 @@ export type ApprenticeshipWageScheduleParameters = {
          */
         description?: string | null;
         /**
-         * Percentage of the journeyworker wage paid during this period (e.g. 75 for 75%). Required.
+         * Percentage of the journeyworker wage paid during this period, as a decimal string (e.g. "75" or "75.0" for 75%). Required.
          */
-        wage_percent: number;
+        wage_percent?: string;
         /**
-         * Wage rate for this period, in cents; denominated in the parent schedule's wage_unit. Required.
+         * Wage rate for this period, in cents as a decimal string (e.g. "3150" or "3150.0"); denominated in the parent schedule's wage_unit. Required.
          */
-        wage_cents: number;
+        wage_cents?: string;
         /**
-         * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges (e.g. 70 for 70%); optional, omit or send null when the period does not list fringe as a percentage. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
+         * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges, sent as a decimal string (e.g. "70" or "70.0" for 70%); optional, omit or send null when the period does not list fringe as a percentage. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
          */
-        fringe_percent?: number | null;
+        fringe_percent?: string | null;
         /**
-         * Fixed hourly apprentice fringe for this period, in cents, in the period's wage currency; optional, omit or send null when the period does not list a fixed fringe. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
+         * Fixed hourly apprentice fringe for this period, in cents as a decimal string (e.g. "450" or "450.0"), in the period's wage currency; optional, omit or send null when the period does not list a fixed fringe. A period lists fringe one way at most, so sending both fringe_percent and fringe_cents non-null is rejected with a 422.
          */
-        fringe_cents?: number | null;
+        fringe_cents?: string | null;
         /**
          * Set to true, together with the period's id, to remove that period from the schedule.
          */
@@ -1874,7 +1868,7 @@ export type ApprenticeshipWageScheduleParameters = {
     }>;
 };
 /**
- * Update a wage schedule for an occupation. Send only the fields to change; money is sent as integer cents and periods may be created, updated, or removed inline via periods_attributes.
+ * Update a wage schedule for an occupation. Send only the fields to change; money is sent as cents in a decimal string (e.g. "2800" or "2800.0") and periods may be created, updated, or removed inline via periods_attributes. A blank name, a unit outside its listed values, a wrong JSON type, or a null for any field but description and journeyworker_fringe_cents answers 422; a null in either of those clears the field.
  */
 export type ApprenticeshipWageScheduleUpdateParameters = {
     /**
@@ -1898,29 +1892,21 @@ export type ApprenticeshipWageScheduleUpdateParameters = {
      */
     period_unit?: 'hours' | 'weeks' | 'months' | 'quarter' | 'semi_annual' | 'year';
     /**
-     * Journeyworker wage to progress toward, in cents; omit to leave it unchanged.
+     * Journeyworker wage to progress toward, in cents as a decimal string (e.g. "5000" or "5000.0"); omit to leave it unchanged.
      */
-    journeyworker_wage_cents?: number;
+    journeyworker_wage_cents?: string;
     /**
-     * The journeyworker fringe that percentage-listed periods are authored against, in cents; an authoring reference only, never priced; omit to leave it unchanged, or send null to clear.
+     * The journeyworker fringe that percentage-listed periods are authored against, in cents as a decimal string (e.g. "2000" or "2000.0"); an authoring reference only, never priced; omit to leave it unchanged, or send null to clear.
      */
-    journeyworker_fringe_cents?: number | null;
+    journeyworker_fringe_cents?: string | null;
     /**
-     * Wage at the end of the progression, in cents; omit to leave it unchanged.
+     * Wage at the end of the progression, in cents as a decimal string (e.g. "4200" or "4200.0"); omit to leave it unchanged.
      */
-    end_wage_cents?: number;
+    end_wage_cents?: string;
     /**
-     * Periods to create, update, or remove alongside the schedule; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it.
+     * Periods to create, update, or remove alongside the schedule, as a list of row objects; omit a period's id to add one, include its id to update it, or send its id with _destroy true to remove it; omit the list to leave every period unchanged. In a row, an unknown key, a wrong JSON type, a negative number, or a null for any field but min_minutes, max_minutes, num_competencies, description, fringe_percent, and fringe_cents answers 422 at that field; a null in one of those clears it, but a period left with none of min_minutes, max_minutes, or num_competencies answers 422.
      */
-    periods_attributes?: Array<(unknown | {
-        min_minutes: number;
-    } | {
-        max_minutes: number;
-    } | {
-        num_competencies: number;
-    } | {
-        _destroy: true;
-    }) & {
+    periods_attributes?: Array<{
         /**
          * Unique identifier.
          */
@@ -1930,15 +1916,15 @@ export type ApprenticeshipWageScheduleUpdateParameters = {
          */
         period_number?: number;
         /**
-         * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Duration of this period, in on-the-job minutes spent within it — not a cumulative threshold; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         min_minutes?: number | null;
         /**
-         * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Upper bound on this period's duration, in minutes; informational only, not used to compute advancement; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         max_minutes?: number | null;
         /**
-         * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. A newly added period must set at least one of min_minutes, max_minutes, or num_competencies.
+         * Number of competencies required to complete this period; omit to leave it unchanged, or send null to clear. Every period must keep at least one of min_minutes, max_minutes, or num_competencies; a write that leaves all three null answers 422.
          */
         num_competencies?: number | null;
         /**
@@ -1946,21 +1932,21 @@ export type ApprenticeshipWageScheduleUpdateParameters = {
          */
         description?: string | null;
         /**
-         * Percentage of the journeyworker wage paid during this period (e.g. 75 for 75%); omit to leave it unchanged.
+         * Percentage of the journeyworker wage paid during this period, as a decimal string (e.g. "75" or "75.0" for 75%); omit to leave it unchanged.
          */
-        wage_percent?: number;
+        wage_percent?: string;
         /**
-         * Wage rate for this period, in cents; omit to leave it unchanged.
+         * Wage rate for this period, in cents as a decimal string (e.g. "3150" or "3150.0"); omit to leave it unchanged.
          */
-        wage_cents?: number;
+        wage_cents?: string;
         /**
-         * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges (e.g. 70 for 70%); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a fixed amount sends fringe_cents with fringe_percent null; a request that leaves both set is rejected with a 422.
+         * Apprentice fringe for this period, as a percentage of the fringe on the wage determination the apprentice charges, sent as a decimal string (e.g. "70" or "70.0" for 70%); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a fixed amount sends fringe_cents with fringe_percent null; a request that leaves both set is rejected with a 422.
          */
-        fringe_percent?: number | null;
+        fringe_percent?: string | null;
         /**
-         * Fixed hourly apprentice fringe for this period, in cents; omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a percentage sends fringe_percent with fringe_cents null; a request that leaves both set is rejected with a 422.
+         * Fixed hourly apprentice fringe for this period, in cents as a decimal string (e.g. "450" or "450.0"); omit to leave it unchanged, or send null to clear. A period lists fringe one way at most, so switching to a percentage sends fringe_percent with fringe_cents null; a request that leaves both set is rejected with a 422.
          */
-        fringe_cents?: number | null;
+        fringe_cents?: string | null;
         /**
          * Set to true, together with the period's id, to remove that period from the schedule.
          */
@@ -2553,6 +2539,10 @@ export type TimecodeHistoryVersionObject = {
  * Request body for creating or updating a timecode; only `name` is required. On create, omitted fields take their model/DB defaults (noted per field). On update the request applies a bitemporal correction, so omitted fields keep the current version's values rather than reverting to defaults.
  */
 export type TimecodeParameters = {
+    /**
+     * When the new timecode becomes effective, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`). Defaults to the time of the request. Accepted on create only.
+     */
+    effective_date?: string;
     /**
      * Human-readable name of the timecode. Required; must be unique within the company.
      */
@@ -2613,10 +2603,6 @@ export type TimecodeParameters = {
      * Where the timecode may be applied: none, job, non_job, or job_with_timecode. Defaults to none on create.
      */
     restricted_to?: 'none' | 'job' | 'non_job' | 'job_with_timecode';
-    /**
-     * When the new timecode becomes effective. Defaults to the time of the request. Accepted on create only.
-     */
-    effective_date?: string;
 };
 /**
  * Request body for correcting a timecode over a valid-time span. Send only the fields to change; omitted fields retain their current values. `effective_from` defaults to the addressed version's start, and `effective_to` is optional.
@@ -2710,7 +2696,7 @@ export type TimecodeScheduledTerminationParameters = {
     effective_date: string;
 };
 /**
- * Request body for scheduling a future change to a timecode: an effective_date paired with the attribute values to apply from that date. `effective_date` and `name` are required; omitted attributes inherit the current version's values.
+ * Request body for scheduling a future change to a timecode: an effective_date paired with the attribute values to apply from that date. Only `effective_date` is required; omitted attributes inherit the current version's values.
  */
 export type TimecodeScheduledChangeParameters = {
     /**
@@ -2718,9 +2704,9 @@ export type TimecodeScheduledChangeParameters = {
      */
     effective_date: string;
     /**
-     * Timecode name to apply from the effective date. Required.
+     * Timecode name to apply from the effective date; omit it to keep the current name.
      */
-    name: string;
+    name?: string;
     /**
      * Free-text description to apply; null clears it.
      */
@@ -3213,7 +3199,7 @@ export type AssetsAttributeResponseObject = {
     updated_at: string;
 };
 /**
- * Create or update an attribute definition. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
+ * Create an attribute definition. Omitting name or data_type answers 400, and a blank or null name or any wrong-typed value answers 422. Options apply only to a select attribute and are ignored otherwise.
  */
 export type AssetsAttributeParameters = {
     /**
@@ -3225,7 +3211,7 @@ export type AssetsAttributeParameters = {
      */
     data_type: 'text' | 'number' | 'date' | 'boolean' | 'select';
     /**
-     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one.
+     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     options?: Array<{
         /**
@@ -3247,7 +3233,7 @@ export type AssetsAttributeParameters = {
     }>;
 };
 /**
- * Update an attribute definition. All fields are optional — send only what changes. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
+ * Update an attribute definition. All fields are optional — send only what changes. A blank or null name or any wrong-typed value answers 422. Options apply only to a select attribute and are ignored otherwise; data_type cannot be changed once any value has been filled.
  */
 export type AssetsAttributeUpdateParameters = {
     /**
@@ -3259,7 +3245,7 @@ export type AssetsAttributeUpdateParameters = {
      */
     data_type?: 'text' | 'number' | 'date' | 'boolean' | 'select';
     /**
-     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one.
+     * Choices for a select attribute, ignored for other data types. Include id to update an existing option, omit id to add one, or set _destroy to remove one. An unknown or wrongly typed row field answers 422 at that row.
      */
     options?: Array<{
         /**
@@ -4639,62 +4625,69 @@ export type PwaJobDetailsResponseObject = {
     ny_dol_prc_number?: string | null;
 } | null;
 /**
- * Fields shared by job creation and updates. Updates may omit any field to preserve its current value. The resulting job must still satisfy its schedule and PWA validation rules.
+ * Parameters for creating a job. Sets the job's schedule, work types, address, custom-field values, and optional Prevailing Wage / Apprenticeship (PWA) compliance. `requested_by_company_id` and `created_by_user_id` are required unless `template_id` names a template, whose copy keeps both. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any job or relationship is saved.
  */
-export type JobParameters = {
+export type JobCreateParameters = {
+    /**
+     * ID of the user creating the job; the creator cannot be changed afterward. A copy of a template keeps the template's creator when this is omitted. Null, a blank ID, or a wrong type answers 422.
+     */
+    created_by_user_id?: string;
+    /**
+     * ID of a job template to copy this job from; when set, the new job is created from that template. Null or omit to start from a blank job; a blank ID or a wrong type answers 422.
+     */
+    template_id?: string | null;
     /**
      * Human-readable job name, unique within the creating company; null when unset.
      */
     name?: string | null;
     /**
-     * Free-text description of the job.
+     * Free-text description of the job. Null or a wrong type answers 422.
      */
     description?: string;
     /**
-     * ID of the company that requested the job (for example a general contractor). Required on create; omit on update to preserve the existing requester.
+     * ID of the company that requested the job (for example a general contractor). Omit on update to preserve the existing requester. Null, a blank ID, or a wrong type answers 422.
      */
     requested_by_company_id?: string;
-    /**
-     * Complete desired set of unique nonblank manager user IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
-     */
-    manager_user_ids?: Array<string>;
     /**
      * Purchase order number for the job; null when unset.
      */
     purchase_order_number?: string | null;
     /**
-     * ID of the project this job belongs to; null when the job is not part of a project.
+     * ID of the project this job belongs to; null when the job is not part of a project. A blank ID or a wrong type answers 422.
      */
     project_id?: string | null;
     /**
-     * ID of a department belonging to the job's provider company. Retrieve department IDs from GET /api/v1/companies/departments. Send null to clear the assignment; omit on update to preserve it, or on create to preserve a copied template's assignment. A new job without a template starts unassigned.
+     * ID of a department belonging to the job's provider company. Retrieve department IDs from GET /api/v1/companies/departments. Send null to clear the assignment; omit on update to preserve it, or on create to preserve a copied template's assignment. A new job without a template starts unassigned. A blank ID or a wrong type answers 422.
      */
     companies_department_id?: string | null;
     /**
-     * Federal prevailing-wage / apprenticeship (PWA) tracking mode: one of all (both prevailing wage and apprenticeship), pw_only, ap_only, or none.
+     * Federal prevailing-wage / apprenticeship (PWA) tracking mode: one of all (both prevailing wage and apprenticeship), pw_only, ap_only, or none. Null or any other value returns 422.
      */
     federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Regional (state) prevailing-wage / apprenticeship tracking mode: one of all (both prevailing wage and apprenticeship), pw_only, ap_only, or none.
+     * Regional (state) prevailing-wage / apprenticeship tracking mode, with the same values as federal_pwa_mode; null or any other value returns 422.
      */
     regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
      * Two-letter state code (e.g. CA, IL, NY) that selects which regional prevailing-wage fields under pwa_details apply.
      */
-    region?: string;
+    region?: string | null;
     /**
-     * Start of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled.
+     * Start of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled; any other non-string, false included, answers 422.
      */
     start_time?: string | null;
     /**
-     * End of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled.
+     * End of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled; any other non-string, false included, answers 422.
      */
     end_time?: string | null;
     /**
-     * Time zone the job's schedule and time tracking are anchored to (e.g. US/Central); defaults to US/Central when unset.
+     * Time zone the job's schedule and time tracking are anchored to (e.g. US/Central); defaults to US/Central when unset. Null, a blank or unlisted name, or a wrong type answers 422.
      */
     tz_name?: string;
-    time_card_start_day?: TimeCardStartDay;
+    /**
+     * Day of the week the job's workweek and time cards start on, as an integer: 0 (Sunday) through 6 (Saturday). Any other value, a numeric string included, answers 422.
+     */
+    time_card_start_day?: number;
     /**
      * Clock-in enforcement level: one of none (no guidance), warning (manual time entries fail the clock-in compliance check), or required (a technician's own time on the job must come from clocking in on DSPTCH Mobile; the technician's own web and user-API-key time-entry writes are refused). A time entry whose time code, as of the entry's start time, is PTO, holiday, or restricted to non-job time entries is exempt at every level. Time-entry writes made with a company API key are not gated. While the creating company requires clock-in company-wide, a create stores `required` whatever value is sent, and lowering an open job returns 422 with the error at `#/clock_in_requirement`. Omit the field to leave the current value unchanged.
      */
@@ -4704,31 +4697,35 @@ export type JobParameters = {
      */
     send_geofence_reminders?: boolean | null;
     /**
-     * Whether customers granted access can view this job.
+     * Whether customers granted access can view this job. A boolean; null or any other type returns 422.
      */
     allow_customer_access?: boolean;
     /**
-     * Complete desired set of unique nonblank timecode IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
-     */
-    timekeeping_timecode_ids?: Array<string>;
-    /**
-     * Whether the feature-allocation selector is shown for this job; null when unset.
+     * Whether the feature-allocation selector is shown for this job. A boolean; null or any other type returns 422.
      */
-    tracks_feature_allocations?: boolean | null;
+    tracks_feature_allocations?: boolean;
     /**
-     * Whether applicable time entries on this job must carry a feature allocation; null when unset.
+     * Whether applicable time entries on this job must carry a feature allocation. A boolean; null or any other type returns 422.
      */
-    requires_feature_allocation?: boolean | null;
+    requires_feature_allocation?: boolean;
     /**
-     * Whether time entries on this job are capped at one feature allocation; null when unset.
+     * Whether time entries on this job are capped at one feature allocation. A boolean; null or any other type returns 422.
      */
-    max_one_feature_allocation?: boolean | null;
+    max_one_feature_allocation?: boolean;
     /**
      * How this job records production completions: one of none (opts out), feature (per site feature, e.g. a turbine), or quantity (a unit count, e.g. modules). Locked once any completion exists. Omit the field to leave the current value unchanged.
      */
     production_tracking_kind?: 'none' | 'feature' | 'quantity';
     /**
-     * Work types (trade or scope categories) to associate with the job; null when none.
+     * Complete desired set of unique nonblank manager user IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
+     */
+    manager_user_ids?: Array<string>;
+    /**
+     * Complete desired set of unique nonblank timecode IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
+     */
+    timekeeping_timecode_ids?: Array<string>;
+    /**
+     * Work types (trade or scope categories) to associate with the job, one row each. Null, a non-array, or a row that is not an object answers 422.
      */
     job_work_types_attributes?: Array<{
         /**
@@ -4739,9 +4736,9 @@ export type JobParameters = {
          * ID of the work type to associate with the job.
          */
         work_type_id?: string;
-    }> | null;
+    }>;
     /**
-     * The job's structured street address; null when unset.
+     * The job's structured street address. Null or a non-object answers 422; an unknown key inside it answers 422 at its pointer.
      */
     job_address_attributes?: {
         /**
@@ -4781,20 +4778,33 @@ export type JobParameters = {
          */
         country?: string | null;
         /**
-         * IANA time zone of the address (e.g. America/Chicago); null when unset.
+         * Time zone of the address (e.g. US/Central); null when unset. A blank or unlisted name answers 422.
          */
         timezone?: string | null;
         /**
-         * Whether the address has been verified; null when unset.
+         * Whether the address has been verified. A boolean; null or any other type returns 422.
          */
-        verified?: boolean | null;
+        verified?: boolean;
         /**
-         * Human-readable one-line address label; null when unset.
+         * Human-readable one-line address label; null derives it from the other fields.
          */
         label?: string | null;
-    } | null;
+    };
+    /**
+     * Values for the job's custom fields, as a list of configurations and their values. Each configuration may appear only once. Every visible configuration gets a stored value; one left out of the list, or an omitted or empty list, stores null.
+     */
+    custom_fields?: Array<{
+        /**
+         * ID of a visible custom-field configuration owned by the credential company and applicable to jobs.
+         */
+        custom_field_config_id: string;
+        /**
+         * Value as text or null.
+         */
+        value: string | null;
+    }>;
     /**
-     * Prevailing-wage / apprenticeship (PWA) compliance details to set on the job. Omit or send an empty object to make no PWA-details changes; null and non-object values are rejected. The accepted regional keys depend on the effective region and regional PWA mode.
+     * Prevailing-wage / apprenticeship (PWA) compliance details to set on the job. Omit or send an empty object to make no PWA-details changes. Null or a non-object answers 422, and so does an unknown key or a wrongly typed field inside it, at its pointer. The accepted regional keys depend on the effective region and regional PWA mode.
      */
     pwa_details?: {
         /**
@@ -4802,7 +4812,7 @@ export type JobParameters = {
          */
         contractor_type?: 'prime_contractor' | 'sub_contractor' | null;
         /**
-         * Whether new positions on the job default to paying the full fringe as cash. Omit to retain the current value (or use the database default on create); when sent, the value must be true or false.
+         * Whether new positions on the job default to paying the full fringe as cash. Omit to retain the current value (or use the database default on create); when sent, the value must be JSON true or false.
          */
         pay_full_cash_fringe_by_default?: boolean;
         /**
@@ -4834,7 +4844,7 @@ export type JobParameters = {
          */
         il_dol_project_id?: string | null;
         /**
-         * Whether the Illinois project is funded with state capital funds; null when not applicable.
+         * Whether the Illinois project is funded with state capital funds, as JSON true or false; null when not applicable.
          */
         il_dol_state_capital_funds?: boolean | null;
         /**
@@ -4864,166 +4874,363 @@ export type JobParameters = {
     };
 };
 /**
- * Parameters for creating a job. `requested_by_company_id` and `created_by_user_id` are required. Sets the job's schedule, work types, address, custom-field values, and optional Prevailing Wage / Apprenticeship (PWA) compliance.
+ * Parameters for updating an existing job. Every field is optional; omit a field to preserve its current value. The resulting job must still satisfy schedule and PWA validation rules. Accepts every shared job field plus a directly settable status and custom-field changes. Sending `created_by_user_id` returns 400 unknown_key, including when it matches the existing creator or is null. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any job or relationship changes.
  */
-export type JobCreateParameters = JobParameters & {
-    /**
-     * ID of the user creating the job. Required on create; the creator cannot be changed afterward.
-     */
-    created_by_user_id: string;
+export type JobUpdateParameters = {
     /**
-     * ID of a job template to copy this job from; when set, the new job is created from that template. Null or omit to start from a blank job.
+     * Human-readable job name, unique within the creating company; null when unset.
      */
-    template_id?: string | null;
+    name?: string | null;
     /**
-     * Values for the job's custom fields, as a list of configurations and their values. Each configuration may appear only once. Every visible configuration gets a stored value; one left out of the list, or an omitted or empty list, stores null.
+     * Free-text description of the job. Null or a wrong type answers 422.
      */
-    custom_fields?: Array<{
-        /**
-         * ID of a visible custom-field configuration owned by the credential company and applicable to jobs.
-         */
-        custom_field_config_id: string;
-        /**
-         * Value as text or null.
-         */
-        value: string | null;
-    }>;
-};
-/**
- * Parameters for updating an existing job. Every field is optional; omit a field to preserve its current value. The resulting job must still satisfy schedule and PWA validation rules. Accepts every shared job field plus a directly settable status and custom-field changes. Sending `created_by_user_id` returns 400 unknown_key, including when it matches the existing creator or is null.
- */
-export type JobUpdateParameters = JobParameters & {
+    description?: string;
     /**
-     * Settable status values. Other statuses are derived from job and position state and cannot be set directly.
+     * ID of the company that requested the job (for example a general contractor). Omit on update to preserve the existing requester. Null, a blank ID, or a wrong type answers 422.
      */
-    status?: 'completed' | 'cancelled' | 'disputed';
+    requested_by_company_id?: string;
     /**
-     * Custom-field values to change, as a list of configurations and their replacement values. Each configuration may appear only once. Only the listed configurations change; every other configuration keeps its stored value, and an omitted or empty list changes none.
+     * Purchase order number for the job; null when unset.
      */
-    custom_fields?: Array<{
-        /**
-         * ID of a custom-field configuration owned by the credential company and applicable to jobs. A hidden configuration may be updated only when the job already stores its value.
-         */
-        custom_field_config_id: string;
-        /**
-         * Replacement value as text or null. Null stores a value rather than removing the row.
-         */
-        value: string | null;
-    }>;
-};
-/**
- * A reusable job template — a saved job pattern for quickly creating new jobs with the same setup. Read-only through the API (listing only).
- */
-export type JobTemplateResponseObject = {
+    purchase_order_number?: string | null;
     /**
-     * Unique identifier.
+     * ID of the project this job belongs to; null when the job is not part of a project. A blank ID or a wrong type answers 422.
      */
-    id: string;
+    project_id?: string | null;
     /**
-     * Display name of the template.
+     * ID of a department belonging to the job's provider company. Retrieve department IDs from GET /api/v1/companies/departments. Send null to clear the assignment; omit on update to preserve it, or on create to preserve a copied template's assignment. A new job without a template starts unassigned. A blank ID or a wrong type answers 422.
      */
-    name: string;
+    companies_department_id?: string | null;
     /**
-     * Description of the template; null when unset.
+     * Federal prevailing-wage / apprenticeship (PWA) tracking mode: one of all (both prevailing wage and apprenticeship), pw_only, ap_only, or none. Null or any other value returns 422.
      */
-    description: string | null;
-};
-/**
- * A named collection of a company's users, used to organize people for assignment, filtering, and company workflows. Membership is managed through the nested group-users endpoints.
- */
-export type GroupResponseObject = {
+    federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Unique identifier.
+     * Regional (state) prevailing-wage / apprenticeship tracking mode, with the same values as federal_pwa_mode; null or any other value returns 422.
      */
-    id: string;
+    regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * The group's display name; unique within the company.
+     * Two-letter state code (e.g. CA, IL, NY) that selects which regional prevailing-wage fields under pwa_details apply.
      */
-    name: string;
+    region?: string | null;
     /**
-     * When the record was created (ISO 8601).
+     * Start of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled; any other non-string, false included, answers 422.
      */
-    created_at: string;
+    start_time?: string | null;
     /**
-     * When the record was last updated (ISO 8601).
+     * End of the job's scheduled window (ISO 8601); the date is anchored to the start of that day in tz_name. Null to leave the job unscheduled; any other non-string, false included, answers 422.
      */
-    updated_at: string;
-};
-/**
- * Request body for creating a group. Send fields in JSON; the group belongs to the company that owns the API key.
- */
-export type GroupParameters = {
+    end_time?: string | null;
     /**
-     * Required display name, unique within the company. Omission answers 400; supplied null or a wrong type answers 422. Blank names fail model validation with 422.
+     * Time zone the job's schedule and time tracking are anchored to (e.g. US/Central); defaults to US/Central when unset. Null, a blank or unlisted name, or a wrong type answers 422.
      */
-    name: string;
-};
-/**
- * Request body for updating a group. Send only fields to change in JSON; omitted fields remain unchanged.
- */
-export type GroupUpdateParameters = {
+    tz_name?: string;
     /**
-     * The group's display name, unique within the company; omit to leave it unchanged. Supplied null, a wrong type, or a blank name answers 422.
+     * Day of the week the job's workweek and time cards start on, as an integer: 0 (Sunday) through 6 (Saturday). Any other value, a numeric string included, answers 422.
      */
-    name?: string;
-};
-/**
- * A worker as your company sees them: the cross-company person merged with their employment record at your company (title, pay, benefits, and accruals), their roles at your company, and optional prevailing-wage compliance details. Your company sees everyone it employs, everyone it has granted a role, and everyone it has invited, which is the same set the web app shows. A role holder or an invitee your company does not employ has no employment record to merge, so the employment fields (employment_id through employment_window, plus manager_user_id and custom_fields) are null for them, and employment_state reads none. There is no delete — removing a worker terminates their employment at the company (see the user-company endpoints), which sets termination_date and drops them from the default list.
- */
-export type UserResponseObject = {
+    time_card_start_day?: number;
     /**
-     * Unique identifier of the worker (the person).
+     * Clock-in enforcement level: one of none (no guidance), warning (manual time entries fail the clock-in compliance check), or required (a technician's own time on the job must come from clocking in on DSPTCH Mobile; the technician's own web and user-API-key time-entry writes are refused). A time entry whose time code, as of the entry's start time, is PTO, holiday, or restricted to non-job time entries is exempt at every level. Time-entry writes made with a company API key are not gated. While the creating company requires clock-in company-wide, a create stores `required` whatever value is sent, and lowering an open job returns 422 with the error at `#/clock_in_requirement`. Omit the field to leave the current value unchanged.
      */
-    id: string;
+    clock_in_requirement?: 'none' | 'warning' | 'required';
     /**
-     * Full legal name, composed from first_name and last_name.
+     * Whether to send geofence-based clock-in/out reminders for this job; null when unset.
      */
-    name: string;
+    send_geofence_reminders?: boolean | null;
     /**
-     * Legal first name. Used for compliance and other exports.
+     * Whether customers granted access can view this job. A boolean; null or any other type returns 422.
      */
-    first_name: string | null;
+    allow_customer_access?: boolean;
     /**
-     * Legal last name. Used for compliance and other exports.
+     * Whether the feature-allocation selector is shown for this job. A boolean; null or any other type returns 422.
      */
-    last_name: string | null;
+    tracks_feature_allocations?: boolean;
     /**
-     * Chosen first name. Coalesced over first_name for display; the legal name is used for exports. Null when unset.
+     * Whether applicable time entries on this job must carry a feature allocation. A boolean; null or any other type returns 422.
      */
-    preferred_first_name: string | null;
+    requires_feature_allocation?: boolean;
     /**
-     * Chosen last name. Coalesced over last_name for display; the legal name is used for exports. Null when unset.
+     * Whether time entries on this job are capped at one feature allocation. A boolean; null or any other type returns 422.
      */
-    preferred_last_name: string | null;
+    max_one_feature_allocation?: boolean;
     /**
-     * Work email address, used to sign in and to receive the company invite. Null when unset.
+     * How this job records production completions: one of none (opts out), feature (per site feature, e.g. a turbine), or quantity (a unit count, e.g. modules). Locked once any completion exists. Omit the field to leave the current value unchanged.
      */
-    email: string | null;
+    production_tracking_kind?: 'none' | 'feature' | 'quantity';
     /**
-     * Personal (non-work) email address. Null when unset.
+     * Complete desired set of unique nonblank manager user IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
      */
-    personal_email: string | null;
+    manager_user_ids?: Array<string>;
     /**
-     * Contact phone number. Null when unset.
+     * Complete desired set of unique nonblank timecode IDs. Omit to preserve the set; send an empty array to clear it. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any job or relationship is saved.
      */
-    phone_number: string | null;
+    timekeeping_timecode_ids?: Array<string>;
     /**
-     * City of the worker's contact address. Null when unset.
+     * Work types (trade or scope categories) to associate with the job, one row each. Null, a non-array, or a row that is not an object answers 422.
      */
-    city: string | null;
+    job_work_types_attributes?: Array<{
+        /**
+         * Whether this is the job's primary work type.
+         */
+        primary?: boolean;
+        /**
+         * ID of the work type to associate with the job.
+         */
+        work_type_id?: string;
+    }>;
     /**
-     * Two-letter US state code of the worker's contact address. Null when unset.
+     * The job's structured street address. Null or a non-object answers 422; an unknown key inside it answers 422 at its pointer.
      */
-    state: string | null;
+    job_address_attributes?: {
+        /**
+         * ID of an existing address to update; null to create a new address.
+         */
+        id?: string | null;
+        /**
+         * Secondary address designator such as an apartment or suite number; null when unset.
+         */
+        sub_address_number?: string | null;
+        /**
+         * Street number of the address; null when unset.
+         */
+        address_number?: string | null;
+        /**
+         * Neighborhood of the address; null when unset.
+         */
+        neighborhood?: string | null;
+        /**
+         * City or municipality of the address; null when unset.
+         */
+        municipality?: string | null;
+        /**
+         * County or other sub-region of the address; null when unset.
+         */
+        sub_region?: string | null;
+        /**
+         * State or region of the address; null when unset.
+         */
+        region?: string | null;
+        /**
+         * Postal or ZIP code of the address; null when unset.
+         */
+        postal_code?: string | null;
+        /**
+         * Country of the address; null when unset.
+         */
+        country?: string | null;
+        /**
+         * Time zone of the address (e.g. US/Central); null when unset. A blank or unlisted name answers 422.
+         */
+        timezone?: string | null;
+        /**
+         * Whether the address has been verified. A boolean; null or any other type returns 422.
+         */
+        verified?: boolean;
+        /**
+         * Human-readable one-line address label; null derives it from the other fields.
+         */
+        label?: string | null;
+    };
     /**
-     * Date of birth (YYYY-MM-DD). Null when unset. Used for compliance reporting.
+     * Custom-field values to change, as a list of configurations and their replacement values. Each configuration may appear only once. Only the listed configurations change; every other configuration keeps its stored value, and an omitted or empty list changes none.
      */
-    birth_date: string | null;
+    custom_fields?: Array<{
+        /**
+         * ID of a custom-field configuration owned by the credential company and applicable to jobs. A hidden configuration may be updated only when the job already stores its value.
+         */
+        custom_field_config_id: string;
+        /**
+         * Replacement value as text or null. Null stores a value rather than removing the row.
+         */
+        value: string | null;
+    }>;
     /**
-     * US Department of Labor apprentice number, when the worker is a registered apprentice. Null when none.
+     * Prevailing-wage / apprenticeship (PWA) compliance details to set on the job. Omit or send an empty object to make no PWA-details changes. Null or a non-object answers 422, and so does an unknown key or a wrongly typed field inside it, at its pointer. The accepted regional keys depend on the effective region and regional PWA mode.
      */
-    dol_apprentice_no: string | null;
-    /**
+    pwa_details?: {
+        /**
+         * Role of the company on this job for PWA reporting: one of prime_contractor or sub_contractor; null when unset.
+         */
+        contractor_type?: 'prime_contractor' | 'sub_contractor' | null;
+        /**
+         * Whether new positions on the job default to paying the full fringe as cash. Omit to retain the current value (or use the database default on create); when sent, the value must be JSON true or false.
+         */
+        pay_full_cash_fringe_by_default?: boolean;
+        /**
+         * California DIR (Department of Industrial Relations) awarding-body ID; null when not applicable.
+         */
+        dir_awarding_body_id?: string | null;
+        /**
+         * California DIR project registration ID (an 11-digit number); null when not applicable.
+         */
+        dir_project_id?: string | null;
+        /**
+         * California DIR project name; null when not applicable.
+         */
+        dir_project_name?: string | null;
+        /**
+         * California DIR contract ID; null when not applicable.
+         */
+        dir_contract_id?: string | null;
+        /**
+         * California DIR awarding-body name; null when not applicable.
+         */
+        dir_project_awarding_body_name?: string | null;
+        /**
+         * California DIR project number; null when not applicable.
+         */
+        dir_project_number?: string | null;
+        /**
+         * Illinois DOL (Department of Labor) project ID; null when not applicable.
+         */
+        il_dol_project_id?: string | null;
+        /**
+         * Whether the Illinois project is funded with state capital funds, as JSON true or false; null when not applicable.
+         */
+        il_dol_state_capital_funds?: boolean | null;
+        /**
+         * Illinois DOL public-body name; null when not applicable.
+         */
+        il_dol_public_body_name?: string | null;
+        /**
+         * ID of the Illinois DOL public-body contact; null when not applicable.
+         */
+        il_dol_public_body_contact_id?: string | null;
+        /**
+         * ID of the Illinois DOL public-body address; null when not applicable.
+         */
+        il_dol_public_body_address_id?: string | null;
+        /**
+         * Illinois DOL contract number; null when not applicable.
+         */
+        il_dol_contract_number?: string | null;
+        /**
+         * Illinois SHINES project ID; null when not applicable.
+         */
+        il_shines_project_id?: string | null;
+        /**
+         * New York DOL prevailing-rate-case (PRC) number, a 10-digit identifier; null when not applicable.
+         */
+        ny_dol_prc_number?: string | null;
+    };
+    /**
+     * Settable status values. Other statuses are derived from job and position state and cannot be set directly; null or any other value returns 422.
+     */
+    status?: 'completed' | 'cancelled' | 'disputed';
+};
+/**
+ * A reusable job template — a saved job pattern for quickly creating new jobs with the same setup. Read-only through the API (listing only).
+ */
+export type JobTemplateResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * Display name of the template.
+     */
+    name: string;
+    /**
+     * Description of the template; null when unset.
+     */
+    description: string | null;
+};
+/**
+ * A named collection of a company's users, used to organize people for assignment, filtering, and company workflows. Membership is managed through the nested group-users endpoints.
+ */
+export type GroupResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * The group's display name; unique within the company.
+     */
+    name: string;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
+    /**
+     * When the record was last updated (ISO 8601).
+     */
+    updated_at: string;
+};
+/**
+ * Request body for creating a group. Send fields in JSON; the group belongs to the company that owns the API key.
+ */
+export type GroupParameters = {
+    /**
+     * Required display name, unique within the company. Omission answers 400; supplied null or a wrong type answers 422. Blank names fail model validation with 422.
+     */
+    name: string;
+};
+/**
+ * Request body for updating a group. Send only fields to change in JSON; omitted fields remain unchanged.
+ */
+export type GroupUpdateParameters = {
+    /**
+     * The group's display name, unique within the company; omit to leave it unchanged. Supplied null, a wrong type, or a blank name answers 422.
+     */
+    name?: string;
+};
+/**
+ * A worker as your company sees them: the cross-company person merged with their employment record at your company (title, pay, benefits, and accruals), their roles at your company, and optional prevailing-wage compliance details. Your company sees everyone it employs, everyone it has granted a role, and everyone it has invited, which is the same set the web app shows. A role holder or an invitee your company does not employ has no employment record to merge, so the employment fields (employment_id through employment_window, plus manager_user_id and custom_fields) are null for them, and employment_state reads none. There is no delete — removing a worker terminates their employment at the company (see the user-company endpoints), which sets termination_date and drops them from the default list.
+ */
+export type UserResponseObject = {
+    /**
+     * Unique identifier of the worker (the person).
+     */
+    id: string;
+    /**
+     * Full legal name, composed from first_name and last_name.
+     */
+    name: string;
+    /**
+     * Legal first name. Used for compliance and other exports.
+     */
+    first_name: string | null;
+    /**
+     * Legal last name. Used for compliance and other exports.
+     */
+    last_name: string | null;
+    /**
+     * Chosen first name. Coalesced over first_name for display; the legal name is used for exports. Null when unset.
+     */
+    preferred_first_name: string | null;
+    /**
+     * Chosen last name. Coalesced over last_name for display; the legal name is used for exports. Null when unset.
+     */
+    preferred_last_name: string | null;
+    /**
+     * Work email address, used to sign in and to receive the company invite. Null when unset.
+     */
+    email: string | null;
+    /**
+     * Personal (non-work) email address. Null when unset.
+     */
+    personal_email: string | null;
+    /**
+     * Contact phone number. Null when unset.
+     */
+    phone_number: string | null;
+    /**
+     * City of the worker's contact address. Null when unset.
+     */
+    city: string | null;
+    /**
+     * Two-letter US state code of the worker's contact address. Null when unset.
+     */
+    state: string | null;
+    /**
+     * Date of birth (YYYY-MM-DD). Null when unset. Used for compliance reporting.
+     */
+    birth_date: string | null;
+    /**
+     * US Department of Labor apprentice number, when the worker is a registered apprentice. Null when none.
+     */
+    dol_apprentice_no: string | null;
+    /**
      * URL of the worker's profile picture (a resized variant). Null when none is set.
      */
     avatar_url: string | null;
@@ -5073,21 +5280,21 @@ export type UserResponseObject = {
      */
     compensation_type: 'hourly' | 'salary' | null;
     /**
-     * Base pay rate, formatted as a currency string in the company's currency. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset.
+     * Base hourly pay in cents as a decimal string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset.
      */
-    hourly_rate?: string | null;
+    hourly_rate_cents?: string | null;
     /**
-     * Annual training-fund contribution for the worker, formatted as a currency string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
+     * Annual training-fund contribution for the worker in cents as a decimal string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
      */
-    training_annual_amount?: string | null;
+    training_annual_amount_cents?: string | null;
     /**
-     * Employer-paid annual combined health benefit, formatted as a currency string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
+     * Employer-paid annual combined health benefit in cents as a decimal string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
      */
-    employer_combined_health_amount?: string | null;
+    employer_combined_health_amount_cents?: string | null;
     /**
-     * Employer-paid annual combined savings and retirement benefit, formatted as a currency string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
+     * Employer-paid annual combined savings and retirement benefit in cents as a decimal string. Present for company keys, company administrators, and the employed person, and omitted otherwise; null when authorized but unset. Used in prevailing-wage fringe calculations.
      */
-    employer_combined_savings?: string | null;
+    employer_combined_savings_cents?: string | null;
     /**
      * Annualized minutes the worker is expected to work, used to annualize fringe benefits. Null to fall back to the standard full-time year.
      */
@@ -5232,7 +5439,7 @@ export type UserResponseObject = {
     } | null;
 };
 /**
- * Request body for updating a worker's profile. Limited to person-level identity fields; employment, roles, and compliance are managed through onboarding (create) and the user-company endpoints.
+ * Request body for updating a worker's profile. Limited to person-level identity fields; employment, roles, and compliance are managed through onboarding (create) and the user-company endpoints. Include only the fields to change. A null or blank legal name, or any wrong-typed value, answers 422.
  */
 export type UserUpdateParameters = {
     /**
@@ -5272,7 +5479,7 @@ export type UserUpdateParameters = {
      */
     state?: string | null;
     /**
-     * Date of birth (YYYY-MM-DD).
+     * Date of birth as a YYYY-MM-DD calendar date; send null to clear it.
      */
     birth_date?: string | null;
     /**
@@ -5284,22 +5491,10 @@ export type UserUpdateParameters = {
      */
     avatar_signed_id?: string | null;
 };
-export type UserParameters = ({
-    /**
-     * Work email address; the worker signs in and receives their invite here. Null when the worker has none. Required to send an invite unless a phone number is given.
-     */
-    email: string;
-} | {
-    /**
-     * Contact phone number. Null when the worker has none. Required to send an invite unless a work email is given.
-     */
-    phone_number: string;
-} | {
-    /**
-     * Non-stored field. If true, no invite is created and work email / phone are not required.
-     */
-    skip_invite: true;
-}) & {
+/**
+ * Request body for onboarding a worker into your company. In one call it creates the person (if new), their employment record and its custom-field values, roles, group memberships, an optional invite, and optional compliance details. first_name and last_name are required, and omitting either answers 400. Unless skip_invite is true, the invite needs a work email or a phone number, and a request with neither answers 422 at both fields. An unlisted key answers 400. A value of the wrong JSON type, a null for a field that is not nullable, or a value outside a listed set answers 422 at its pointer, and nothing is written.
+ */
+export type UserParameters = {
     /**
      * Work email address; the worker signs in and receives their invite here. Null when the worker has none. Required to send an invite unless a phone number is given.
      */
@@ -5313,11 +5508,11 @@ export type UserParameters = ({
      */
     phone_number?: string | null;
     /**
-     * Legal first name. Used for compliance and other exports.
+     * Legal first name. Used for compliance and other exports. Null or blank text answers 422.
      */
     first_name: string;
     /**
-     * Legal last name. Used for compliance and other exports.
+     * Legal last name. Used for compliance and other exports. Null or blank text answers 422.
      */
     last_name: string;
     /**
@@ -5331,116 +5526,115 @@ export type UserParameters = ({
     /**
      * City of the worker's contact address.
      */
-    city?: string;
+    city?: string | null;
     /**
      * Two-letter US state code of the worker's contact address.
      */
-    state?: string;
+    state?: string | null;
     /**
-     * Date of birth (YYYY-MM-DD).
+     * Date of birth as a YYYY-MM-DD calendar date; any other form answers 422.
      */
-    birth_date?: string;
+    birth_date?: string | null;
     /**
      * US Department of Labor apprentice number, when the worker is a registered apprentice.
      */
-    dol_apprentice_no?: string;
+    dol_apprentice_no?: string | null;
     /**
      * GWO WINDA training record id (Global Wind Organisation), formatted as two letters, six digits, then two letters.
      */
-    winda_id?: string;
+    winda_id?: string | null;
     /**
      * URL of the worker's LinkedIn profile.
      */
-    linkedin_url?: string;
+    linkedin_url?: string | null;
     /**
-     * Roles to grant the worker at your company, as an array of role strings such as TECHNICIAN, FIELD_LEAD, MANAGER, SAFETY_MANAGER, and ADMIN.
+     * Roles to grant the worker at your company, as an array of role strings such as TECHNICIAN, FIELD_LEAD, MANAGER, SAFETY_MANAGER, and ADMIN. Omit or send an empty array to grant none. Null, a non-string, blank or repeated role answers 422.
      */
-    roles?: Array<string> | null;
+    roles?: Array<string>;
     /**
      * Signed ID of a direct-upload blob to attach as the profile picture. Obtain it by first uploading the image to POST /api/v1/direct_uploads. Null creates the worker without one; a blank string answers 422.
      */
     avatar_signed_id?: string | null;
     /**
-     * Id of the internal user recorded as the creator of the worker's invite, and named to the recipient as the person inviting them. A user key always records its own user and answers 403 if the body names one; a company key must name a user your company can see, or the request answers 404. Ignored when skip_invite is set.
+     * Id of the internal user recorded as the creator of the worker's invite, and named to the recipient as the person inviting them. A user key always records its own user and answers 403 if the body names one; a company key must name a user your company can see, or the request answers 404. Omit or send null to record none; blank text answers 422. Ignored when skip_invite is set.
      */
-    created_by_user_id?: string;
+    created_by_user_id?: string | null;
     /**
      * Id of the internal user recorded as having last sent the worker's invite, and named as the sender on that person's in-app notification. Read like created_by_user_id. Null, and ignored, when skip_invite is set.
      */
     last_sent_by_user_id?: string | null;
     /**
-     * Non-stored field. If true will not send an invite notification.
+     * Non-stored field. If true, the invite is created without notifying the worker. Null is not accepted.
      */
     skip_notify?: boolean;
     /**
-     * Non-stored field. If true, no invite is created and work email / phone are not required.
+     * Non-stored field. If true, no invite is created and work email / phone are not required. Null is not accepted.
      */
     skip_invite?: boolean;
-    type?: UserCompanyType;
     /**
-     * Job title at your company.
+     * First day of employment (YYYY-MM-DD). Sets the start of the employment record; defaults to today when omitted. Null, blank text, or any other form answers 422.
      */
-    title?: string;
+    hire_date?: string;
     /**
-     * Id of the worker's manager at your company (another user).
+     * Whether the worker is an `EMPLOYEE` (W-2) or a `CONTRACTOR` (1099), in upper case. Omit to use `EMPLOYEE`; null is not accepted.
      */
-    manager_user_id?: string;
+    type?: 'EMPLOYEE' | 'CONTRACTOR';
     /**
-     * The worker's identifier in your payroll system of record.
+     * Job title at your company.
      */
-    payroll_id?: string;
+    title?: string | null;
     /**
-     * Base pay rate as a decimal string (for example "32.50"), in the company's currency.
+     * Id of the worker's manager at your company (another user). Omit or send null for no manager; blank text answers 422.
      */
-    hourly_rate?: string;
+    manager_user_id?: string | null;
     /**
-     * How the worker is paid: `hourly` or `salary`. Omit to use `hourly`; null is not accepted.
+     * The worker's identifier in your payroll system of record.
      */
-    compensation_type?: 'hourly' | 'salary';
+    payroll_id?: string | null;
     /**
-     * Whether the worker is eligible for overtime pay.
+     * Whether to enroll the worker in Time and Attendance (time tracking). Omit to use true; null is not accepted.
      */
-    overtime_eligible?: string;
+    enrolled_in_t_and_a?: boolean;
     /**
-     * Whether to enroll the worker in Time and Attendance (time tracking).
+     * How the worker is paid: `hourly` or `salary`, in lower case. Omit to use `hourly`; null is not accepted.
      */
-    enrolled_in_t_and_a?: string;
+    compensation_type?: 'hourly' | 'salary';
     /**
-     * Annual training-fund contribution as a decimal string. Used in prevailing-wage fringe calculations.
+     * Base hourly pay in cents as a decimal string (for example "3250" for 32.50). Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422; send the amount as a string.
      */
-    training_annual_amount?: string;
+    hourly_rate_cents?: string | null;
     /**
-     * Employer-paid annual combined health benefit as a decimal string. Null to leave unset.
+     * Annual training-fund contribution in cents as a decimal string. Used in prevailing-wage fringe calculations. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    employer_combined_health_amount?: string | null;
+    training_annual_amount_cents?: string | null;
     /**
-     * Employer-paid annual combined savings and retirement benefit as a decimal string. Null to leave unset.
+     * Employer-paid annual combined health benefit in cents as a decimal string. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    employer_combined_savings?: string | null;
+    employer_combined_health_amount_cents?: string | null;
     /**
-     * Annualized minutes the worker is expected to work, used to annualize fringe benefits.
+     * Employer-paid annual combined savings and retirement benefit in cents as a decimal string. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    worked_annual_minutes?: string;
+    employer_combined_savings_cents?: string | null;
     /**
-     * Paid time off accrued for the year, in minutes.
+     * Whether the worker is eligible for overtime pay. Omit to use true; null is not accepted.
      */
-    pto_annual_minutes?: string;
+    overtime_eligible?: boolean;
     /**
-     * Holiday time accrued for the year, in minutes.
+     * Annualized minutes the worker is expected to work, used to annualize fringe benefits, as a whole number.
      */
-    holiday_annual_minutes?: string;
+    worked_annual_minutes?: number | null;
     /**
-     * Paid training time for the year, in minutes.
+     * Paid time off accrued for the year, in whole minutes.
      */
-    training_annual_minutes?: string;
+    pto_annual_minutes?: number | null;
     /**
-     * First day of employment (YYYY-MM-DD). Sets the start of the employment record; defaults to today when omitted.
+     * Holiday time accrued for the year, in whole minutes.
      */
-    hire_date?: string;
+    holiday_annual_minutes?: number | null;
     /**
-     * Ids of the groups to add the worker to at your company.
+     * Paid training time for the year, in whole minutes.
      */
-    group_ids?: Array<string> | null;
+    training_annual_minutes?: number | null;
     /**
      * Values for the employment's custom fields, as a list of configurations and their values. Each configuration may appear only once. Every visible configuration gets a stored value; one left out of the list, or an omitted or empty list, stores null.
      */
@@ -5455,7 +5649,11 @@ export type UserParameters = ({
         value: string | null;
     }>;
     /**
-     * Prevailing-wage and apprenticeship compliance details to create for the worker (home address, demographics, and jurisdiction-specific reporting fields). Omit when the worker has no compliance record.
+     * Unique nonblank IDs of the groups at your company to add the worker to. Omit or send an empty array to add the worker to none. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before the worker is created.
+     */
+    group_ids?: Array<string>;
+    /**
+     * Prevailing-wage and apprenticeship compliance details to create for the worker (home address, demographics, and jurisdiction-specific reporting fields). Omit it, or send an empty object, when the worker has no compliance record; null answers 422.
      */
     company_user_pwa_info?: {
         /**
@@ -5542,7 +5740,7 @@ export type UserParameters = ({
          * Oregon BOLI race classification, as an array of codes such as white, asian, hispanic_or_latino, and black_or_african_american.
          */
         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;
+    };
 };
 /**
  * A page of time entries, with pagination metadata and navigation links.
@@ -5641,11 +5839,11 @@ export type TimeEntryResponseObject = {
      */
     timekeeping_pay_period_id: string;
     /**
-     * ISO8601 timestamp when work began; falls on a whole-minute boundary.
+     * ISO8601 timestamp in UTC (`Z`) when work began; falls on a whole-minute boundary.
      */
     start_time: string;
     /**
-     * ISO8601 timestamp when work ended; falls on a whole-minute boundary.
+     * ISO8601 timestamp in UTC (`Z`) when work ended; falls on a whole-minute boundary.
      */
     end_time: string;
     /**
@@ -5713,23 +5911,27 @@ export type ManagerTimeEntryApprovalParameters = {
     approver_user_id: string;
 };
 /**
- * The time-entry body fields shared by the create and update bodies; each of those declares its own requiredness.
+ * Request body for creating a time entry. timekeeping_time_card_id, start_time, and end_time are required, and omitting one answers 400.
  */
-export type TimeEntryParameters = {
+export type TimeEntryCreateParameters = {
     /**
-     * these will be rounded to the nearest second
+     * Id of the time card to attach the entry to; user_id is derived server-side from it. Required and set at creation. Null or a value that is not a nonblank string answers 422; a card outside the key's scope answers 404.
      */
-    start_time?: string;
+    timekeeping_time_card_id: string;
     /**
-     * these will be rounded to the nearest second
+     * Start of the work as a timestamp string, rounded to the nearest second. A time with an offset (`Z` or `-05:00`) is read at that instant. A time without one is read in the time card's pay schedule zone (`tz_name`); a time the clocks skip when they spring forward is read an hour later, and a time they repeat when they fall back is read as its first occurrence. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    end_time?: string;
+    start_time: string;
     /**
-     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null (or omit) for no job.
+     * End of the work as a timestamp string, rounded to the nearest second. A time with an offset (`Z` or `-05:00`) is read at that instant. A time without one is read in the time card's pay schedule zone (`tz_name`); a time the clocks skip when they spring forward is read an hour later, and a time they repeat when they fall back is read as its first occurrence. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
+     */
+    end_time: string;
+    /**
+     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null for no job; a blank string answers 422.
      */
     job_id?: string | null;
     /**
-     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none.
+     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none; a blank string answers 422.
      */
     timekeeping_timecode_id?: string | null;
     /**
@@ -5745,31 +5947,54 @@ export type TimeEntryParameters = {
      */
     hourly_rate_cents?: string | null;
     /**
-     * Feature ids to allocate to this time entry. Only features your company can view are accepted.
+     * Complete desired set of unique nonblank IDs of the features to allocate to this time entry. Only features your company can view are accepted. Omit to keep the allocations (none on create); send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
      */
-    feature_ids?: Array<string> | null;
+    feature_ids?: Array<string>;
+    /**
+     * Send true to record an explicit "no feature" answer when the job requires a feature allocation and you're not supplying one; false or omission records none. Null or any non-boolean value answers 422.
+     */
+    feature_allocation_acknowledged?: boolean;
 };
 /**
- * Request body for creating a time entry — the time_entry_parameters fields plus the time card and the explicit "no feature" acknowledgement. timekeeping_time_card_id, start_time, and end_time are required.
+ * Request body for updating a time entry. Every field is optional, and an omitted field keeps its value.
  */
-export type TimeEntryCreateParameters = TimeEntryParameters & {
+export type TimeEntryUpdateParameters = {
     /**
-     * Id of the time card to attach the entry to; user_id is derived server-side from it. Set at creation.
+     * Start of the work as a timestamp string, rounded to the nearest second. A time with an offset (`Z` or `-05:00`) is read at that instant. A time without one is read in the time card's pay schedule zone (`tz_name`); a time the clocks skip when they spring forward is read an hour later, and a time they repeat when they fall back is read as its first occurrence. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    timekeeping_time_card_id: string;
+    start_time?: string;
     /**
-     * Set true to record an explicit "no feature" answer when the job requires a feature allocation and you're not supplying one.
+     * End of the work as a timestamp string, rounded to the nearest second. A time with an offset (`Z` or `-05:00`) is read at that instant. A time without one is read in the time card's pay schedule zone (`tz_name`); a time the clocks skip when they spring forward is read an hour later, and a time they repeat when they fall back is read as its first occurrence. Null or a non-string answers 422 at its pointer; a string that does not parse as a date and time answers 422 invalid_date.
      */
-    feature_allocation_acknowledged?: boolean | null;
-};
-/**
- * Request body for updating a time entry — the time_entry_parameters fields, every one optional, plus the acknowledgement that clears an apprenticeship allocation conflict.
- */
-export type TimeEntryUpdateParameters = TimeEntryParameters & {
+    end_time?: string;
+    /**
+     * Id of the job to work against; the worker must have a Position covering that job at start_time. Send null for no job; a blank string answers 422.
+     */
+    job_id?: string | null;
+    /**
+     * Id of the timecode to classify the entry; must be one of the company's default timecodes. Send null for none; a blank string answers 422.
+     */
+    timekeeping_timecode_id?: string | null;
+    /**
+     * Two-letter US state code where the work occurred; null to clear.
+     */
+    state?: string | null;
+    /**
+     * Free-text note on the entry (maximum 10,000 characters); null to clear.
+     */
+    description?: string | null;
     /**
-     * Set true to accept dropping the time card's apprenticeship hour allocations when the new times invalidate them; without it such an update returns 422.
+     * Base hourly rate in cents, sent as a string to preserve precision; omit it to let the system derive the rate from the position/user default, and null also derives the default. Admin only on user-scoped keys.
      */
-    confirm_allocation_conflict?: boolean | null;
+    hourly_rate_cents?: string | null;
+    /**
+     * Complete desired set of unique nonblank IDs of the features to allocate to this time entry. Only features your company can view are accepted. Omit to keep the allocations (none on create); send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
+     */
+    feature_ids?: Array<string>;
+    /**
+     * Send true to accept dropping the time card's apprenticeship hour allocations when the new times invalidate them; without it such an update returns 422. Null or any non-boolean value answers 422.
+     */
+    confirm_allocation_conflict?: boolean;
 };
 /**
  * A form definition — a SurveyJS form template built and versioned in the web app's form builder. The same object the list door serializes. Read-only.
@@ -5934,16 +6159,19 @@ export type FormSubmissionResponseObject = {
     updated_at: string;
 };
 /**
- * Request body for updating a worker's employment at your company. Corrects administrative fields (employment type, title, manager, payroll id, hire date, and time-and-attendance enrollment) across the whole employment history, and changes the custom-field values it lists. For time-effective pay changes, use the scheduled-changes endpoints instead.
+ * Request body for updating a worker's employment at your company. Corrects administrative fields (employment type, title, manager, payroll id, hire date, and time-and-attendance enrollment) across the whole employment history, and changes the custom-field values it lists. For time-effective pay changes, use the scheduled-changes endpoints instead. A value of the wrong JSON type, a null for a field that is not nullable, or a value outside a listed set answers 422 at its pointer, and nothing is written.
  */
 export type UserCompanyParameters = {
-    type?: UserCompanyType;
+    /**
+     * Whether the worker is an `EMPLOYEE` (W-2) or a `CONTRACTOR` (1099), in upper case. Null is not accepted.
+     */
+    type?: 'EMPLOYEE' | 'CONTRACTOR';
     /**
      * Job title at your company.
      */
     title?: string | null;
     /**
-     * Id of the worker's manager at your company (another user).
+     * Id of the worker's manager at your company (another user). Send null to clear it; blank text answers 422.
      */
     manager_user_id?: string | null;
     /**
@@ -5951,13 +6179,13 @@ export type UserCompanyParameters = {
      */
     payroll_id?: string | null;
     /**
-     * Employment start date (YYYY-MM-DD). Changing it moves the start of the employment history.
+     * Whether the worker is enrolled in Time and Attendance (time tracking). Null is not accepted.
      */
-    hire_date?: string | null;
+    enrolled_in_t_and_a?: boolean;
     /**
-     * Whether the worker is enrolled in Time and Attendance (time tracking).
+     * Employment start date (YYYY-MM-DD). Changing it moves the start of the employment history. Null or blank text leaves it where it is.
      */
-    enrolled_in_t_and_a?: boolean;
+    hire_date?: string | null;
     /**
      * Custom-field values to change, as a list of configurations and their replacement values. Each configuration may appear only once. Only the listed configurations change; every other configuration keeps its stored value, and an omitted or empty list changes none.
      */
@@ -5973,54 +6201,57 @@ export type UserCompanyParameters = {
     }>;
 };
 /**
- * Request body for adding a worker to your company, creating their employment record and its custom-field values. hire_date is required and sets when employment begins; the remaining fields seed the initial title, pay, benefits, and accruals. Returns the worker with the new employment flattened onto it.
+ * Request body for adding a worker to your company, creating their employment record and its custom-field values. hire_date is required and sets when employment begins; the remaining fields seed the initial title, pay, benefits, and accruals. Returns the worker with the new employment flattened onto it. Omitting hire_date answers 400. A value of the wrong JSON type, a null for a field that is not nullable, or a value outside a listed set answers 422 at its pointer, and nothing is written.
  */
 export type UserCompanyCreateParameters = {
     /**
-     * Employment start date (YYYY-MM-DD). Sets when employment begins. Required.
+     * Employment start date (YYYY-MM-DD). Sets when employment begins. Required; null, blank text, or any other form answers 422.
      */
     hire_date: string;
-    type?: UserCompanyType;
+    /**
+     * Whether the worker is an `EMPLOYEE` (W-2) or a `CONTRACTOR` (1099), in upper case. Omit to use `EMPLOYEE`; null is not accepted.
+     */
+    type?: 'EMPLOYEE' | 'CONTRACTOR';
     /**
      * Job title at your company.
      */
     title?: string | null;
     /**
-     * Id of the worker's manager at your company (another user).
+     * Id of the worker's manager at your company (another user). Omit or send null for no manager; blank text answers 422.
      */
     manager_user_id?: string | null;
     /**
-     * How the worker is paid: hourly or salary.
+     * The worker's identifier in your payroll system of record.
      */
-    compensation_type?: 'hourly' | 'salary';
+    payroll_id?: string | null;
     /**
-     * Whether to enroll the worker in Time and Attendance (time tracking).
+     * Whether to enroll the worker in Time and Attendance (time tracking). Null is not accepted.
      */
     enrolled_in_t_and_a?: boolean;
     /**
-     * The worker's identifier in your payroll system of record.
+     * How the worker is paid: `hourly` or `salary`, in lower case. Null is not accepted.
      */
-    payroll_id?: string | null;
+    compensation_type?: 'hourly' | 'salary';
     /**
-     * Base pay rate as a decimal string (for example "32.50"), in the company's currency.
+     * Base hourly pay in cents as a decimal string (for example "3250" for 32.50). Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422; send the amount as a string.
      */
-    hourly_rate?: string | null;
+    hourly_rate_cents?: string | null;
     /**
-     * Whether the worker is eligible for overtime pay.
+     * Annual training-fund contribution in cents as a decimal string. Used in prevailing-wage fringe calculations. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    overtime_eligible?: boolean;
+    training_annual_amount_cents?: string | null;
     /**
-     * Annual training-fund contribution as a decimal string. Used in prevailing-wage fringe calculations.
+     * Employer-paid annual combined health benefit in cents as a decimal string. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    training_annual_amount?: string | null;
+    employer_combined_health_amount_cents?: string | null;
     /**
-     * Employer-paid annual combined health benefit as a decimal string.
+     * Employer-paid annual combined savings and retirement benefit in cents as a decimal string. Omit or send null to leave it unset; send "0" for zero. A JSON number answers 422.
      */
-    employer_combined_health_amount?: string | null;
+    employer_combined_savings_cents?: string | null;
     /**
-     * Employer-paid annual combined savings and retirement benefit as a decimal string.
+     * Whether the worker is eligible for overtime pay. Omit to use true; null is not accepted.
      */
-    employer_combined_savings?: string | null;
+    overtime_eligible?: boolean;
     /**
      * Annualized minutes the worker is expected to work, used to annualize fringe benefits.
      */
@@ -6074,29 +6305,29 @@ export type UserCompanyScheduledChangesParameters = {
      */
     effective_date: string;
     /**
-     * Base pay rate as a decimal string (for example "32.50"), in the company's currency.
+     * Base hourly pay in cents as a decimal string (for example "3250" for 32.50). Omit to carry forward the preceding version, or send null to clear it; send "0" for zero.
      */
-    hourly_rate?: string | null;
+    hourly_rate_cents?: string | null;
     /**
-     * How the worker is paid: hourly or salary.
+     * Annual training-fund contribution in cents as a decimal string. Omit to carry forward the preceding version, or send null to clear it; send "0" for zero.
      */
-    compensation_type?: 'hourly' | 'salary';
+    training_annual_amount_cents?: string | null;
     /**
-     * Whether the worker is eligible for overtime pay.
+     * Employer-paid annual combined health benefit in cents as a decimal string. Omit to carry forward the preceding version, or send null to clear it; send "0" for zero.
      */
-    overtime_eligible?: boolean;
+    employer_combined_health_amount_cents?: string | null;
     /**
-     * Annual training-fund contribution as a decimal string.
+     * Employer-paid annual combined savings and retirement benefit in cents as a decimal string. Omit to carry forward the preceding version, or send null to clear it; send "0" for zero.
      */
-    training_annual_amount?: string | null;
+    employer_combined_savings_cents?: string | null;
     /**
-     * Employer-paid annual combined health benefit as a decimal string.
+     * How the worker is paid: hourly or salary.
      */
-    employer_combined_health_amount?: string | null;
+    compensation_type?: 'hourly' | 'salary';
     /**
-     * Employer-paid annual combined savings and retirement benefit as a decimal string.
+     * Whether the worker is eligible for overtime pay.
      */
-    employer_combined_savings?: string | null;
+    overtime_eligible?: boolean;
     /**
      * Annualized minutes the worker is expected to work, used to annualize fringe benefits.
      */
@@ -6407,7 +6638,7 @@ export type UserGroupResponse = {
  */
 export type UserGroupParameters = {
     /**
-     * Required nonempty array of user ID strings to add to the group. Users already in the group are ignored, and the full membership list is returned.
+     * Required nonempty array of unique nonblank IDs of the users to add to the group. Users already in the group are ignored, and the full membership list is returned. Omission answers 400; an empty array, null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anyone is added.
      */
     user_ids: Array<string>;
 };
@@ -6476,9 +6707,9 @@ export type UserCompanyScheduledChange = {
      */
     start_date: string;
     /**
-     * Base pay rate for this version, formatted as a currency string; null when unset.
+     * Base hourly pay for this version in cents as a decimal string; null when unset.
      */
-    hourly_rate: string | null;
+    hourly_rate_cents: string | null;
     /**
      * How the worker is paid: hourly or salary.
      */
@@ -6488,17 +6719,17 @@ export type UserCompanyScheduledChange = {
      */
     overtime_eligible: boolean;
     /**
-     * Annual training-fund contribution, formatted as a currency string; null when unset.
+     * Annual training-fund contribution in cents as a decimal string; null when unset.
      */
-    training_annual_amount: string | null;
+    training_annual_amount_cents: string | null;
     /**
-     * Employer-paid annual combined health benefit, formatted as a currency string; null when unset.
+     * Employer-paid annual combined health benefit in cents as a decimal string; null when unset.
      */
-    employer_combined_health_amount: string | null;
+    employer_combined_health_amount_cents: string | null;
     /**
-     * Employer-paid annual combined savings and retirement benefit, formatted as a currency string; null when unset.
+     * Employer-paid annual combined savings and retirement benefit in cents as a decimal string; null when unset.
      */
-    employer_combined_savings: string | null;
+    employer_combined_savings_cents: string | null;
     /**
      * Annualized minutes the worker is expected to work in this version; null when unset.
      */
@@ -6529,6 +6760,47 @@ export type UserCompanyScheduledTerminationParameters = {
      */
     termination_date: string;
 };
+/**
+ * A pay period — a bounded pay window generated automatically by its pay schedule (PayPeriodConfig).
+ */
+export type PayPeriodResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * ID of the pay schedule (PayPeriodConfig) that owns this pay period, stable across all of its versions.
+     */
+    timekeeping_pay_period_config_id: string;
+    /**
+     * Calendar date (YYYY-MM-DD) that workers are paid for this period.
+     */
+    pay_date: string;
+    /**
+     * Start of the pay-period window (ISO 8601).
+     */
+    start_time: string;
+    /**
+     * End of the pay-period window (ISO 8601).
+     */
+    end_time: string;
+    /**
+     * When payroll must be run for this period (ISO 8601).
+     */
+    pay_run_deadline: string;
+    /**
+     * When time-card approvals are due for this period (ISO 8601).
+     */
+    approvals_deadline: string;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
+    /**
+     * When the record was last updated (ISO 8601).
+     */
+    updated_at: string;
+};
 /**
  * A page of pay periods. A pay period is a bounded pay window generated automatically by its pay schedule (PayPeriodConfig), so this API is read-only.
  */
@@ -6538,44 +6810,7 @@ export type PayPeriodsResponseObject = {
     /**
      * The page of pay periods.
      */
-    data: Array<{
-        /**
-         * Unique identifier.
-         */
-        id: string;
-        /**
-         * ID of the pay schedule (PayPeriodConfig) that owns this pay period, stable across all of its versions.
-         */
-        timekeeping_pay_period_config_id: string;
-        /**
-         * Calendar date (YYYY-MM-DD) that workers are paid for this period.
-         */
-        pay_date: string;
-        /**
-         * Start of the pay-period window (ISO 8601).
-         */
-        start_time: string;
-        /**
-         * End of the pay-period window (ISO 8601).
-         */
-        end_time: string;
-        /**
-         * When payroll must be run for this period (ISO 8601).
-         */
-        pay_run_deadline: string;
-        /**
-         * When time-card approvals are due for this period (ISO 8601).
-         */
-        approvals_deadline: string;
-        /**
-         * When the record was created (ISO 8601).
-         */
-        created_at: string;
-        /**
-         * When the record was last updated (ISO 8601).
-         */
-        updated_at: string;
-    }>;
+    data: Array<PayPeriodResponseObject>;
 };
 /**
  * One problem found while processing an accepted import, whatever its type.
@@ -6836,7 +7071,7 @@ export type TimeEntryImportResponseObject = {
     updated_at: string;
 };
 /**
- * Submit a spreadsheet of time entries for a pay period. All seven of payroll_id, start_time, end_time, timecode, job_id, state and description must be present as column headers, or the file is refused naming the ones missing. Of those, payroll_id, start_time, end_time, timecode and state must also carry a value on every row. features, federal_labor_classification and regional_labor_classification are read when present. Header matching ignores case and treats spaces as underscores, and column order does not matter. Any other column is refused: a name this import does not read would be dropped without trace, so the file is rejected naming it rather than applied in part.
+ * Submit a spreadsheet of time entries for a pay period. All six of payroll_id, start_time, end_time, timecode, job_id and description must be present as column headers, or the file is refused naming the ones missing. The payroll_id, start_time, end_time and timecode columns must carry a value on every row. The state column may be omitted, or its cells left blank, when the row's Job resolves a recognized state through its operating region, address, then oldest qualifying Site address. A valid explicit state overrides this fallback; an invalid supplied state fails. Missing or blank state without a Job, unresolved geography, or an unrecognized address region rejects the whole file with row-specific errors. The original file retains omissions and blank values, so background processing resolves current Job geography again. features, federal_labor_classification and regional_labor_classification are read when present. Header matching ignores case and treats spaces as underscores, and column order does not matter. Any other column is refused: a name this import does not read would be dropped without trace, so the file is rejected naming it rather than applied in part.
  *
  * Because acceptance is synchronous but the write happens in the background, only one import at a time is accepted for a pay period: while an earlier one is still `pending` or `processing`, a second answers 409 naming `import_in_progress`, and nothing is written. Poll the earlier import until it reports, then submit again.
  */
@@ -8018,11 +8253,11 @@ export type ProjectResponseObject = {
     /**
      * Project budget as a money amount in cents, serialized as a decimal string (e.g. "500000.0" for a $5,000 budget), or null.
      */
-    budget_cents: string | null;
+    budget_cents?: string | null;
     /**
      * ISO 4217 currency code for the budget, or null; defaults to "USD".
      */
-    budget_currency: string | null;
+    budget_currency?: string | null;
     /**
      * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null.
      */
@@ -8053,7 +8288,7 @@ export type ProjectResponseObject = {
     updated_at: string;
 };
 /**
- * Request body for creating a project. `name` and `created_by_user_id` are required; the creator must be a member of the owning company. The owning company is inferred from the API key and is not part of the body. Undeclared body keys return 400 before any project or relationship is saved.
+ * Request body for creating a project. `name` and `created_by_user_id` are required, and omitting either returns 400; the creator must be a member of the owning company. The owning company is inferred from the API key and is not part of the body. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any project or relationship is saved.
  */
 export type ProjectParameters = {
     /**
@@ -8061,7 +8296,7 @@ export type ProjectParameters = {
      */
     external_id?: string | null;
     /**
-     * Human-readable project name; required, and must be unique within the owning company.
+     * Human-readable project name; required, and must be unique within the owning company. Null, a blank string, or a wrong type answers 422.
      */
     name: string;
     /**
@@ -8069,11 +8304,7 @@ export type ProjectParameters = {
      */
     description?: string | null;
     /**
-     * User recorded as the project's creator; must be a member of the owning company. Required on create and immutable thereafter. Send it only on create; every update that includes it returns 400, even when unchanged.
-     */
-    created_by_user_id: string;
-    /**
-     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; the child schedule must fit within the parent's schedule.
+     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; a blank ID or a wrong type answers 422. The child schedule must fit within the parent's schedule.
      */
     parent_id?: string | null;
     /**
@@ -8081,35 +8312,35 @@ export type ProjectParameters = {
      */
     participating_company_ids?: Array<string>;
     /**
-     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set.
+     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
     start_date?: string | null;
     /**
-     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date.
+     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date. Any other string, a timestamp included, answers 422.
      */
     end_date?: string | null;
     /**
-     * IANA time zone name. Required when start_date is set.
+     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
      */
     tz_name?: string | null;
     /**
-     * Day of week billing starts: 0 (Sunday) through 6 (Saturday).
+     * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
     billing_start_day?: number | null;
     /**
-     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Any other value returns 422.
+     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Null or any other value returns 422.
      */
     federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Any value other than `none` requires `region`.
+     * Regional PWA tracking mode, with the same values as `federal_pwa_mode`; null or any other value returns 422. Any value other than `none` requires `region`.
      */
     regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * US state abbreviation; must be one of the owning company's operating regions.
+     * US state abbreviation, or null; must be one of the owning company's operating regions.
      */
     region?: string | null;
     /**
-     * Gates IRA tax-credit checks. Applies only while `federal_pwa_mode` is not `none` — sending `true` or null while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
+     * Gates IRA tax-credit checks. A boolean; null or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending `true` while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
      */
     asset_owner?: boolean;
     /**
@@ -8125,24 +8356,28 @@ export type ProjectParameters = {
      */
     administrator_phone?: string | null;
     /**
-     * Decimal string (e.g. "5000.0"). Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Budget in cents as a decimal string (e.g. "500000" or the read form "500000.0" for $5,000), or null to clear it; a JSON number or any other type returns 422, and a fraction rounds to two decimal places. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
-    budget?: string;
+    budget_cents?: string | null;
     /**
-     * Prevailing-wage lock-in date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Prevailing-wage lock-in date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     prevailing_wage_lock_in_date?: string | null;
     /**
-     * IRA beginning-of-construction date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA beginning-of-construction date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     beginning_of_construction_date?: string | null;
     /**
-     * IRA placed-in-service date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * IRA placed-in-service date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
      */
     placed_in_service_date?: string | null;
+    /**
+     * User recorded as the project's creator; must be a member of the owning company. Required on create and immutable thereafter. Omission answers 400; null, a blank ID, or a wrong type answers 422. Send it only on create; every update that includes it returns 400, even when unchanged.
+     */
+    created_by_user_id: string;
 };
 /**
- * Request body for updating a project. Every field is optional; omit a field to preserve its current value. The resulting project must still satisfy conditional PWA, regional, and schedule validation rules. `created_by_user_id` is create-only; omit it on PATCH. Every update that includes it returns 400, even when unchanged. Undeclared body keys return 400 before any project or relationship changes.
+ * Request body for updating a project. Every field is optional; omit a field to preserve its current value. The resulting project must still satisfy conditional PWA, regional, and schedule validation rules. `created_by_user_id` is create-only; omit it on PATCH. Every update that includes it returns 400, even when unchanged. Undeclared body keys return 400, and a null for a field that is not nullable or a wrongly typed value returns 422 at its pointer, before any project or relationship changes.
  */
 export type ProjectUpdateParameters = {
     /**
@@ -8150,7 +8385,7 @@ export type ProjectUpdateParameters = {
      */
     external_id?: string | null;
     /**
-     * Human-readable project name; omit to preserve the current value. The resulting project name must remain present and unique within the owning company.
+     * Human-readable project name; omit to preserve the current value. Null, a blank string, or a wrong type answers 422, and the name must remain unique within the owning company.
      */
     name?: string;
     /**
@@ -8158,7 +8393,7 @@ export type ProjectUpdateParameters = {
      */
     description?: string | null;
     /**
-     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; the child schedule must fit within the parent's schedule.
+     * ID of a project visible to the API key's policy. The parent must be owned by this project's owner or list that owner in its participating_company_ids. Send null to make the project a root; a blank ID or a wrong type answers 422. The child schedule must fit within the parent's schedule.
      */
     parent_id?: string | null;
     /**
@@ -8166,104 +8401,225 @@ export type ProjectUpdateParameters = {
      */
     participating_company_ids?: Array<string>;
     /**
-     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set.
+     * Schedule start date as an ISO8601 date (YYYY-MM-DD), or null; requires tz_name to be set. Any other string, a timestamp included, answers 422.
      */
     start_date?: string | null;
     /**
-     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date.
+     * Schedule end date as an ISO8601 date (YYYY-MM-DD), or null; must be on or after start_date. Any other string, a timestamp included, answers 422.
      */
     end_date?: string | null;
     /**
-     * IANA time zone name. Required when start_date is set.
+     * IANA time zone name, or null. Required when start_date is set. A blank or unlisted name answers 422.
      */
     tz_name?: string | null;
     /**
-     * Day of week billing starts: 0 (Sunday) through 6 (Saturday).
+     * Day of week billing starts, as an integer: 0 (Sunday) through 6 (Saturday), or null. Any other value, a numeric string included, answers 422.
      */
     billing_start_day?: number | null;
     /**
-     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Any other value returns 422.
+     * Federal PWA tracking mode: `all` (prevailing wage + apprenticeship), `pw_only`, `ap_only`, or `none`. Null or any other value returns 422.
      */
     federal_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
     /**
-     * Any value other than `none` requires `region`.
+     * Regional PWA tracking mode, with the same values as `federal_pwa_mode`; null or any other value returns 422. Any value other than `none` requires `region`.
+     */
+    regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
+    /**
+     * US state abbreviation, or null; must be one of the owning company's operating regions.
+     */
+    region?: string | null;
+    /**
+     * Gates IRA tax-credit checks. A boolean; null or any other type returns 422. Applies only while `federal_pwa_mode` is not `none` — sending `true` while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
+     */
+    asset_owner?: boolean;
+    /**
+     * Name of the project administrator. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    administrator_name?: string | null;
+    /**
+     * Email of the project administrator. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    administrator_email?: string | null;
+    /**
+     * Phone of the project administrator, normalized to E.164. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    administrator_phone?: string | null;
+    /**
+     * Budget in cents as a decimal string (e.g. "500000" or the read form "500000.0" for $5,000), or null to clear it; a JSON number or any other type returns 422, and a fraction rounds to two decimal places. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    budget_cents?: string | null;
+    /**
+     * Prevailing-wage lock-in date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    prevailing_wage_lock_in_date?: string | null;
+    /**
+     * IRA beginning-of-construction date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    beginning_of_construction_date?: string | null;
+    /**
+     * IRA placed-in-service date as an ISO8601 date (YYYY-MM-DD); any other string, a timestamp included, answers 422. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     */
+    placed_in_service_date?: string | null;
+};
+/**
+ * A project–site assignment: the join linking a project to a site, optionally scoping which of that site's features apply. Path `{id}` is this join's id, not the Site's. Not included on project GET.
+ */
+export type ProjectSiteResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * ID of the linked site.
+     */
+    site_id: string;
+    /**
+     * IDs of the site's features that apply to this project. Empty when none are scoped.
+     */
+    feature_ids: Array<string>;
+};
+/**
+ * Request body for attaching a site to a project. `site_id` is required; `feature_ids` is optional. The project is taken from the path and is not part of the body.
+ */
+export type ProjectSiteParameters = {
+    /**
+     * ID of a site visible to the API key. The site must be public or private to the project's owning company. Duplicate (project, site) pairs are rejected. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422.
+     */
+    site_id: string;
+    /**
+     * Optional complete set of unique nonblank feature IDs on that site to scope to this project. Omit to attach the site with no features. Each feature must belong to the site. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     */
+    feature_ids?: Array<string>;
+};
+/**
+ * Request body for replacing which of the site's features apply to this project. Every field is optional; omit a field to preserve its current value. `site_id` is create-only and an update that names it is rejected.
+ */
+export type ProjectSiteUpdateParameters = {
+    /**
+     * Complete desired set of unique nonblank feature IDs on the linked site. Send an empty array to clear the set. Omit to leave the current set unchanged. Each feature must belong to the site. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     */
+    feature_ids?: Array<string>;
+};
+/**
+ * A file attached to a project. Uploaded through the direct-upload flow. `name` is always "document" and is not client-writable.
+ */
+export type ProjectDocumentResponseObject = {
+    /**
+     * Unique identifier.
+     */
+    id: string;
+    /**
+     * ID of the project this document belongs to.
+     */
+    project_id: string;
+    /**
+     * Read-only document label; this API does not set it, so it is always "document".
+     */
+    name: string;
+    /**
+     * The file's human-readable download name; null when not set.
      */
-    regional_pwa_mode?: 'all' | 'pw_only' | 'ap_only' | 'none';
+    filename: string | null;
     /**
-     * US state abbreviation; must be one of the owning company's operating regions.
+     * Free-text description of the document; null when none.
      */
-    region?: string | null;
+    description: string | null;
     /**
-     * Gates IRA tax-credit checks. Applies only while `federal_pwa_mode` is not `none` — sending `true` or null while federal tracking is off returns 422, and switching to `none` sets it back to `false`.
+     * ID of the user who uploaded the document.
      */
-    asset_owner?: boolean;
+    created_by_user_id: string;
     /**
-     * Name of the project administrator. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * The attached file; null while no blob is attached.
      */
-    administrator_name?: string | null;
+    file: {
+        /**
+         * Stored name of the uploaded file.
+         */
+        filename: string;
+        /**
+         * MIME type of the file; null when not recorded.
+         */
+        content_type: string | null;
+        /**
+         * Size of the file in bytes.
+         */
+        byte_size: number;
+        /**
+         * A URL to download the file.
+         */
+        url: string;
+    } | null;
     /**
-     * Email of the project administrator. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * When the record was created (ISO 8601).
      */
-    administrator_email?: string | null;
+    created_at: string;
     /**
-     * Phone of the project administrator, normalized to E.164. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * When the record was last updated (ISO 8601).
      */
-    administrator_phone?: string | null;
+    updated_at: string;
+};
+/**
+ * Attach a file to a project as a document. file is required and takes a signed_id from the direct-upload endpoint.
+ */
+export type ProjectDocumentParameters = {
     /**
-     * Decimal string (e.g. "5000.0"). Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * A signed_id from POST /api/v1/direct_uploads identifying the uploaded blob to attach. Register the upload naming `projects.documents` — a signed_id issued for any other resource will not resolve here. Null and a blank string answer 422. Omitting file answers 400.
      */
-    budget?: string;
+    file: string;
     /**
-     * Prevailing-wage lock-in date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * The file's human-readable download name; null when not set.
      */
-    prevailing_wage_lock_in_date?: string | null;
+    filename?: string | null;
     /**
-     * IRA beginning-of-construction date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * Free-text description of the document; null when none.
      */
-    beginning_of_construction_date?: string | null;
+    description?: string | null;
     /**
-     * IRA placed-in-service date as an ISO8601 date. Applies only while `federal_pwa_mode` is not `none` — sending it while federal tracking is off, even as null, returns 422, and switching to `none` clears the stored value.
+     * ID of the user this document is attached on behalf of, recorded as its creator. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
-    placed_in_service_date?: string | null;
+    performed_by_user_id: string;
 };
 /**
- * A project–site assignment: the join linking a project to a site, optionally scoping which of that site's features apply. Path `{id}` is this join's id, not the Site's. Not included on project GET.
+ * Update a project document. All fields are optional — send only what changes. Omit file to retain the existing attachment, or supply a new signed_id to replace it. A document always holds a file, so null answers 422, as does a blank string. `name` is read-only; sending it answers 400.
  */
-export type ProjectSiteResponseObject = {
+export type ProjectDocumentUpdateParameters = {
     /**
-     * Unique identifier.
+     * A signed_id from POST /api/v1/direct_uploads identifying a replacement blob. Register the upload naming `projects.documents` — a signed_id issued for any other resource will not resolve here.
      */
-    id: string;
+    file?: string;
     /**
-     * ID of the linked site.
+     * The file's human-readable download name; null when not set.
      */
-    site_id: string;
+    filename?: string | null;
     /**
-     * IDs of the site's features that apply to this project. Empty when none are scoped.
+     * Free-text description of the document; null when none.
      */
-    feature_ids: Array<string>;
+    description?: string | null;
 };
 /**
- * Request body for attaching a site to a project. `site_id` is required; `feature_ids` is optional. The project is taken from the path and is not part of the body.
+ * One entry in a project document's PaperTrail change history, recorded whenever the document is created, updated, or deleted — including when only its attached file is replaced. This is transaction-time audit data, not a temporal valid-time version.
  */
-export type ProjectSiteParameters = {
+export type ProjectDocumentVersionResponseObject = {
     /**
-     * ID of a site visible to the API key. The site must be public or private to the project's owning company. Duplicate (project, site) pairs are rejected. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422.
+     * Unique identifier.
      */
-    site_id: string;
+    id: number;
     /**
-     * Optional complete set of unique nonblank feature IDs on that site to scope to this project. Omit to attach the site with no features. Each feature must belong to the site. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     * ID of the document this version belongs to.
      */
-    feature_ids?: Array<string>;
-};
-/**
- * Request body for replacing which of the site's features apply to this project. Every field is optional; omit a field to preserve its current value. `site_id` is create-only and an update that names it is rejected.
- */
-export type ProjectSiteUpdateParameters = {
+    document_id: string;
     /**
-     * Complete desired set of unique nonblank feature IDs on the linked site. Send an empty array to clear the set. Omit to leave the current set unchanged. Each feature must belong to the site. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422.
+     * The change this version records: one of create, update, or destroy.
      */
-    feature_ids?: Array<string>;
+    event: 'create' | 'update' | 'destroy';
+    /**
+     * ID of the user who made the change; null when it was not attributed to a user.
+     */
+    whodunnit: string | null;
+    /**
+     * When the record was created (ISO 8601).
+     */
+    created_at: string;
 };
 export type SiteCheckInResponseObject = {
     id: string;
@@ -8291,6 +8647,10 @@ export type SiteCheckInResponseObject = {
     longitude: number | null;
     start_time: string;
     end_time: string | null;
+    /**
+     * Whole minutes between start_time and end_time, rounded to the nearest minute; null while the check-in is still open.
+     */
+    duration_minutes: number | null;
     verified_at: string | null;
     created_at: string;
     updated_at: string;
@@ -8710,19 +9070,19 @@ export type ComplianceCheckDocumentObject = {
     created_at: string;
 };
 /**
- * Update a compliance check. Every field is optional.
+ * Update a compliance check. Every field is optional. Undeclared body keys return 400, and a wrong-typed value, a null for a field that is not nullable, or a status outside the list returns 422 at its pointer before anything is written.
  */
 export type ComplianceCheckParameters = {
     /**
-     * Only the person-settable statuses are writable, mirroring the web app: `dismissed` excludes the check from automatic re-evaluation; `pending` re-evaluates it on save. Evaluation owns `passed`/`failed`.
+     * Only the person-settable statuses are writable, mirroring the web app: `dismissed` excludes the check from automatic re-evaluation; `pending` re-evaluates it on save. Evaluation owns `passed`/`failed`, so sending either, or null, answers 422.
      */
     status?: 'dismissed' | 'pending';
     /**
-     * When the check is due (ISO 8601); send null to clear it, or omit to leave it unchanged.
+     * When the check is due, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`). Send null to clear it, or omit to leave it unchanged. A value that is not a string answers 422.
      */
     time_due?: string | null;
     /**
-     * Replaces the check's assignees: send every user id that should be assigned, or an empty array to clear them. Every id must belong to a person in your company. Omit to leave the assignees unchanged.
+     * Replaces the check's assignees: send every user id that should be assigned, each once, or an empty array to clear them. Every id must belong to a person in your company. Omit to leave the assignees unchanged. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
      */
     assignee_user_ids?: Array<string>;
     /**
@@ -8755,6 +9115,8 @@ export type TodoInboxTodoResponseObject = {
     created_by_user_id: string;
     updated_by_user_id: string;
     completed: boolean;
+    priority: 'critical' | 'high' | 'medium' | 'low' | null;
+    category: 'apprenticeship' | 'certified_payroll' | 'company' | 'job' | 'payroll' | 'project' | 'regional' | 'tax_credit' | 'timekeeping' | 'worker';
     task_assignee_user_ids: Array<string>;
     description: RichTextObject;
     time_due: string | null;
@@ -9434,7 +9796,7 @@ export type PaystubLineItemResponseObject = {
     updated_at: string;
 };
 /**
- * Request body for creating a paystub line item. All four fields are required. Undeclared body keys are rejected with 400; references outside the authenticated company return 404.
+ * Request body for creating a paystub line item. All four fields are required. Undeclared body keys or an omitted field answer 400; a null or blank value, or any wrong-typed value, answers 422; references outside the authenticated company return 404.
  */
 export type PaystubLineItemParameters = {
     /**
@@ -9442,7 +9804,7 @@ export type PaystubLineItemParameters = {
      */
     payrolls_paystub_id: string;
     /**
-     * Amount of this line, in cents as a decimal string (e.g. "5000.0" is $50.00). Required.
+     * Amount of this line, in cents as a decimal string (e.g. "5000.0" is $50.00); a JSON number answers 422. Required.
      */
     amount_cents: string;
     /**
@@ -9455,7 +9817,7 @@ export type PaystubLineItemParameters = {
     payrolls_external_map_id: string;
 };
 /**
- * Request body for updating a paystub line item. Send only the fields to change. Undeclared body keys are rejected with 400; newly supplied references outside the authenticated company return 404.
+ * Request body for updating a paystub line item. Send only the fields to change. Undeclared body keys are rejected with 400; a null or blank value, or any wrong-typed value, answers 422; newly supplied references outside the authenticated company return 404.
  */
 export type PaystubLineItemUpdateParameters = {
     /**
@@ -9463,7 +9825,7 @@ export type PaystubLineItemUpdateParameters = {
      */
     payrolls_paystub_id?: string;
     /**
-     * Amount of this line, in cents as a decimal string (e.g. "5000.0" is $50.00). Omit to leave it unchanged.
+     * Amount of this line, in cents as a decimal string (e.g. "5000.0" is $50.00); a JSON number answers 422. Omit to leave it unchanged.
      */
     amount_cents?: string;
     /**
@@ -9525,6 +9887,137 @@ export type JobSiteUpdateParameters = {
      */
     feature_ids?: Array<string>;
 };
+/**
+ * A document attached to a job — either an uploaded file or an external URL, never both. Includes PWA documentation when the caller may see it.
+ */
+export type JobDocumentResponseObject = {
+    /**
+     * Id of the job document.
+     */
+    id: string;
+    /**
+     * Id of the job this document belongs to. Taken from the path on writes.
+     */
+    job_id: string;
+    /**
+     * Human-readable document name.
+     */
+    name: string;
+    /**
+     * Document type code from the DocumentType catalog, including `PWA_DOCUMENTATION`.
+     */
+    type: 'CERTIFICATIONS' | 'CHECKLIST' | 'MAP' | 'MSA' | 'ONSITE_POSTER' | 'OTHER' | 'PARTS_INSTRUCTIONS' | 'PHOTO' | 'PO' | 'PWA_DOCUMENTATION' | 'RESUME' | 'WO';
+    /**
+     * Optional description; null when absent.
+     */
+    description: string | null;
+    /**
+     * True when only callers with job financial access may see the document. PWA documentation is always true.
+     */
+    admin_only: boolean;
+    /**
+     * External link when the document is a URL rather than an uploaded file; null when a file is attached.
+     */
+    url: string | null;
+    /**
+     * The attached file's filename, content type, size, and URL; null when the document is a URL.
+     */
+    file: {
+        /**
+         * Stored name of the uploaded file.
+         */
+        filename: string;
+        /**
+         * MIME type of the file; null when not recorded.
+         */
+        content_type: string | null;
+        /**
+         * Size of the file in bytes.
+         */
+        byte_size: number;
+        /**
+         * A URL to download the file.
+         */
+        url: string;
+    } | null;
+    /**
+     * When the document was created.
+     */
+    created_at: string;
+    /**
+     * When the document was last updated.
+     */
+    updated_at: string;
+};
+/**
+ * A page of a job's documents, with pagination metadata and navigation links.
+ */
+export type JobDocumentsResponseObject = {
+    meta: Meta;
+    links: Links;
+    /**
+     * The page of job documents.
+     */
+    data: Array<JobDocumentResponseObject>;
+};
+/**
+ * Request body for creating a job document. The job is taken from the path and is not part of the body. Supply exactly one of `url` or `file`.
+ */
+export type JobDocumentParameters = {
+    /**
+     * Document type code from the DocumentType catalog. Omission or a blank value answers 422. `PWA_DOCUMENTATION` is persisted as admin-only.
+     */
+    type?: string;
+    /**
+     * Human-readable document name. Omission or a blank value answers 422.
+     */
+    name?: string;
+    /**
+     * Optional description. Null clears it on create to absent.
+     */
+    description?: string | null;
+    /**
+     * A signed_id from POST /api/v1/direct_uploads identifying the uploaded blob to attach. Register the upload naming `jobs.documents` — a signed_id issued for any other resource will not resolve here. Omit when supplying `url`. Null and a blank string answer 422.
+     */
+    file?: string;
+    /**
+     * When true, only callers with job financial access may see the document. Forced true when `type` is `PWA_DOCUMENTATION`.
+     */
+    admin_only?: boolean;
+    /**
+     * External https URL. Omit when supplying `file`. Sending both `url` and `file`, or neither, answers 422.
+     */
+    url?: string | null;
+};
+/**
+ * Request body for updating a job document. Every field is optional; omit a field to preserve its current value. The resulting document must still be exactly one of `url` or `file`.
+ */
+export type JobDocumentUpdateParameters = {
+    /**
+     * Replacement document type code from the DocumentType catalog. `PWA_DOCUMENTATION` is persisted as admin-only.
+     */
+    type?: string;
+    /**
+     * Replacement human-readable document name. A blank value answers 422.
+     */
+    name?: string;
+    /**
+     * Replacement description. Null clears it.
+     */
+    description?: string | null;
+    /**
+     * A signed_id from POST /api/v1/direct_uploads identifying a replacement blob. Register the upload naming `jobs.documents` — a signed_id issued for any other resource will not resolve here. Null removes the attachment; the document must then have a `url`.
+     */
+    file?: string | null;
+    /**
+     * When true, only callers with job financial access may see the document. Forced true when `type` is `PWA_DOCUMENTATION`.
+     */
+    admin_only?: boolean;
+    /**
+     * Replacement external https URL. Null clears it; the document must then have a file.
+     */
+    url?: string | null;
+};
 /**
  * A good-faith-effort exception on a job — a record that the employer requested apprentices from a registered program and did not receive the full request, or that no qualifying program existed. Read-only. Does not include supporting document slots.
  */
@@ -9818,7 +10311,7 @@ export type SiteFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -9873,7 +10366,7 @@ export type SiteFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -9990,7 +10483,7 @@ export type FeatureFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10045,7 +10538,7 @@ export type FeatureFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10104,7 +10597,7 @@ export type JobFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10159,7 +10652,7 @@ export type JobFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -10347,65 +10840,65 @@ export type PositionsResponseObject = {
     data: Array<PositionResponseObject>;
 };
 /**
- * Request body for creating or updating a position on a job. The job is taken from the URL path.
+ * Request body for creating or updating a position on a job. The job is taken from the URL path. Send only the fields to set; omitted fields keep their stored values. An undeclared key answers 400; a wrong type, null where it is not accepted, or a blank ID answers 422 at the field's pointer.
  */
 export type PositionParameters = {
     /**
-     * ID of the worker to assign; cannot be changed once the position has tracked time.
+     * ID of the worker to assign, or null to leave the position unfilled; cannot be changed once the position has tracked time.
      */
     fulfilled_by_user_id?: string | null;
     /**
-     * The position's first day, as a calendar date (`YYYY-MM-DD`) in the job's tz_name. Required when the job has a schedule, and must fall within it. A time is refused with `422`. On update, null leaves the stored date unchanged.
+     * The position's first day, as a calendar date (`YYYY-MM-DD`) in the job's tz_name. Required when the job has a schedule, and must fall within it. Omit both dates on create to leave the position unscheduled, and on update to keep the stored days; null, a blank, or a time answers 422.
      */
-    start_time?: string | null;
+    start_time?: string;
     /**
-     * The position's last day, as a calendar date (`YYYY-MM-DD`) in the job's tz_name. Required when the job has a schedule, and must be on or after start_time and within it. A time is refused with `422`. On update, null leaves the stored date unchanged.
+     * The position's last day, as a calendar date (`YYYY-MM-DD`) in the job's tz_name. Required when the job has a schedule, and must be on or after start_time and within it. Omit both dates on create to leave the position unscheduled, and on update to keep the stored days; null, a blank, or a time answers 422.
      */
-    end_time?: string | null;
+    end_time?: string;
     /**
      * ID of the position function (role) to assign; null for none. Must be a global function or one of the job's company.
      */
     position_function_id?: string | null;
     /**
-     * ID of the per diem to apply; its rate and currency are copied onto the position. Must belong to the job's company.
+     * ID of the per diem to apply, or null for none; the position takes its rate and currency on every save. Must belong to the job's company.
      */
     per_diem_id?: string | null;
     /**
-     * Per-diem amount in cents; the effective rate is derived from the chosen per diem.
+     * ID of a selectable pay-rate rule package scoped to this job, or null to clear it. Omit on create to leave the assignment unset — the job's default is not copied. A package the key cannot see, scoped to another job, or not selectable answers 404. A package with cash-fringe rules on a non-PWA position answers 422.
      */
-    per_diem_rate_cents?: number | null;
+    pay_rates_rule_package_id?: string | null;
     /**
      * Whether the position tracks PWA compliance; must be true to attach wage determinations or set the PWA rate fields.
      */
     pwa?: boolean;
     /**
-     * Desired hourly cash-fringe rate in cents. Admin only on user-scoped keys.
+     * Desired hourly cash-fringe rate in cents, as a decimal string like the response's. Admin only on user-scoped keys; another user's key sending it answers 403.
      */
-    cash_fringe_rate_cents?: number | null;
+    cash_fringe_rate_cents?: string | null;
     /**
-     * Desired base hourly rate in cents. Admin only on user-scoped keys.
+     * Desired base hourly rate in cents, as a decimal string like the response's. Admin only on user-scoped keys; another user's key sending it answers 403.
      */
-    hourly_rate_cents?: number | null;
+    hourly_rate_cents?: string | null;
     /**
-     * Desired PWA wage-pay rate in cents (PWA positions only). Admin only on user-scoped keys.
+     * Desired PWA wage-pay rate in cents, as a decimal string like the response's (PWA positions only). Admin only on user-scoped keys; another user's key sending it answers 403.
      */
-    pwa_wage_pay_rate_cents?: number | null;
+    pwa_wage_pay_rate_cents?: string | null;
     /**
-     * Desired hourly wage-adder rate in cents. Admin only on user-scoped keys.
+     * Desired hourly wage-adder rate in cents, as a decimal string like the response's. Admin only on user-scoped keys; another user's key sending it answers 403.
      */
-    wage_adder_rate_cents?: number | null;
+    wage_adder_rate_cents?: string | null;
     /**
      * The complete desired set of unique nonblank job wage determination IDs. On PATCH, this replaces the current set; omit the field to leave assignments unchanged. Required federal and regional assignments cannot be removed from a PWA position. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before any changes are written.
      */
     job_wage_determination_ids?: Array<string>;
     /**
-     * PWA classification detail to set; skill_level sets the apprenticeship or skill classification.
+     * The position's PWA classification detail. Sending it replaces the stored detail with one carrying skill_level; omit it to keep the stored detail.
      */
     pwa_details_attributes?: {
         /**
-         * The apprenticeship or skill classification to set.
+         * The Illinois skill classification, `journeyman` or `foreman`; null records none. Required whenever pwa_details_attributes is sent.
          */
-        skill_level?: string | null;
+        skill_level: 'journeyman' | 'foreman' | null;
     };
 };
 /**
@@ -10736,7 +11229,7 @@ export type FormAssignmentTaskResponseObject = Array<{
     }>;
 }>;
 /**
- * Request body for creating a certification — a named qualification a worker can hold. You can only manage your own company's certifications; global (platform) certifications are read-only.
+ * Request body for creating a certification — a named qualification a worker can hold. You can only manage your own company's certifications; global (platform) certifications are read-only. Omitting company_id or name answers 400, and a null or blank one, or any wrong-typed value, answers 422.
  */
 export type CertificationParameters = {
     /**
@@ -10761,7 +11254,7 @@ export type CertificationParameters = {
     duration?: string | null;
 };
 /**
- * Request body for updating a certification — a named qualification a worker can hold. Include only the fields to change. You can only manage your own company's certifications; global (platform) certifications are read-only. The certification's company is fixed at creation.
+ * Request body for updating a certification — a named qualification a worker can hold. Include only the fields to change. You can only manage your own company's certifications; global (platform) certifications are read-only. The certification's company is fixed at creation. A null or blank name, or any wrong-typed value, answers 422.
  */
 export type CertificationUpdateParameters = {
     /**
@@ -10925,7 +11418,7 @@ export type UserCertificationParameters = {
      */
     certification_id: string;
     /**
-     * When the worker earned the certification (ISO 8601). Required.
+     * When the worker earned the certification, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`). Required.
      */
     received_at: string;
     /**
@@ -10967,7 +11460,7 @@ export type UserCertificationUpdateParameters = {
      */
     certification_id?: string;
     /**
-     * When the worker earned the certification (ISO 8601). Omit to preserve the current receipt date.
+     * When the worker earned the certification, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`). Omit to preserve the current receipt date.
      */
     received_at?: string;
     /**
@@ -10997,11 +11490,11 @@ export type UserCertificationUpdateParameters = {
     archived_at?: string | null;
 };
 /**
- * Request body for approving a certification held by a worker. A user key approves in its own user's name and sends no body.
+ * Request body for approving a certification held by a worker. A user key approves in its own user's name and must omit approved_by_user_id. A company key must name the approver.
  */
 export type UserCertificationApprovalParameters = {
     /**
-     * Company keys only: a visible admin, manager, or safety manager at the key's company to record as approver. Required with a company key.
+     * Id of a visible admin, manager, or safety manager at the key's company to record as approver. Required for a company key. A user key that sends it is refused.
      */
     approved_by_user_id?: string;
 };
@@ -11786,62 +12279,6 @@ export type RegionalJobWageDeterminationHistoryCorrectionObject = {
     created_at: string;
     updated_at: string;
 };
-/**
- * State-specific rate fields for a Regional determination, as decimal-string money in cents
- * (e.g. "538.0"). These nine properties are the whole write vocabulary, but which of them a
- * request may send is set by the job's region, not the request — sending a key the job's
- * region does not allow returns a 422:
- *
- * - Categorized-fringe regions (currently IL) accept `combined_health_fringe_rate_cents`,
- * `combined_savings_fringe_rate_cents`, `combined_holiday_pto_fringe_rate_cents`,
- * `training_fringe_rate_cents`, and `other_fringe_rate_cents`.
- * - Overtime-adder regions (currently IL and NY) accept `one_five_x_adder_rate_cents`,
- * `two_x_adder_rate_cents`, `one_five_x_fringe_adder_rate_cents`, and
- * `two_x_fringe_adder_rate_cents`.
- *
- * In a categorized-fringe region the five fringe keys are required, not merely accepted —
- * omitting any of them returns a 422. Categorized-fringe values are non-null when present;
- * overtime-adder values may be null.
- *
- */
-export type RegionalWageDeterminationFields = {
-    /**
-     * Combined health fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_health_fringe_rate_cents?: string;
-    /**
-     * Combined savings fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_savings_fringe_rate_cents?: string;
-    /**
-     * Combined holiday/PTO fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    combined_holiday_pto_fringe_rate_cents?: string;
-    /**
-     * Training fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    training_fringe_rate_cents?: string;
-    /**
-     * Other (uncategorized) fringe rate, in cents as a decimal string. Categorized-fringe regions only; non-null when present.
-     */
-    other_fringe_rate_cents?: string;
-    /**
-     * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    one_five_x_adder_rate_cents?: string | null;
-    /**
-     * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    two_x_adder_rate_cents?: string | null;
-    /**
-     * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    one_five_x_fringe_adder_rate_cents?: string | null;
-    /**
-     * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
-     */
-    two_x_fringe_adder_rate_cents?: string | null;
-};
 /**
  * State-specific rate fields recorded on a Regional determination, as decimal-string money in
  * cents (e.g. "538.0"). Which keys appear is set by the job's region, so this object is always
@@ -11870,7 +12307,7 @@ export type JobWageDeterminationParameters = ({
     type: 'Pwa::JobWageDeterminations::Regional';
 } & RegionalJobWageDeterminationParameters);
 /**
- * Parameters for creating a Federal (Davis-Bacon) wage determination on a job.
+ * Parameters for creating a Federal (Davis-Bacon) wage determination on a job. A Federal determination holds no regional rates, so a body sending `regional_fields` returns a 422.
  */
 export type FederalJobWageDeterminationParameters = {
     /**
@@ -11905,6 +12342,10 @@ export type FederalJobWageDeterminationParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     */
+    overtime_package_id?: string | null;
 };
 /**
  * Parameters for creating a Regional (state prevailing-wage) wage determination on a job.
@@ -11927,18 +12368,66 @@ export type RegionalJobWageDeterminationParameters = {
      */
     hourly_rate_cents: string;
     /**
-     * Hourly fringe rate, in cents as a decimal string (e.g. "1200.0" is $12.00).
+     * The hourly fringe rate, in cents as a decimal string. Required except in a categorized-fringe region (currently IL), which sums it from the five categorized fringe rates.
      */
     fringe_rate_cents?: string;
+    /**
+     * Not recorded on a Regional determination; a value sent here is dropped.
+     */
+    class_code?: string | null;
+    /**
+     * Not recorded on a Regional determination; a listed value sent here is dropped.
+     */
+    construction_category?: 'building' | 'heavy' | 'highway' | 'residential' | null;
     /**
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
     /**
-     * Overtime package whose rules govern overtime on work under this determination. This is not a versioned attribute: setting it points every version at that package, not only the one this request writes, and `effective_from` does not date it. Send null to detach, leaving the determination with no overtime package of its own. Omit the key to leave the current attachment alone. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     * State-specific rates, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
      */
     overtime_package_id?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
 };
 /**
  * Parameters for editing a job wage determination from a point in valid time forward. The type is fixed by the determination the id names and is not sent.
@@ -11980,7 +12469,47 @@ export type JobWageDeterminationUpdateParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for an effective-dated change to a job wage determination, applying from a calendar date forward. The type is fixed by the determination the id names and is not sent.
@@ -12014,7 +12543,47 @@ export type JobWageDeterminationScheduledChangeParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for moving where a job wage determination's timeline begins.
@@ -12278,7 +12847,7 @@ export type ProjectWageDeterminationParameters = ({
     type: 'Pwa::ProjectWageDeterminations::Regional';
 } & RegionalProjectWageDeterminationParameters);
 /**
- * Parameters for creating a Federal (Davis-Bacon) wage determination on a project.
+ * Parameters for creating a Federal (Davis-Bacon) wage determination on a project. A Federal determination holds no regional rates, so a body sending `regional_fields` returns a 422.
  */
 export type FederalProjectWageDeterminationParameters = {
     /**
@@ -12313,6 +12882,10 @@ export type FederalProjectWageDeterminationParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     */
+    overtime_package_id?: string | null;
 };
 /**
  * Parameters for creating a Regional (state prevailing-wage) wage determination on a project.
@@ -12335,18 +12908,66 @@ export type RegionalProjectWageDeterminationParameters = {
      */
     hourly_rate_cents: string;
     /**
-     * Hourly fringe rate, in cents as a decimal string (e.g. "1200.0" is $12.00).
+     * The hourly fringe rate, in cents as a decimal string. Required except in a categorized-fringe region (currently IL), which sums it from the five categorized fringe rates.
      */
     fringe_rate_cents?: string;
+    /**
+     * Not recorded on a Regional determination; a value sent here is dropped.
+     */
+    class_code?: string | null;
+    /**
+     * Not recorded on a Regional determination; a listed value sent here is dropped.
+     */
+    construction_category?: 'building' | 'heavy' | 'highway' | 'residential' | null;
     /**
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
     /**
-     * Overtime package whose rules govern overtime on work under this determination. This is not a versioned attribute: setting it points every version at that package, not only the one this request writes, and `effective_from` does not date it. Send null to detach, leaving the determination with no overtime package of its own. Omit the key to leave the current attachment alone. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
+     * State-specific rates, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
+    /**
+     * Overtime package whose rules govern overtime on work under this determination. It attaches to every version of the new determination. Null, or an omitted key, attaches none. A package belonging to another company is refused, and a Federal determination refuses one outright — only a Regional determination carries overtime rules.
      */
     overtime_package_id?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
 };
 /**
  * Parameters for editing a project wage determination from a point in valid time forward. The type is fixed by the determination the id names and is not sent.
@@ -12388,7 +13009,47 @@ export type ProjectWageDeterminationUpdateParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for an effective-dated change to a project wage determination, applying from a calendar date forward. The type is fixed by the determination the id names and is not sent.
@@ -12422,7 +13083,47 @@ export type ProjectWageDeterminationScheduledChangeParameters = {
      * The DOL general wage determination the rates are drawn from — the general decision number plus its revision (e.g. "CA20230001/5"); null when not recorded.
      */
     general_wage_determination?: string | null;
-    regional_fields?: RegionalWageDeterminationFields;
+    /**
+     * State-specific rates for a Regional determination, as decimal-string money in cents (e.g. "538.0"). The determination's region decides which rates it holds: categorized-fringe regions (currently IL) require the five fringe rates, and overtime-adder regions (currently IL and NY) accept the four adder rates. A value for a rate the region does not hold returns a 422; send null to clear one. An omitted rate keeps its current value.
+     */
+    regional_fields?: {
+        /**
+         * Combined health fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_health_fringe_rate_cents?: string | null;
+        /**
+         * Combined savings fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_savings_fringe_rate_cents?: string | null;
+        /**
+         * Combined holiday/PTO fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        combined_holiday_pto_fringe_rate_cents?: string | null;
+        /**
+         * Training fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        training_fringe_rate_cents?: string | null;
+        /**
+         * Other (uncategorized) fringe rate, in cents as a decimal string. Required in categorized-fringe regions, which refuse null; null elsewhere.
+         */
+        other_fringe_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly wage adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 1.5x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        one_five_x_fringe_adder_rate_cents?: string | null;
+        /**
+         * Hourly fringe adder added to 2x overtime, in cents as a decimal string. Overtime-adder regions only; may be null.
+         */
+        two_x_fringe_adder_rate_cents?: string | null;
+    };
 };
 /**
  * Parameters for moving where a project wage determination's timeline begins.
@@ -13126,11 +13827,11 @@ export type AssetsItemResponseObject = {
      */
     status: 'available' | 'assigned' | null;
     /**
-     * When the item was purchased (ISO 8601).
+     * When the item was purchased, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`).
      */
     purchase_date: string | null;
     /**
-     * Purchase price in cents, in the item's currency.
+     * Purchase price in cents as a decimal string (e.g. "12345.0" is $123.45), in the item's currency.
      */
     purchase_price_cents: string | null;
     /**
@@ -13218,13 +13919,13 @@ export type AssetsItemParameters = {
      */
     status?: 'available' | 'assigned';
     /**
-     * When the item was purchased (ISO 8601).
+     * When the item was purchased, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`).
      */
     purchase_date?: string | null;
     /**
-     * Purchase price in cents, in the item's currency.
+     * Purchase price in cents as a decimal string (e.g. "12345.0" is $123.45), in the item's currency.
      */
-    purchase_price_cents?: number | null;
+    purchase_price_cents?: string | null;
     /**
      * Identifier for this item in an external system.
      */
@@ -13313,13 +14014,13 @@ export type AssetsItemUpdateParameters = {
      */
     status?: 'available' | 'assigned';
     /**
-     * When the item was purchased (ISO 8601).
+     * When the item was purchased, as a calendar date (`YYYY-MM-DD`) stored as midnight UTC. A time sent with it is kept, not dropped, and is read as UTC unless it carries an offset (`Z` or `-05:00`).
      */
     purchase_date?: string | null;
     /**
-     * Purchase price in cents, in the item's currency.
+     * Purchase price in cents as a decimal string (e.g. "12345.0" is $123.45), in the item's currency.
      */
-    purchase_price_cents?: number | null;
+    purchase_price_cents?: string | null;
     /**
      * Identifier for this item in an external system.
      */
@@ -13934,7 +14635,7 @@ export type AssetsItemFormAssignmentParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -13989,7 +14690,7 @@ export type AssetsItemFormAssignmentUpdateParameters = {
          */
         recurrence_end_time?: string | null;
         /**
-         * IDs of the users this form task is assigned to.
+         * Unique nonblank IDs of the users this form task is assigned to; the list replaces the assignees. Omit it to keep them (none on create), or send an empty array to clear them. Null, null members, wrong types, blank IDs, and duplicate IDs answer 422 before anything is written.
          */
         task_assignee_user_ids?: Array<string>;
         /**
@@ -14734,55 +15435,55 @@ export type AssetsTransferResponseObject = {
     updated_at: string;
 };
 /**
- * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). With a single open end it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. Moves are applied immediately, so the source must hold enough of each item.
+ * Move item stock. Each endpoint is a site, a user, or a container — give at most one per side; more than one on a side, or no endpoint at all, answers 422. With both a source and a destination this is a two-sided transfer (returns the created transfer, 201). With a single open end it is a one-sided move — placing an unplaced item (destination only) or removing it from its holder (source only) — which records transactions but no transfer and returns 204. Moves are applied immediately, so the source must hold enough of each item.
  */
 export type AssetsTransferParameters = {
     /**
-     * ID of the source site. At most one source endpoint (site, user, or container).
+     * ID of the source site. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a site outside the company that owns the API key answers 404.
      */
     from_assets_site_id?: string;
     /**
-     * ID of the source user. At most one source endpoint (site, user, or container).
+     * ID of the source user. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a user holding none of the line items answers 404.
      */
     from_user_id?: string;
     /**
-     * ID of the source container item. At most one source endpoint (site, user, or container).
+     * ID of the source container item. At most one source endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and an item outside the company that owns the API key answers 404.
      */
     from_container_item_id?: string;
     /**
-     * ID of the destination site. At most one destination endpoint (site, user, or container).
+     * Optional. The storage location within the source site or container the stock draws from. Omit or send null for the source's unbinned stock. A blank ID or a wrong type answers 422, a storage location outside the company that owns the API key answers 404, and one named without a source site or container, or not belonging to it, answers 422.
+     */
+    from_assets_sub_location_id?: string | null;
+    /**
+     * ID of the destination site. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a site outside the company that owns the API key answers 404.
      */
     to_assets_site_id?: string;
     /**
-     * ID of the destination user. At most one destination endpoint (site, user, or container).
+     * ID of the destination user. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and a user neither currently employed by nor holding a role in the company that owns the API key answers 404.
      */
     to_user_id?: string;
     /**
-     * ID of the destination container item. At most one destination endpoint (site, user, or container).
+     * ID of the destination container item. At most one destination endpoint (site, user, or container); omit the others. Null, a blank ID, or a wrong type answers 422, and an item outside the company that owns the API key answers 404.
      */
     to_container_item_id?: string;
     /**
-     * Optional. The storage location within the source site or container the stock draws from; must belong to that endpoint. Omit for the source's unbinned stock.
+     * Optional. The storage location within the destination site or container the stock lands in. Omit or send null for an unbinned destination. A blank ID or a wrong type answers 422, a storage location outside the company that owns the API key answers 404, and one named without a destination site or container, or not belonging to it, answers 422.
      */
-    from_assets_sub_location_id?: string;
-    /**
-     * Optional. The storage location within the destination site or container the stock lands in; must belong to that endpoint. Omit for an unbinned destination.
-     */
-    to_assets_sub_location_id?: string;
+    to_assets_sub_location_id?: string | null;
     /**
      * ID of the user this move is performed on behalf of, recorded as its initiator. Omission answers 400; supplied null, a blank ID, or a wrong type answers 422. A user outside the company that owns the API key answers 422.
      */
     performed_by_user_id: string;
     /**
-     * The items and quantities to move; at least one is required.
+     * The items and quantities to move, as a list of row objects; at least one is required. Omission answers 400, and null, an empty list, or a value that is not a list answers 422. A row missing a field answers 400 naming it, and an unknown or wrongly typed row field answers 422 at that row.
      */
     line_items: Array<{
         /**
-         * ID of the asset item to move.
+         * ID of the asset item to move. A blank ID or a wrong type answers 422 at its row, and an item outside the company that owns the API key answers 404.
          */
         assets_item_id: string;
         /**
-         * Number of units of the item to move; greater than 0.
+         * Number of units of the item to move, as an integer of 1 or more. Any other value, a fraction or a numeric string included, answers 422 at its row.
          */
         quantity: number;
     }>;
@@ -15832,6 +16533,10 @@ export type CreatePeriodErrors = {
      * Forbidden
      */
     403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
     /**
      * Unprocessable Content
      */
@@ -16103,6 +16808,10 @@ export type UpdateWageScheduleErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
 };
 export type UpdateWageScheduleError = UpdateWageScheduleErrors[keyof UpdateWageScheduleErrors];
 export type UpdateWageScheduleResponses = {
@@ -17669,9 +18378,9 @@ export type DeleteDocumentErrors = {
 export type DeleteDocumentError = DeleteDocumentErrors[keyof DeleteDocumentErrors];
 export type DeleteDocumentResponses = {
     /**
-     * Success
+     * No Content
      */
-    200: AssetsDocumentResponseObject;
+    204: void;
 };
 export type DeleteDocumentResponse = DeleteDocumentResponses[keyof DeleteDocumentResponses];
 export type GetDocumentData = {
@@ -20041,7 +20750,7 @@ export type GetAssessmentResponses = {
     200: CompetencyAssessmentResponseObject;
 };
 export type GetAssessmentResponse = GetAssessmentResponses[keyof GetAssessmentResponses];
-export type ListAssessmentKeyActivitiesData = {
+export type ListAssessmentCriteriaData = {
     body?: never;
     path: {
         assessment_id: string;
@@ -20050,9 +20759,9 @@ export type ListAssessmentKeyActivitiesData = {
         filter?: string;
         'filter[unexpected]'?: string;
     };
-    url: '/api/v1/competencies/assessments/{assessment_id}/key_activities';
+    url: '/api/v1/competencies/assessments/{assessment_id}/criteria';
 };
-export type ListAssessmentKeyActivitiesErrors = {
+export type ListAssessmentCriteriaErrors = {
     /**
      * Bad Request
      */
@@ -20062,46 +20771,46 @@ export type ListAssessmentKeyActivitiesErrors = {
      */
     403: Problem;
 };
-export type ListAssessmentKeyActivitiesError = ListAssessmentKeyActivitiesErrors[keyof ListAssessmentKeyActivitiesErrors];
-export type ListAssessmentKeyActivitiesResponses = {
+export type ListAssessmentCriteriaError = ListAssessmentCriteriaErrors[keyof ListAssessmentCriteriaErrors];
+export type ListAssessmentCriteriaResponses = {
     /**
      * Candidate sees a decided review
      */
     200: {
         meta: Meta;
         links: Links;
-        data: Array<CompetencyAssessmentKeyActivityResponseObject>;
+        data: Array<CompetencyAssessmentCriterionResponseObject>;
     };
 };
-export type ListAssessmentKeyActivitiesResponse = ListAssessmentKeyActivitiesResponses[keyof ListAssessmentKeyActivitiesResponses];
-export type GetAssessmentKeyActivityData = {
+export type ListAssessmentCriteriaResponse = ListAssessmentCriteriaResponses[keyof ListAssessmentCriteriaResponses];
+export type GetAssessmentCriterionData = {
     body?: never;
     path: {
         assessment_id: string;
         id: string;
     };
     query?: never;
-    url: '/api/v1/competencies/assessments/{assessment_id}/key_activities/{id}';
+    url: '/api/v1/competencies/assessments/{assessment_id}/criteria/{id}';
 };
-export type GetAssessmentKeyActivityErrors = {
+export type GetAssessmentCriterionErrors = {
     /**
      * Forbidden
      */
     403: Problem;
 };
-export type GetAssessmentKeyActivityError = GetAssessmentKeyActivityErrors[keyof GetAssessmentKeyActivityErrors];
-export type GetAssessmentKeyActivityResponses = {
+export type GetAssessmentCriterionError = GetAssessmentCriterionErrors[keyof GetAssessmentCriterionErrors];
+export type GetAssessmentCriterionResponses = {
     /**
      * Candidate sees a decided review
      */
-    200: CompetencyAssessmentKeyActivityResponseObject;
+    200: CompetencyAssessmentCriterionResponseObject;
 };
-export type GetAssessmentKeyActivityResponse = GetAssessmentKeyActivityResponses[keyof GetAssessmentKeyActivityResponses];
+export type GetAssessmentCriterionResponse = GetAssessmentCriterionResponses[keyof GetAssessmentCriterionResponses];
 export type ListEvidenceItemsData = {
     body?: never;
     path: {
         assessment_id: string;
-        key_activity_id: string;
+        criterion_id: string;
     };
     query?: {
         /**
@@ -20111,7 +20820,7 @@ export type ListEvidenceItemsData = {
         filter?: string;
         'filter[unexpected]'?: string;
     };
-    url: '/api/v1/competencies/assessments/{assessment_id}/key_activities/{key_activity_id}/evidence_items';
+    url: '/api/v1/competencies/assessments/{assessment_id}/criteria/{criterion_id}/evidence_items';
 };
 export type ListEvidenceItemsErrors = {
     /**
@@ -20139,11 +20848,11 @@ export type GetEvidenceItemData = {
     body?: never;
     path: {
         assessment_id: string;
-        key_activity_id: string;
+        criterion_id: string;
         id: string;
     };
     query?: never;
-    url: '/api/v1/competencies/assessments/{assessment_id}/key_activities/{key_activity_id}/evidence_items/{id}';
+    url: '/api/v1/competencies/assessments/{assessment_id}/criteria/{criterion_id}/evidence_items/{id}';
 };
 export type GetEvidenceItemErrors = {
     /**
@@ -22142,28 +22851,169 @@ export type DeleteGroupErrors = {
      * Forbidden
      */
     403: Problem;
-    /**
-     * Not Found
-     */
-    404: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type DeleteGroupError = DeleteGroupErrors[keyof DeleteGroupErrors];
+export type DeleteGroupResponses = {
+    /**
+     * Success
+     */
+    200: GroupResponseObject;
+};
+export type DeleteGroupResponse = DeleteGroupResponses[keyof DeleteGroupResponses];
+export type GetGroupData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/groups/{id}';
+};
+export type GetGroupErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type GetGroupError = GetGroupErrors[keyof GetGroupErrors];
+export type GetGroupResponses = {
+    /**
+     * Success
+     */
+    200: GroupResponseObject;
+};
+export type GetGroupResponse = GetGroupResponses[keyof GetGroupResponses];
+export type UpdateGroupData = {
+    body?: GroupUpdateParameters;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/groups/{id}';
+};
+export type UpdateGroupErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type UpdateGroupError = UpdateGroupErrors[keyof UpdateGroupErrors];
+export type UpdateGroupResponses = {
+    /**
+     * Success
+     */
+    200: GroupResponseObject;
+};
+export type UpdateGroupResponse = UpdateGroupResponses[keyof UpdateGroupResponses];
+export type ListJobDocumentsData = {
+    body?: never;
+    path: {
+        job_id: string;
+    };
+    query?: {
+        /**
+         * Returns documents whose type is any of the given DocumentType values. Comma-separate to match multiple (e.g. `PWA_DOCUMENTATION,OTHER`).
+         */
+        'filter[type]'?: Array<'CERTIFICATIONS' | 'CHECKLIST' | 'MAP' | 'MSA' | 'ONSITE_POSTER' | 'OTHER' | 'PARTS_INSTRUCTIONS' | 'PHOTO' | 'PO' | 'PWA_DOCUMENTATION' | 'RESUME' | 'WO'>;
+    };
+    url: '/api/v1/jobs/{job_id}/documents';
+};
+export type ListJobDocumentsErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type ListJobDocumentsError = ListJobDocumentsErrors[keyof ListJobDocumentsErrors];
+export type ListJobDocumentsResponses = {
+    /**
+     * Success
+     */
+    200: JobDocumentsResponseObject;
+};
+export type ListJobDocumentsResponse = ListJobDocumentsResponses[keyof ListJobDocumentsResponses];
+export type CreateJobDocumentData = {
+    body: JobDocumentParameters;
+    path: {
+        job_id: string;
+    };
+    query?: never;
+    url: '/api/v1/jobs/{job_id}/documents';
+};
+export type CreateJobDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type CreateJobDocumentError = CreateJobDocumentErrors[keyof CreateJobDocumentErrors];
+export type CreateJobDocumentResponses = {
+    /**
+     * Created
+     */
+    201: JobDocumentResponseObject;
+};
+export type CreateJobDocumentResponse = CreateJobDocumentResponses[keyof CreateJobDocumentResponses];
+export type DeleteJobDocumentData = {
+    body?: never;
+    path: {
+        job_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/jobs/{job_id}/documents/{id}';
+};
+export type DeleteJobDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
 };
-export type DeleteGroupError = DeleteGroupErrors[keyof DeleteGroupErrors];
-export type DeleteGroupResponses = {
+export type DeleteJobDocumentError = DeleteJobDocumentErrors[keyof DeleteJobDocumentErrors];
+export type DeleteJobDocumentResponses = {
     /**
-     * Success
+     * No Content
      */
-    200: GroupResponseObject;
+    204: void;
 };
-export type DeleteGroupResponse = DeleteGroupResponses[keyof DeleteGroupResponses];
-export type GetGroupData = {
+export type DeleteJobDocumentResponse = DeleteJobDocumentResponses[keyof DeleteJobDocumentResponses];
+export type GetJobDocumentData = {
     body?: never;
     path: {
+        job_id: string;
         id: string;
     };
     query?: never;
-    url: '/api/v1/groups/{id}';
+    url: '/api/v1/jobs/{job_id}/documents/{id}';
 };
-export type GetGroupErrors = {
+export type GetJobDocumentErrors = {
     /**
      * Forbidden
      */
@@ -22173,27 +23023,24 @@ export type GetGroupErrors = {
      */
     404: Problem;
 };
-export type GetGroupError = GetGroupErrors[keyof GetGroupErrors];
-export type GetGroupResponses = {
+export type GetJobDocumentError = GetJobDocumentErrors[keyof GetJobDocumentErrors];
+export type GetJobDocumentResponses = {
     /**
      * Success
      */
-    200: GroupResponseObject;
+    200: JobDocumentResponseObject;
 };
-export type GetGroupResponse = GetGroupResponses[keyof GetGroupResponses];
-export type UpdateGroupData = {
-    body?: GroupUpdateParameters;
+export type GetJobDocumentResponse = GetJobDocumentResponses[keyof GetJobDocumentResponses];
+export type UpdateJobDocumentData = {
+    body: JobDocumentUpdateParameters;
     path: {
+        job_id: string;
         id: string;
     };
     query?: never;
-    url: '/api/v1/groups/{id}';
+    url: '/api/v1/jobs/{job_id}/documents/{id}';
 };
-export type UpdateGroupErrors = {
-    /**
-     * Bad Request
-     */
-    400: Problem;
+export type UpdateJobDocumentErrors = {
     /**
      * Forbidden
      */
@@ -22202,19 +23049,15 @@ export type UpdateGroupErrors = {
      * Not Found
      */
     404: Problem;
-    /**
-     * Unprocessable Content
-     */
-    422: Problem;
 };
-export type UpdateGroupError = UpdateGroupErrors[keyof UpdateGroupErrors];
-export type UpdateGroupResponses = {
+export type UpdateJobDocumentError = UpdateJobDocumentErrors[keyof UpdateJobDocumentErrors];
+export type UpdateJobDocumentResponses = {
     /**
      * Success
      */
-    200: GroupResponseObject;
+    200: JobDocumentResponseObject;
 };
-export type UpdateGroupResponse = UpdateGroupResponses[keyof UpdateGroupResponses];
+export type UpdateJobDocumentResponse = UpdateJobDocumentResponses[keyof UpdateJobDocumentResponses];
 export type ListJobFormAssignmentTasksData = {
     body?: never;
     path: {
@@ -25847,6 +26690,10 @@ export type ListPayPeriodsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * The pay schedule family id, the same value each period returns as timekeeping_pay_period_config_id.
+         */
+        'filter[timekeeping_pay_period_config_id]'?: string;
         'filter[start_time][gte]'?: string;
         'filter[start_time][lte]'?: string;
         filter?: string;
@@ -25886,6 +26733,32 @@ export type ListPayPeriodsResponses = {
     200: PayPeriodsResponseObject;
 };
 export type ListPayPeriodsResponse = ListPayPeriodsResponses[keyof ListPayPeriodsResponses];
+export type GetPayPeriodData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/pay_periods/{id}';
+};
+export type GetPayPeriodErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type GetPayPeriodError = GetPayPeriodErrors[keyof GetPayPeriodErrors];
+export type GetPayPeriodResponses = {
+    /**
+     * Success
+     */
+    200: PayPeriodResponseObject;
+};
+export type GetPayPeriodResponse = GetPayPeriodResponses[keyof GetPayPeriodResponses];
 export type ListCompensationElementsData = {
     body?: never;
     path?: never;
@@ -27536,6 +28409,10 @@ export type ListEmploymentsData = {
          * Return employments for this user ID.
          */
         'filter[user_id]'?: string;
+        /**
+         * Return employments whose version at the lens time (now, or `as_of[valid]`) belongs to this department.
+         */
+        'filter[companies_department_id]'?: string;
         filter?: string;
         'filter[unexpected]'?: string;
         /**
@@ -28287,6 +29164,226 @@ export type UpdateCompletionResponses = {
     200: ProductionCompletionResponseObject;
 };
 export type UpdateCompletionResponse = UpdateCompletionResponses[keyof UpdateCompletionResponses];
+export type ListProjectDocumentVersionsData = {
+    body?: never;
+    path: {
+        project_id: string;
+        document_id: string;
+    };
+    query?: {
+        /**
+         * This pagination cursor corresponds to the cursor value found in the response in
+         * `meta.page.next_cursor`.
+         */
+        'page[cursor]'?: string;
+        /**
+         * Maximum number of records to return per page. Defaults to 20. A value above 100 is capped to 100 rather than rejected; a value that is zero, negative, or not an integer is rejected with a `400`.
+         */
+        'page[limit]'?: number;
+        page?: string;
+    };
+    url: '/api/v1/projects/{project_id}/documents/{document_id}/versions';
+};
+export type ListProjectDocumentVersionsErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type ListProjectDocumentVersionsError = ListProjectDocumentVersionsErrors[keyof ListProjectDocumentVersionsErrors];
+export type ListProjectDocumentVersionsResponses = {
+    /**
+     * Success
+     */
+    200: {
+        meta: Meta;
+        links: Links;
+        data: Array<ProjectDocumentVersionResponseObject>;
+    };
+};
+export type ListProjectDocumentVersionsResponse = ListProjectDocumentVersionsResponses[keyof ListProjectDocumentVersionsResponses];
+export type ListProjectDocumentsData = {
+    body?: never;
+    path: {
+        project_id: string;
+    };
+    query?: {
+        'filter[created_at][gte]'?: string;
+        'filter[created_at][lte]'?: string;
+        'filter[updated_at][gte]'?: string;
+        'filter[updated_at][lte]'?: string;
+        /**
+         * This pagination cursor corresponds to the cursor value found in the response in
+         * `meta.page.next_cursor`.
+         */
+        'page[cursor]'?: string;
+        /**
+         * Maximum number of records to return per page. Defaults to 20. A value above 100 is capped to 100 rather than rejected; a value that is zero, negative, or not an integer is rejected with a `400`.
+         */
+        'page[limit]'?: number;
+        page?: string;
+        filter?: string;
+        'filter[unexpected]'?: string;
+    };
+    url: '/api/v1/projects/{project_id}/documents';
+};
+export type ListProjectDocumentsErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type ListProjectDocumentsError = ListProjectDocumentsErrors[keyof ListProjectDocumentsErrors];
+export type ListProjectDocumentsResponses = {
+    /**
+     * Success
+     */
+    200: {
+        meta: Meta;
+        links: Links;
+        data: Array<ProjectDocumentResponseObject>;
+    };
+};
+export type ListProjectDocumentsResponse = ListProjectDocumentsResponses[keyof ListProjectDocumentsResponses];
+export type CreateProjectDocumentData = {
+    body: ProjectDocumentParameters;
+    path: {
+        project_id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents';
+};
+export type CreateProjectDocumentErrors = {
+    /**
+     * Bad Request (missing performed_by_user_id)
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+    /**
+     * Unprocessable Content
+     */
+    422: Problem;
+};
+export type CreateProjectDocumentError = CreateProjectDocumentErrors[keyof CreateProjectDocumentErrors];
+export type CreateProjectDocumentResponses = {
+    /**
+     * Created
+     */
+    201: ProjectDocumentResponseObject;
+};
+export type CreateProjectDocumentResponse = CreateProjectDocumentResponses[keyof CreateProjectDocumentResponses];
+export type DeleteProjectDocumentData = {
+    body?: never;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type DeleteProjectDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type DeleteProjectDocumentError = DeleteProjectDocumentErrors[keyof DeleteProjectDocumentErrors];
+export type DeleteProjectDocumentResponses = {
+    /**
+     * No Content
+     */
+    204: void;
+};
+export type DeleteProjectDocumentResponse = DeleteProjectDocumentResponses[keyof DeleteProjectDocumentResponses];
+export type GetProjectDocumentData = {
+    body?: never;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type GetProjectDocumentErrors = {
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type GetProjectDocumentError = GetProjectDocumentErrors[keyof GetProjectDocumentErrors];
+export type GetProjectDocumentResponses = {
+    /**
+     * Success
+     */
+    200: ProjectDocumentResponseObject;
+};
+export type GetProjectDocumentResponse = GetProjectDocumentResponses[keyof GetProjectDocumentResponses];
+export type UpdateProjectDocumentData = {
+    body: ProjectDocumentUpdateParameters;
+    path: {
+        project_id: string;
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/projects/{project_id}/documents/{id}';
+};
+export type UpdateProjectDocumentErrors = {
+    /**
+     * Bad Request
+     */
+    400: Problem;
+    /**
+     * Forbidden
+     */
+    403: Problem;
+    /**
+     * Not Found
+     */
+    404: Problem;
+};
+export type UpdateProjectDocumentError = UpdateProjectDocumentErrors[keyof UpdateProjectDocumentErrors];
+export type UpdateProjectDocumentResponses = {
+    /**
+     * Success
+     */
+    200: ProjectDocumentResponseObject;
+};
+export type UpdateProjectDocumentResponse = UpdateProjectDocumentResponses[keyof UpdateProjectDocumentResponses];
 export type CreateProjectTradeData = {
     body: PwaTradeParameters;
     path: {
@@ -32562,12 +33659,18 @@ export type CreateCompanyResponses = {
 export type CreateCompanyResponse = CreateCompanyResponses[keyof CreateCompanyResponses];
 export type RemoveUserFromCompanyData = {
     body?: never;
+    headers: {
+        /**
+         * Version validator for the whole employment family, or `*` to remove its current state.
+         */
+        'If-Match': string;
+    };
     path: {
         user_id: string;
-        company_id: string;
+        id: string;
     };
     query?: never;
-    url: '/api/v1/users/{user_id}/companies/{company_id}';
+    url: '/api/v1/users/{user_id}/companies/{id}';
 };
 export type RemoveUserFromCompanyErrors = {
     /**
@@ -32578,6 +33681,14 @@ export type RemoveUserFromCompanyErrors = {
      * Not Found
      */
     404: Problem;
+    /**
+     * Precondition Failed
+     */
+    412: Problem;
+    /**
+     * Precondition Required
+     */
+    428: Problem;
 };
 export type RemoveUserFromCompanyError = RemoveUserFromCompanyErrors[keyof RemoveUserFromCompanyErrors];
 export type RemoveUserFromCompanyResponses = {
@@ -32594,10 +33705,10 @@ export type UpdateCompanyData = {
     body: UserCompanyParameters;
     path: {
         user_id: string;
-        company_id: string;
+        id: string;
     };
     query?: never;
-    url: '/api/v1/users/{user_id}/companies/{company_id}';
+    url: '/api/v1/users/{user_id}/companies/{id}';
 };
 export type UpdateCompanyErrors = {
     /**