@dsptch-work/api-client 0.35.0 → 0.36.0

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

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