@dsptch-work/api-client 0.40.0 → 0.42.0

package/dist/gen/sdk.gen.js

@@ -1314,6 +1314,29 @@ export class AssetsItems {
             }
         });
     }
+    /**
+     * Delete form assignment
+     *
+     * Ends the open incomplete permanent copy of this nested
+     * form-completion task, the same mutation as the web unassign
+     * control. Recurrence stays on PATCH. A copy that is not an
+     * incomplete permanent copy is refused with
+     * `not_incomplete_permanent_copy`. A missing, misnested, or
+     * out-of-scope id reads as not found. Returns `204`.
+     *
+     *
+     * **Required scope:**
+     *
+     * `assets.items.form_assignment_tasks:delete`
+     *
+     */
+    static deleteFormAssignmentTask(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/assets/items/{item_id}/form_assignment_tasks/{id}',
+            ...options
+        });
+    }
     /**
      * Show form assignment
      *
@@ -2119,6 +2142,11 @@ export class Billing {
     /**
      * List PWA user counts
      *
+     * Lists each month's PWA head count per billable unit: a project, or a
+     * job outside any project. Rows run newest month first, then projects by
+     * name, then jobs outside any project by name.
+     *
+     *
      * **Required scope:**
      *
      * `billing.pwa_user_counts_by_project_by_months:read`
@@ -3669,6 +3697,23 @@ export class Forms {
      * SurveyJS required-answer rules, visibility, defaults, or expressions.
      * Returns the same representation as show.
      *
+     * File and signature answers take signed IDs, never file contents.
+     * Upload each file first: call POST /api/v1/direct_uploads with
+     * resource form_submissions, PUT the bytes to the returned
+     * direct_upload.url with its headers, then send the returned
+     * signed_id here within a week.
+     *
+     * - A file answer is an array holding one signed ID per file. Each
+     * file is attached to the submission, and the response returns a
+     * download URL in its place. An image file may hold at most 10 MiB.
+     * - A signature answer is one signed ID, and its image is stored in
+     * the answer as a data URL. It must be a PNG or JPEG image, declared
+     * as image/png or image/jpeg to match its bytes or as
+     * application/octet-stream, hold at most 256 KiB, and span at most
+     * 2,000 pixels on either side. A submission's signature answers may
+     * hold at most 2 MiB together, and an upload counts once for each
+     * answer naming it.
+     *
      *
      * **Required scope:**
      *
@@ -3686,6 +3731,27 @@ export class Forms {
             }
         });
     }
+    /**
+     * Delete form submission
+     *
+     * Deletes a submission that is not used as competency evidence.
+     * Competency-evidence restriction is refused with `422`
+     * `destroy_restricted`. Form-assignment rows that pointed at the
+     * submission are nullified. Attachments are kept. Returns `204`.
+     *
+     *
+     * **Required scope:**
+     *
+     * `form_submissions:delete`
+     *
+     */
+    static deleteFormSubmission(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/form_submissions/{id}',
+            ...options
+        });
+    }
     /**
      * Show form submission
      *
@@ -3701,6 +3767,31 @@ export class Forms {
             ...options
         });
     }
+    /**
+     * Update form submission
+     *
+     * Updates timezone and json on an existing submission. json is the
+     * stored SurveyJS tree, including file-answer objects; file content
+     * is rewritten through the same writer the web uses. form_definition_id
+     * and user_id cannot change. Returns the same representation as show.
+     *
+     *
+     * **Required scope:**
+     *
+     * `form_submissions:update`
+     *
+     */
+    static updateFormSubmission(options) {
+        return (options.client ?? client).patch({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/form_submissions/{id}',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
 }
 export class Groups {
     /**
@@ -3989,6 +4080,29 @@ export class Jobs {
             }
         });
     }
+    /**
+     * Delete form assignment task on job
+     *
+     * Ends the open incomplete permanent copy of this nested
+     * form-completion task, the same mutation as the web unassign
+     * control. Recurrence stays on PATCH. A copy that is not an
+     * incomplete permanent copy is refused with
+     * `not_incomplete_permanent_copy`. A missing, misnested, or
+     * out-of-scope id reads as not found. Returns `204`.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.form_assignment_tasks:delete`
+     *
+     */
+    static deleteJobFormAssignmentTask(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/form_assignment_tasks/{id}',
+            ...options
+        });
+    }
     /**
      * Show form assignment task on job
      *
@@ -4039,7 +4153,8 @@ export class Jobs {
      * Returns the good-faith-effort exceptions nested on the named job. A missing
      * or out-of-scope job reads as not found. A visible job with no exceptions,
      * including one that does not track apprenticeship, returns an empty list.
-     * Ordered by request_start_date descending then id. Read-only.
+     * Ordered by request_start_date descending then id. Proof document slots are
+     * always present as `null` or a document object.
      *
      *
      * **Required scope:**
@@ -4054,11 +4169,61 @@ export class Jobs {
             ...options
         });
     }
+    /**
+     * Create good-faith effort exception
+     *
+     * Creates a good-faith-effort exception on the named job. `job_id` is the path
+     * only. Scalar fields match GET; send minutes, not the web form's
+     * `hours_per_apprentice`. Proof files attach through
+     * `request_letter_signed_id`, `submission_proof_signed_id`,
+     * `response_letter_signed_id`, and `no_availability_proof_signed_id` minted by
+     * `POST /api/v1/direct_uploads` naming
+     * `jobs.pwa.apprenticeship.good_faith_effort_exceptions`; when any of those
+     * keys is present, `performed_by_user_id` is required. Model validations are
+     * the 422 source. A missing or out-of-scope job reads as not found.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.apprenticeship.good_faith_effort_exceptions:create`
+     *
+     */
+    static createGoodFaithEffortException(options) {
+        return (options.client ?? client).post({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/apprenticeship/good_faith_effort_exceptions',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+    /**
+     * Delete good-faith effort exception
+     *
+     * Removes the good-faith-effort exception nested on the named job. A missing,
+     * misnested, or out-of-scope id reads as not found.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.apprenticeship.good_faith_effort_exceptions:delete`
+     *
+     */
+    static deleteGoodFaithEffortException(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/apprenticeship/good_faith_effort_exceptions/{id}',
+            ...options
+        });
+    }
     /**
      * Get good-faith effort exception
      *
      * Returns one good-faith-effort exception nested on the named job. A missing,
-     * misnested, or out-of-scope id reads as not found. Read-only.
+     * misnested, or out-of-scope id reads as not found. Proof document slots are
+     * always present as `null` or a document object.
      *
      *
      * **Required scope:**
@@ -4073,6 +4238,100 @@ export class Jobs {
             ...options
         });
     }
+    /**
+     * Update good-faith effort exception
+     *
+     * Updates a good-faith-effort exception nested on the named job. Omit a field
+     * to preserve it. Omit a proof signed-id key to keep the stored file; replacing
+     * a populated slot keeps the original creator. A missing, misnested, or
+     * out-of-scope id reads as not found.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.apprenticeship.good_faith_effort_exceptions:update`
+     *
+     */
+    static updateGoodFaithEffortException(options) {
+        return (options.client ?? client).patch({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/apprenticeship/good_faith_effort_exceptions/{id}',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+    /**
+     * List WH-347 exports
+     *
+     * Returns the job-scoped WH-347 certified-payroll exports nested on the named
+     * job. A missing or out-of-scope job reads as not found. A visible job with no
+     * exports returns an empty list. Ordered by created_at descending then id.
+     * Read-only. Poll a member GET for generation status and the file URL.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.certified_payrolls.wh347_exports:read`
+     *
+     */
+    static listWh347Exports(options) {
+        return (options.client ?? client).get({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/certified_payrolls/wh347_exports',
+            ...options
+        });
+    }
+    /**
+     * Create WH-347 export
+     *
+     * Enqueues a job-scoped WH-347 certified-payroll export over `start_date`..
+     * `end_date`. Returns the pending export (201); poll the member GET for
+     * generation status and the file URL. Requires a user-scoped key. A job
+     * that does not offer WH-347 is 422 `certified_payroll_format_unavailable`.
+     * A window with no reportable pay periods is 422 `nothing_exportable`.
+     * Does not start DocuSeal signing.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.certified_payrolls.wh347_exports:create`
+     *
+     */
+    static createWh347Export(options) {
+        return (options.client ?? client).post({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/certified_payrolls/wh347_exports',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+    /**
+     * Get WH-347 export
+     *
+     * Returns one job-scoped WH-347 export nested on the named job. Poll this
+     * document for generation status; `file` may be null until the file is attached,
+     * including when status is `success`.
+     * A missing, misnested, or out-of-scope id reads as not found. Read-only.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.certified_payrolls.wh347_exports:read`
+     *
+     */
+    static getWh347Export(options) {
+        return (options.client ?? client).get({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/certified_payrolls/wh347_exports/{id}',
+            ...options
+        });
+    }
     /**
      * List cure payments
      *
@@ -4080,7 +4339,7 @@ export class Jobs {
      * or out-of-scope job reads as not found. A visible job with no
      * payments, including one that does not track federal PWA, returns
      * an empty list. Ordered by paid_on_date descending, then
-     * created_at descending, then id. Read-only.
+     * created_at descending, then id.
      *
      *
      * **Required scope:**
@@ -4095,11 +4354,58 @@ export class Jobs {
             ...options
         });
     }
+    /**
+     * Create a cure payment
+     *
+     * Creates a PWA cure payment on the named job. `job_id` comes from the
+     * path. `type`, `amount_cents`, the three dates, and `performed_by_user_id`
+     * are required. `type` is the stored STI class name and is create-only.
+     * The attestation file attaches through `attestation_signed_id` minted by
+     * `POST /api/v1/direct_uploads` naming `jobs.pwa.cure_payments`. A missing
+     * or out-of-scope job or filer reads as not found. Model validations
+     * return 422. Undeclared body keys return 400.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.cure_payments:create`
+     *
+     */
+    static createCurePayment(options) {
+        return (options.client ?? client).post({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/cure_payments',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+    /**
+     * Delete a cure payment
+     *
+     * Removes the PWA cure payment nested on the named job. A missing or
+     * misnested id reads as not found.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.cure_payments:delete`
+     *
+     */
+    static deleteCurePayment(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/cure_payments/{id}',
+            ...options
+        });
+    }
     /**
      * Get cure payment
      *
      * Returns one PWA cure payment nested on the named job. A missing,
-     * misnested, or out-of-scope id reads as not found. Read-only.
+     * misnested, or out-of-scope id reads as not found.
      *
      *
      * **Required scope:**
@@ -4114,6 +4420,33 @@ export class Jobs {
             ...options
         });
     }
+    /**
+     * Update a cure payment
+     *
+     * Updates a PWA cure payment nested on the named job. Omit a field to
+     * preserve it. `type` is create-only; sending it returns 400. Omit
+     * `attestation_signed_id` to keep the stored file; send it with
+     * `performed_by_user_id` to create or replace the attestation. Replacing
+     * a populated slot keeps the original document id and creator. A missing
+     * or misnested id reads as not found.
+     *
+     *
+     * **Required scope:**
+     *
+     * `jobs.pwa.cure_payments:update`
+     *
+     */
+    static updateCurePayment(options) {
+        return (options.client ?? client).patch({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/jobs/{job_id}/pwa/cure_payments/{id}',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
     /**
      * List sites for job
      *
@@ -4416,7 +4749,8 @@ export class ProductionJobScopePrices {
      * manager, or field lead of the company that owns the job,
      * receive `unit_price_cents` and `contracted_count`. Other user
      * keys, held by crew on the job, receive the same rows
-     * without those two fields.
+     * without those two fields. A present `unit_price_cents` is an
+     * exact decimal string, or null when the current price is unknown.
      *
      *
      * **Required scope:**
@@ -4436,9 +4770,10 @@ export class ProductionJobScopePrices {
      *
      * Creates a scope price on the URL's job. The body accepts only `scope_kind`,
      * `unit_price_cents`, `contracted_count`, and `unit_of_measure`. Undeclared keys,
-     * including the retired dollar `unit_price`, or a missing `scope_kind` or
-     * `unit_price_cents` return `400`, and a null or wrong-typed value returns `422`,
-     * without creating a price.
+     * including the retired dollar `unit_price`, or a missing `scope_kind` return
+     * `400`. Omit `unit_price_cents` or send null for an unknown price; "0" is a
+     * known zero. Supplied nonnull prices must be nonnegative decimal strings;
+     * blank, numeric, negative, or wrong-typed prices return `422` without a write.
      *
      *
      * **Required scope:**
@@ -4480,7 +4815,8 @@ export class ProductionJobScopePrices {
      * manager, or field lead of the company that owns the job,
      * receive `unit_price_cents` and `contracted_count`. Other user
      * keys, held by crew on the job, receive the price without
-     * those two fields.
+     * those two fields. A present `unit_price_cents` is an exact
+     * decimal string, or null when the current price is unknown.
      *
      *
      * **Required scope:**
@@ -4499,9 +4835,11 @@ export class ProductionJobScopePrices {
      * Update production job scope price
      *
      * Updates only the supplied `scope_kind`, `unit_price_cents`, `contracted_count`,
-     * and `unit_of_measure`; a null `contracted_count` clears it. Undeclared body
-     * keys, including the retired dollar `unit_price`, return `400`, and a null or
-     * wrong-typed value elsewhere returns `422`, without changing the scope price.
+     * and `unit_of_measure`. Omission preserves the stored value; null
+     * `unit_price_cents` clears the price to unknown, and null `contracted_count`
+     * clears the target. Undeclared keys, including the retired dollar `unit_price`,
+     * return `400`. Invalid supplied values return `422` without changing the scope
+     * price. Prices remain nonnegative decimal strings; "0" is a known zero.
      * The job stays on the URL.
      *
      *
@@ -5220,6 +5558,7 @@ export class JobWageDeterminations {
      * at once, so it moves every version rather than applying from
      * `effective_from`. A determination cascaded from a project mirrors that
      * project's determination and cannot be edited here — change it on the project.
+     * Re-pointing a journeyworker-basis determination also moves the apprentice determinations that follow it.
      *
      * Conditional: send the determination's `ETag` as `If-Match`.
      *
@@ -5358,6 +5697,30 @@ export class OversiteFeatureFormAssignmentTasks {
             }
         });
     }
+    /**
+     * Delete form assignment task on feature
+     *
+     * Ends the open incomplete permanent copy of this nested
+     * form-completion task, the same mutation as the web unassign
+     * control. Recurrence stays on PATCH. A copy that is not an
+     * incomplete permanent copy is refused with
+     * `not_incomplete_permanent_copy`. A missing, misnested, or
+     * other-company id on this shared feature reads as not found.
+     * Returns `204`.
+     *
+     *
+     * **Required scope:**
+     *
+     * `oversite.sites.features.form_assignment_tasks:delete`
+     *
+     */
+    static deleteFeatureFormAssignmentTask(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/oversite/sites/{site_id}/features/{feature_id}/form_assignment_tasks/{id}',
+            ...options
+        });
+    }
     /**
      * Show form assignment task on feature
      *
@@ -5453,6 +5816,30 @@ export class OversiteSiteFormAssignmentTasks {
             }
         });
     }
+    /**
+     * Delete form assignment task on site
+     *
+     * Ends the open incomplete permanent copy of this nested
+     * form-completion task, the same mutation as the web unassign
+     * control. Recurrence stays on PATCH. A copy that is not an
+     * incomplete permanent copy is refused with
+     * `not_incomplete_permanent_copy`. A missing, misnested, or
+     * other-company id on this shared site reads as not found.
+     * Returns `204`.
+     *
+     *
+     * **Required scope:**
+     *
+     * `oversite.sites.form_assignment_tasks:delete`
+     *
+     */
+    static deleteSiteFormAssignmentTask(options) {
+        return (options.client ?? client).delete({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/oversite/sites/{site_id}/form_assignment_tasks/{id}',
+            ...options
+        });
+    }
     /**
      * Show form assignment task on site
      *
@@ -7294,8 +7681,10 @@ export class PerDiems {
      * List per diems
      *
      * List the per diems configured for the company — the named daily allowances
-     * (meals, lodging, travel) available to attach to workers' time. Returned newest
-     * first; narrow the results with the `filter[...]` query parameters.
+     * (meals, lodging, travel) available to attach to workers' time. Returned oldest
+     * first; narrow the results with the `filter[...]` query parameters. Company keys
+     * and the user keys of company admins and managers can list the catalog; other
+     * user keys are refused with `403`.
      *
      *
      * **Required scope:**
@@ -7357,7 +7746,9 @@ export class PerDiems {
     /**
      * Show per diem
      *
-     * Fetch a single per diem by id.
+     * Fetch a single per diem by id. Company keys and the user keys of company
+     * admins and managers can read it; other user keys are refused with `403`.
+     *
      *
      * **Required scope:**
      *
@@ -8416,6 +8807,7 @@ export class ProjectWageDeterminations {
      * `pwa_trade_id` is the exception: a trade regroups the whole determination
      * at once, so it moves every version rather than applying from
      * `effective_from`. Changes synchronize to linked job wage determinations.
+     * Re-pointing a journeyworker-basis determination also moves the apprentice determinations that follow it.
      *
      * Conditional: send the determination's `ETag` as `If-Match`.
      *
@@ -8472,14 +8864,17 @@ export class Projects {
      * prevailing-wage lock-in / beginning-of-construction / placed-in-service dates)
      * and `asset_owner` apply only while `federal_pwa_mode` is not `none`, so sending
      * one of them on a project that tracks no federal PWA — even as null — returns
-     * 422. `parent_id` may name a project visible to the API key's policy,
-     * `participating_company_ids` is the complete set of participating companies,
-     * and `manager_user_ids` is the complete set of project managers (each a
-     * manager of the owning company). Remove a participant's jobs before removing
-     * it from this set. Returns 201 with the project; unknown or inaccessible
-     * parent, company, or manager user IDs return 404, and invalid attributes or
-     * relationships return 422. Undeclared body keys return 400 before any project
-     * or relationship is saved.
+     * 422. IRA evidence files attach through `lock_in_date_doc_signed_id`,
+     * `beginning_of_construction_doc_signed_id`, and `placed_in_service_doc_signed_id`
+     * minted by `POST /api/v1/direct_uploads` naming `projects`; when any of those
+     * keys is present, `performed_by_user_id` is required. `parent_id` may name a
+     * project visible to the API key's policy, `participating_company_ids` is the
+     * complete set of participating companies, and `manager_user_ids` is the complete
+     * set of project managers (each a manager of the owning company). Remove a
+     * participant's jobs before removing it from this set. Returns 201 with the
+     * project; unknown or inaccessible parent, company, manager, or filer user IDs
+     * return 404, and invalid attributes or relationships return 422. Undeclared
+     * body keys return 400 before any project or relationship is saved.
      *
      *
      * **Required scope:**
@@ -8528,7 +8923,12 @@ export class Projects {
      * dates) and `asset_owner` apply only while `federal_pwa_mode` is not `none`:
      * switching it to `none` clears the stored values and forces `asset_owner`
      * false, and sending one of them while federal tracking is off — even as null —
-     * returns 422. `budget_currency` defaults to USD when blank. `parent_id` moves
+     * returns 422. IRA evidence files attach through `lock_in_date_doc_signed_id`,
+     * `beginning_of_construction_doc_signed_id`, and `placed_in_service_doc_signed_id`
+     * minted by `POST /api/v1/direct_uploads` naming `projects`; omit a key to keep
+     * the stored file, and send `performed_by_user_id` when any signed id is present.
+     * Replacing a populated slot keeps the original `created_by_user_id`.
+     * `budget_currency` defaults to USD when blank. `parent_id` moves
      * or detaches the project; a project whose parent no longer lists its owner
      * still accepts updates that keep that parent. `participating_company_ids`
      * replaces the complete set of participating companies. `manager_user_ids`
@@ -8723,10 +9123,16 @@ export class Users {
     /**
      * List scheduled compensation changes for user's employment
      *
+     * Deprecated: use `GET /api/v1/people/employments/{employment_id}/history` instead.
+     * The successor is keyed by the employment's `id` and lists every version, newest first.
+     *
+     *
      * **Required scope:**
      *
      * `users.companies.scheduled_changes:read`
      *
+     *
+     * @deprecated
      */
     static listUserCompanyScheduledChanges(options) {
         return (options.client ?? client).get({
@@ -8738,10 +9144,16 @@ export class Users {
     /**
      * Create scheduled change to user's employment information
      *
+     * Deprecated: use `POST /api/v1/people/employments/{employment_id}/scheduled_changes` instead.
+     * The successor is keyed by the employment's `id` and needs `If-Match`.
+     *
+     *
      * **Required scope:**
      *
      * `users.companies.scheduled_changes:create`
      *
+     *
+     * @deprecated
      */
     static createUserCompanyScheduledChange(options) {
         return (options.client ?? client).post({
@@ -8757,10 +9169,16 @@ export class Users {
     /**
      * Cancel scheduled compensation change (removes the future version from the timeline)
      *
+     * Deprecated: use `DELETE /api/v1/people/employments/{employment_id}/scheduled_changes/{effective_date}` instead.
+     * The successor is keyed by the employment's `id` and the change's effective date, and needs `If-Match`.
+     *
+     *
      * **Required scope:**
      *
      * `users.companies.scheduled_changes:delete`
      *
+     *
+     * @deprecated
      */
     static cancelUserCompanyScheduledChange(options) {
         return (options.client ?? client).delete({
@@ -8772,10 +9190,16 @@ export class Users {
     /**
      * Update scheduled compensation change
      *
+     * Deprecated: use `PATCH /api/v1/people/employments/{employment_id}/scheduled_changes/{effective_date}` instead.
+     * The successor is keyed by the employment's `id` and the change's effective date, and needs `If-Match`.
+     *
+     *
      * **Required scope:**
      *
      * `users.companies.scheduled_changes:update`
      *
+     *
+     * @deprecated
      */
     static updateScheduledChange(options) {
         return (options.client ?? client).patch({
@@ -9502,8 +9926,9 @@ export class TimeEntries {
      * company's default timecodes), state, description, hourly_rate_cents (derived
      * from the position/user default when omitted), and feature_ids. Supplying
      * feature_ids — or setting feature_allocation_acknowledged true — satisfies a
-     * job that requires a feature allocation. hourly_rate_cents is admin only on
-     * user-scoped keys.
+     * job that requires a feature allocation. The optional overtime premium cents inputs
+     * set the complete tier premiums, additional to base hourly pay. Financial
+     * rate inputs are admin only on user-scoped keys.
      *
      *
      * **Required scope:**
@@ -9580,7 +10005,8 @@ export class TimeEntries {
      * 422 unless confirm_allocation_conflict is sent true. The feature-allocation cap is
      * enforced, and because a persisted feature_ids= writes its join rows
      * immediately, a rejected save rolls them back within the enclosing
-     * transaction. hourly_rate_cents is admin only on user-scoped keys.
+     * transaction. Omitted overtime premium cents inputs keep their saved values; null
+     * resets a tier to automatic. Financial rate inputs are admin only on user-scoped keys.
      *
      *
      * **Required scope:**
@@ -10209,6 +10635,32 @@ export class TimeOffRequests {
             ...options
         });
     }
+    /**
+     * Create time off request
+     *
+     * Create a time-off request for a worker. Name the worker and the filer.
+     * When they are the same person the request is born pending; otherwise it
+     * is born approved with the filer stamped as reviewer and an Absence is
+     * built in the background. Instants are the beginning of the first day and
+     * the end of the last day in the pay-schedule timezone.
+     *
+     *
+     * **Required scope:**
+     *
+     * `timekeeping.time_off_requests:create`
+     *
+     */
+    static createTimeOffRequest(options) {
+        return (options.client ?? client).post({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/timekeeping/time_off_requests',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
     /**
      * Show time off request
      *
@@ -10228,6 +10680,30 @@ export class TimeOffRequests {
             ...options
         });
     }
+    /**
+     * Review time off request
+     *
+     * Approve, deny, or cancel a pending time-off request. The named filer is
+     * the reviewer: only the worker may cancel, and nobody may approve or deny
+     * their own row. Approving enqueues the Absence build.
+     *
+     *
+     * **Required scope:**
+     *
+     * `timekeeping.time_off_requests.reviews:create`
+     *
+     */
+    static createReview(options) {
+        return (options.client ?? client).post({
+            security: [{ name: 'X-Api-Key', type: 'apiKey' }],
+            url: '/api/v1/timekeeping/time_off_requests/{time_off_request_id}/reviews',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
 }
 export class TimeSessions {
     /**