@factorialco/api-client 3.0.0-beta.2026100121 → 3.0.0-beta.2026100123

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

@@ -124,7 +124,16 @@ export type ApprovalsMaterializedApprovalsFlow = {
     expires_at: string;
     final_decision_at?: string;
     approval_flow_id: string;
-    approvers: Array<unknown>;
+    approvers: Array<{
+        id: string;
+        access_id?: string;
+        employee_id?: string;
+        materialized_approval_step_id: string;
+        approval_step_approver_id: string;
+        status: 'pending' | 'approved' | 'rejected' | 'requestedinformation' | 'changes_requested' | 'waiting_changes' | 'stopped' | 'ignored';
+        selection_criteria?: string;
+        updated_at: string;
+    }>;
     email_detail_blocks: Array<string>;
     override_approver_id?: string;
     override_approver_employee_id?: string;
@@ -212,7 +221,11 @@ export type AtsApplication = {
      * CV file attachment of the application (includes filename, url, byte_size, content_type, created_at)
      */
     cv?: {
-        [key: string]: unknown;
+        filename: string;
+        url: string;
+        byte_size: number;
+        content_type: string;
+        created_at?: string;
     };
     /**
      * Application conversation id
@@ -398,7 +411,11 @@ export type AtsEvaluationForm = {
     /**
      * List of questions in the evaluation form.
      */
-    questions: Array<unknown>;
+    questions: Array<{
+        id: string;
+        text: string;
+        description?: string;
+    }>;
     /**
      * date and time when the evaluation form was created.
      */
@@ -444,7 +461,11 @@ export type AtsFeedback = {
     /**
      * the answers from the evaluation form, if this feedback is related to an evaluation form.
      */
-    evaluation_form_answers?: Array<unknown>;
+    evaluation_form_answers?: Array<{
+        question_id: string;
+        score: number;
+        note?: string;
+    }>;
 };
 export type AtsHiringStage = {
     /**
@@ -576,7 +597,13 @@ export type AtsMessage = {
     sent_by_id: string;
     sent_by_type: string;
     created_at: string;
-    attachments: Array<unknown>;
+    attachments: Array<{
+        filename: string;
+        url: string;
+        byte_size: number;
+        content_type: string;
+        created_at?: string;
+    }>;
     topic: string;
     delayed_until?: string;
     sent_at?: string;
@@ -624,7 +651,10 @@ export type AtsQuestion = {
     /**
      * options for the question.
      */
-    options?: Array<unknown>;
+    options?: Array<{
+        text: string;
+        disqualifies?: boolean;
+    }>;
 };
 export type AtsRejectionReason = {
     /**
@@ -761,10 +791,27 @@ export type AttendanceEstimatedTime = {
      * Amount of overtime minutes the employee has to work (only available with Shift Management).
      */
     overtime_minutes: number;
-    breaks: Array<unknown>;
+    breaks: Array<{
+        start_at: string;
+        end_at: string;
+        duration: number;
+        break_configuration_id: string;
+        break_configuration_name: string;
+        break_configuration_paid: boolean;
+        shift_id?: string;
+        break_type: 'flexible' | 'fixed' | 'semi_flexible';
+        timezone: string;
+    }>;
     time_unit: 'minute' | 'half_day' | 'none';
     estimated_half_days: number;
-    shifts: Array<unknown>;
+    shifts: Array<{
+        id: string;
+        start_at: string;
+        end_at: string;
+        location_id?: string;
+        timezone?: string;
+        extra_hours?: boolean;
+    }>;
     /**
      * Source of the estimated time. Could be employee's contract, work schedule or shift management.
      */
@@ -1006,7 +1053,23 @@ export type AttendanceWorkedTime = {
     pending_minutes: number;
     minutes: number;
     time_unit: 'minute' | 'half_day' | 'none';
-    worked_time_blocks: Array<unknown>;
+    worked_time_blocks: Array<{
+        minutes: number;
+        time_type: 'regular' | 'overtime' | 'any_time';
+        extra_hour: boolean;
+        complementary_hour: boolean;
+        raw_minutes_in_cents: number;
+        equivalent_minutes_in_cents: number;
+        pool_type: 'balance' | 'timeoff' | 'virtual_timeoff' | 'payroll' | 'virtual_payroll' | 'discarded' | 'buffer' | 'complementary_buffer';
+        date: string;
+        approved: boolean;
+        workable: boolean;
+        in_schedule: boolean;
+        time_range_category_id?: string;
+        employee_id: string;
+        time_settings_break_configuration_id?: string;
+        time_range_category_name?: string;
+    }>;
     day_type: 'saturday' | 'sunday' | 'bank_holiday' | 'workday';
     /**
      * ID to specify the worked time it includes the employee_id and date
@@ -1739,7 +1802,27 @@ export type ContractsContractVersion = {
      * Country-specific contract data (template fragments and fields).
      */
     version_data?: {
-        [key: string]: unknown;
+        country_data?: {
+            /**
+             * Country code (e.g. es, fr, de, pt).
+             */
+            country: string;
+            fields: Array<{
+                name: string;
+                field_name: string;
+                value_label?: string;
+                value_id: string;
+            }>;
+            /**
+             * Identifiers of the materialized_template_fragment records that produced this country data. Compare against the current template's source_fragment_ids to detect when this data originated from a different template (e.g. after a legal entity or country change).
+             *
+             */
+            template_fragments: {
+                company_fragment_id?: string;
+                country_fragment_id?: string;
+                legal_entity_fragment_id?: string;
+            };
+        };
     };
     /**
      * the minimum amount of minutes the employee must rest between working periods.
@@ -2136,7 +2219,29 @@ export type ContractsMaterializedTemplate = {
      * The ordered list of contract fields defined in this template after merging all inheritance levels and removing hidden fields. Each entry is a FragmentField describing a single configurable attribute of a contract (e.g. contract type, job title, salary). The list reflects the final effective set of fields an employee contract under this template will contain.
      *
      */
-    template: Array<unknown>;
+    template: Array<{
+        id: string;
+        field_id: string;
+        label: string;
+        field_type: 'boolean' | 'cents' | 'integer' | 'option' | 'string';
+        edit_mode: 'not_editable' | 'add_only' | 'full_editable';
+        options?: Array<{
+            id: string;
+            option_id: string;
+            fragment_id: string;
+            label: string;
+            raw_label?: string;
+            translation_string?: string;
+            archived_at?: string;
+            default: boolean;
+            integration_source?: string;
+        }>;
+        dependencies: Array<{
+            field: string;
+            type: 'visibility_toggle' | 'dynamic_options';
+            value?: string;
+        }>;
+    }>;
 };
 export type ContractsPortugueseContractType = {
     /**
@@ -3250,7 +3355,10 @@ export type EmployeeUpdatesTermination = {
     /**
      * Remaining holidays
      */
-    remaining_holidays: Array<unknown>;
+    remaining_holidays: Array<{
+        name: string;
+        available_days: string;
+    }>;
     /**
      * Termination reason type
      */
@@ -3411,7 +3519,8 @@ export type ExpensesExpense = {
      * The category of the expense
      */
     category?: {
-        [key: string]: unknown;
+        id: string;
+        name: string;
     };
     /**
      * The subcategory of the expense
@@ -3456,7 +3565,14 @@ export type ExpensesExpense = {
     /**
      * The files of the expense
      */
-    files: Array<unknown>;
+    files: Array<{
+        id: string;
+        filename: string;
+        url?: string;
+        download_url?: string;
+        byte_size: number;
+        content_type?: string;
+    }>;
     /**
      * The id of the external authorization
      */
@@ -3469,7 +3585,8 @@ export type ExpensesExpense = {
      * The card of the expense
      */
     card?: {
-        [key: string]: unknown;
+        last4?: string;
+        card_type: string;
     };
     /**
      * The id of the document
@@ -3479,7 +3596,26 @@ export type ExpensesExpense = {
      * The signed document of the expense
      */
     signed_document?: {
-        [key: string]: unknown;
+        id: string;
+        file?: {
+            id: string;
+            filename: string;
+            url?: string;
+            download_url?: string;
+            byte_size: number;
+            content_type?: string;
+        };
+        original_files: Array<{
+            id: string;
+            filename: string;
+            url?: string;
+            download_url?: string;
+            byte_size: number;
+            content_type?: string;
+        }>;
+        signed_for_organization: string;
+        created_at: string;
+        signing: boolean;
     };
     /**
      * The access token of the expense
@@ -3520,7 +3656,12 @@ export type ExpensesExpense = {
     /**
      * The taxes of the expense
      */
-    taxes: Array<unknown>;
+    taxes: Array<{
+        type: 'vat';
+        amount?: number;
+        percentage?: number;
+        base_amount?: number;
+    }>;
     /**
      * The id of the expense category the expense is classified under (company-configurable catalogue)
      */
@@ -3563,7 +3704,8 @@ export type ExpensesMileage = {
      * The category of the mileage
      */
     category?: {
-        [key: string]: unknown;
+        id: string;
+        name: string;
     };
     /**
      * The subcategory of the mileage
@@ -3632,7 +3774,14 @@ export type ExpensesMileage = {
     /**
      * The files associated with the mileage
      */
-    files: Array<unknown>;
+    files: Array<{
+        id: string;
+        filename: string;
+        url?: string;
+        download_url?: string;
+        byte_size: number;
+        content_type?: string;
+    }>;
     /**
      * The date when the mileage was paid
      */
@@ -3750,7 +3899,14 @@ export type ExpensesPerDiem = {
     /**
      * The files attached to the per diem.
      */
-    files: Array<unknown>;
+    files: Array<{
+        id: string;
+        filename: string;
+        url?: string;
+        download_url?: string;
+        byte_size: number;
+        content_type?: string;
+    }>;
     /**
      * The date the per diem was requested for review.
      */
@@ -3767,7 +3923,8 @@ export type ExpensesPerDiem = {
      * The category of the per diem.
      */
     category?: {
-        [key: string]: unknown;
+        id: string;
+        name: string;
     };
     /**
      * The subcategory of the per diem.
@@ -3792,7 +3949,13 @@ export type ExpensesPerDiem = {
     /**
      * The rates for the per diem.
      */
-    rates: Array<unknown>;
+    rates: Array<{
+        id?: string;
+        expenses_per_diem_id: string;
+        rate_configuration_id: string;
+        total_days?: number;
+        total_amount_cents?: number;
+    }>;
 };
 export type FinanceAccount = {
     /**
@@ -3963,7 +4126,30 @@ export type FinanceContact = {
      * The address object containing street, city, etc.
      */
     address: {
-        [key: string]: unknown;
+        /**
+         * Street address line 1.
+         */
+        line1: string;
+        /**
+         * Street address line 2 or additional info.
+         */
+        line2?: string;
+        /**
+         * City where the Contact is located.
+         */
+        city: string;
+        /**
+         * Postal or ZIP code.
+         */
+        postal_code: string;
+        /**
+         * State or region for the Contact.
+         */
+        state: string;
+        /**
+         * Two-letter ISO country code.
+         */
+        country_code: string;
     };
     /**
      * The external id of the contact.
@@ -4081,7 +4267,12 @@ export type FinanceFinancialDocument = {
      * File attached.
      */
     file?: {
-        [key: string]: unknown;
+        id: string;
+        filename: string;
+        url: string;
+        size: number;
+        content_type: string;
+        created_at: string;
     };
     /**
      * Updation date.
@@ -4090,7 +4281,17 @@ export type FinanceFinancialDocument = {
     /**
      * Taxes.
      */
-    taxes: Array<unknown>;
+    taxes: Array<{
+        amount_cents?: number;
+        percentage?: number;
+        base_amount_cents?: number;
+        type?: 'vat' | 'personal_income';
+        tax_type_id?: string;
+        tax_type_name?: string;
+        tax_rates?: Array<{
+            percentage: number;
+        }>;
+    }>;
     /**
      * Date when was fully reconciled.
      */
@@ -4409,7 +4610,8 @@ export type IntegrationsSyncRun = {
      * Scope of this sync run. Holds `from` and `to`, the inclusive ISO-8601 dates of the period it covers; either key is absent when unknown, and the object is empty when the run is not date-scoped.
      */
     context: {
-        [key: string]: unknown;
+        from?: string;
+        to?: string;
     };
     /**
      * Identifier of the company
@@ -4447,7 +4649,40 @@ export type IntegrationsSyncableItem = {
      * data of the item to be synced
      */
     sync_payload: {
-        [key: string]: unknown;
+        id?: string;
+        employee_id?: string;
+        payroll_concept_id?: string;
+        legal_entity_id?: string;
+        company_id?: string;
+        category_id?: string;
+        subcategory_id?: string;
+        ledger_account_id?: string;
+        leave_type_id?: string;
+        leave_type_name?: string;
+        translated_leave_type_name?: string;
+        employee_full_name?: string;
+        legal_entity_name?: string;
+        start_time?: string;
+        days_taken?: number;
+        created_at?: string;
+        contract_working_hours?: number;
+        contract_working_hours_frequency?: string;
+        contract_working_week_days?: string;
+        contract_fr_forfait_jours?: boolean;
+        project_id?: string;
+        subproject_ids?: Array<string>;
+        cost_center_ids?: Array<{
+            id?: string;
+        }>;
+        files?: Array<{
+            id?: string;
+        }>;
+        taxes?: Array<{
+            type?: string;
+            amount?: number;
+            base_amount?: number;
+            percentage?: number;
+        }>;
     };
     /**
      * Type of the syncable item
@@ -4478,7 +4713,10 @@ export type IntegrationsSyncableState = {
     /**
      * Error or validation messages of the syncable state
      */
-    error_messages: Array<unknown>;
+    error_messages: Array<{
+        key: string;
+        value: string;
+    }>;
     /**
      * Timestamp of the last status change
      */
@@ -4504,11 +4742,18 @@ export type IntegrationsSyncableSyncRun = {
     /**
      * Error or validation messages of the syncable sync run
      */
-    error_messages: Array<unknown>;
+    error_messages: Array<{
+        key: string;
+        value: string;
+    }>;
     /**
      * Identifier of the sync run
      */
     sync_run_id: string;
+    /**
+     * Identifier of the syncable state this run item is linked to. Refers to the integrations/syncable_state resource
+     */
+    syncable_state_id: string;
     /**
      * Identifier of the company
      */
@@ -4700,25 +4945,49 @@ export type JobCatalogNodeAttribute = {
      * Competency payload including name, short description and optional level metadata
      */
     value_competency?: {
-        [key: string]: unknown;
+        name?: string;
+        description?: string;
+        level?: {
+            id: string;
+            name: string;
+            description: string;
+        };
     };
     /**
      * IT asset payload describing the device assigned to the node
      */
     value_it_management_asset?: {
-        [key: string]: unknown;
+        type_name: string;
+        brand: string;
+        name: string;
     };
     /**
      * Salary payload (cents) with currency, periodicity, range (min and max) or gross values in cents (35.000 EUR is stored as 3500000) and optional workplaces
      */
     value_salary_range?: {
-        [key: string]: unknown;
+        currency: string;
+        periodicity?: string;
+        min?: number;
+        max?: number;
+        gross?: number;
+        /**
+         * Workplaces where the salary range applies
+         */
+        workplaces?: Array<{
+            id: string;
+            name: string;
+        }>;
     };
     /**
      * Working-conditions payload with agreement info and simple key/value constraints. Numeric values are stored in cents (40 hours is stored as 4000).
      */
     value_working_conditions?: {
-        [key: string]: unknown;
+        name: string;
+        description?: string;
+        conditions: Array<{
+            key: string;
+            value: string;
+        }>;
     };
 };
 export type JobCatalogRole = {
@@ -4787,7 +5056,11 @@ export type JobCatalogNode = {
     /**
      * Array with the list of nodes tha compose full path from the current node to the root node.
      */
-    full_path_to_root?: Array<unknown>;
+    full_path_to_root?: Array<{
+        uuid: string;
+        name?: string;
+        description?: string;
+    }>;
     /**
      * Full title that represents the job position.
      */
@@ -4881,19 +5154,31 @@ export type MarketplaceInstallationSettings = {
     /**
      * Leave types codes
      */
-    leave_types: Array<unknown>;
+    leave_types: Array<{
+        id: string;
+        value: string;
+    }>;
     /**
      * Legal Entity file numbers
      */
-    file_numbers: Array<unknown>;
+    file_numbers: Array<{
+        legal_entity_id: string;
+        value: string;
+    }>;
     /**
      * Workplace establishment codes
      */
-    establishment_codes: Array<unknown>;
+    establishment_codes: Array<{
+        location_id: string;
+        value: string;
+    }>;
     /**
      * Timeoff allowance codes
      */
-    timeoff_allowance_code: Array<unknown>;
+    timeoff_allowance_code: Array<{
+        id: string;
+        value: string;
+    }>;
 };
 export type PayrollFamilySituation = {
     /**
@@ -5055,19 +5340,19 @@ export type PayrollEmployeesGermanEmployeeDatum = {
      */
     health_insurer_company_number?: string;
     /**
-     * Health insurance contribution class
+     * Health insurance contribution class. 0: No contribution (private health insurance or voluntary health insurance as self-payer), 1: General contribution, 3: Reduced contribution, 4: Contribution to agricultural health insurance, 5: Employer's contribution to agricultural health insurance, 6: Flat-rate contribution for marginal employees, 9: Corporate payer
      */
     contribution_class_health_insurance?: number;
     /**
-     * Unemployment insurance contribution class
+     * Unemployment insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
      */
     contribution_class_unemployment_insurance?: number;
     /**
-     * Pension insurance contribution class
+     * Pension insurance contribution class. 0: No contribution, 1: Full contribution, 3: Half contribution, 5: Flat-rate contribution for marginal employees
      */
     contribution_class_pension_insurance?: number;
     /**
-     * Long-term (nursing) insurance contribution class
+     * Long-term (nursing) insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
      */
     contribution_class_nursing_insurance?: number;
     /**
@@ -5099,23 +5384,23 @@ export type PayrollEmployeesGermanEmployeeDatum = {
      */
     child_tax_allowance?: number;
     /**
-     * Denomination of the employee
+     * Denomination of the employee. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
      */
     denomination?: string;
     /**
-     * Denomination of the employee's spouse
+     * Denomination of the employee's spouse. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
      */
     spouses_denomination?: string;
     /**
-     * Personnel leasing status of the employee
+     * Personnel leasing status of the employee. 0: such as client data, 1: no, 2: yes
      */
     personnel_leasing?: number;
     /**
-     * Highest level of professional training of the employee
+     * Highest level of professional training of the employee. 0: No specification, 1: Without vocational qualification, 2: Completion of recognized vocational training, 3: Master craftsman/technician or equivalent technical school degree, 4: Bachelor, 5: Diploma/Magister/Master/State examination, 6: Doctorate, 9: Qualification unknown
      */
     highest_level_of_professional_training?: number;
     /**
-     * Highest level of education of the employee
+     * Highest level of education of the employee. 0: No specification, 1: Without school qualification, 2: Secondary school diploma, 3: Intermediate school diploma or equivalent, 4: High school diploma/vocational diploma, 9: Qualification unknown
      */
     highest_level_of_education?: number;
 };
@@ -5216,7 +5501,8 @@ export type PerformanceAgreement = {
      * Conclusions of the action plan
      */
     conclusions?: {
-        [key: string]: unknown;
+        text: string;
+        last_updated_at: string;
     };
     /**
      * Self review evaluation ID
@@ -5229,11 +5515,21 @@ export type PerformanceAgreement = {
     /**
      * Self comments by question
      */
-    self_comments: Array<unknown>;
+    self_comments: Array<{
+        question_uuid: string;
+        author_access_id: string;
+        text: string;
+        updated_at: string;
+    }>;
     /**
      * Manager comments by question
      */
-    manager_comments: Array<unknown>;
+    manager_comments: Array<{
+        question_uuid: string;
+        author_access_id: string;
+        text: string;
+        updated_at: string;
+    }>;
 };
 export type PerformanceCompanyEmployeeScoreScale = {
     /**
@@ -5257,7 +5553,10 @@ export type PerformanceEmployeeScoreScale = {
     /**
      * Scale to be used when scoring the employee performance
      */
-    scale: Array<unknown>;
+    scale: Array<{
+        value: number;
+        text: string;
+    }>;
     is_default: boolean;
 };
 export type PerformanceReviewEmployeeScore = {
@@ -5367,19 +5666,130 @@ export type PerformanceReviewEvaluationAnswer = {
      * List of questions and their respective answers grouped by section.
      */
     answered_questionnaire_with_sections: {
-        [key: string]: unknown;
+        content: Array<{
+            uuid: string;
+            type: 'answered_question' | 'answered_section';
+            section_title?: string;
+            questions: Array<{
+                question: {
+                    uuid: string;
+                    mandatory: boolean;
+                    with_comment?: boolean;
+                    title: string;
+                    answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                    scale?: Array<{
+                        value: number;
+                        text: string;
+                    }>;
+                    max_choices?: number;
+                    choice_options?: Array<string>;
+                    metadata?: {
+                        competency_id?: string;
+                        competency_level_id?: string;
+                        competency_level_name?: string;
+                        competency_level_description?: string;
+                    };
+                    description?: string;
+                };
+                answer?: {
+                    uuid: string;
+                    answer_text?: string;
+                    answer_int?: number;
+                    answer_float?: number;
+                    answer_choice?: Array<string>;
+                    answer_rating?: {
+                        value?: number;
+                        comment?: string;
+                    };
+                };
+            }>;
+        }>;
     };
     /**
      * Questionnaire for getting employee score.
      */
     answered_employee_score_questionnaire?: {
-        [key: string]: unknown;
+        content: Array<{
+            uuid: string;
+            type: 'answered_question' | 'answered_section';
+            section_title?: string;
+            questions: Array<{
+                question: {
+                    uuid: string;
+                    mandatory: boolean;
+                    with_comment?: boolean;
+                    title: string;
+                    answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                    scale?: Array<{
+                        value: number;
+                        text: string;
+                    }>;
+                    max_choices?: number;
+                    choice_options?: Array<string>;
+                    metadata?: {
+                        competency_id?: string;
+                        competency_level_id?: string;
+                        competency_level_name?: string;
+                        competency_level_description?: string;
+                    };
+                    description?: string;
+                };
+                answer?: {
+                    uuid: string;
+                    answer_text?: string;
+                    answer_int?: number;
+                    answer_float?: number;
+                    answer_choice?: Array<string>;
+                    answer_rating?: {
+                        value?: number;
+                        comment?: string;
+                    };
+                };
+            }>;
+        }>;
     };
     /**
      * Questionnaire for getting the employee potential score.
      */
     answered_employee_potential_score_questionnaire?: {
-        [key: string]: unknown;
+        content: Array<{
+            uuid: string;
+            type: 'answered_question' | 'answered_section';
+            section_title?: string;
+            questions: Array<{
+                question: {
+                    uuid: string;
+                    mandatory: boolean;
+                    with_comment?: boolean;
+                    title: string;
+                    answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                    scale?: Array<{
+                        value: number;
+                        text: string;
+                    }>;
+                    max_choices?: number;
+                    choice_options?: Array<string>;
+                    metadata?: {
+                        competency_id?: string;
+                        competency_level_id?: string;
+                        competency_level_name?: string;
+                        competency_level_description?: string;
+                    };
+                    description?: string;
+                };
+                answer?: {
+                    uuid: string;
+                    answer_text?: string;
+                    answer_int?: number;
+                    answer_float?: number;
+                    answer_choice?: Array<string>;
+                    answer_rating?: {
+                        value?: number;
+                        comment?: string;
+                    };
+                };
+            }>;
+        }>;
     };
 };
 export type PerformanceReviewEvaluationScore = {
@@ -5479,7 +5889,8 @@ export type PerformanceReviewProcess = {
      * Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts
      */
     target_strategy?: {
-        [key: string]: unknown;
+        strategy: 'all_employees' | 'by_locations' | 'by_teams' | 'by_employees' | 'manual_selection';
+        arguments?: Array<string>;
     };
     /**
      * Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts
@@ -5505,13 +5916,14 @@ export type PerformanceReviewProcess = {
      * Action plans help track goal progress, and facilitate performance review discussions.
      */
     agreements_configuration: {
-        [key: string]: unknown;
+        enabled: boolean;
+        esignature_enabled: boolean;
     };
     /**
      * Assess employees based on their assigned competencies through both manager and self-reviews. Ensure roles with designated competencies are properly set up.
      */
     competencies_assessments_configuration: {
-        [key: string]: unknown;
+        enabled: boolean;
     };
     /**
      * Date when the last bulk reminder was sent
@@ -5547,7 +5959,8 @@ export type PerformanceReviewProcessCustomTemplate = {
      * Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts
      */
     target_strategy?: {
-        [key: string]: unknown;
+        strategy: 'all_employees' | 'by_locations' | 'by_teams' | 'by_employees' | 'manual_selection';
+        arguments?: Array<string>;
     };
     /**
      * Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts
@@ -5569,7 +5982,9 @@ export type PerformanceReviewProcessCustomTemplate = {
      * Visibility settings for the custom template
      */
     visibility_settings?: {
-        [key: string]: unknown;
+        restrict_answers_visibility_to_reportees: boolean;
+        early_access_to_answers_for_managers: boolean;
+        anonymous_peer_evaluation_for_target: boolean;
     };
     /**
      * Creation date of the template
@@ -5624,48 +6039,226 @@ export type PerformanceReviewQuestionnairesByStrategy = {
     /**
      * Scoring range used in rating questions
      */
-    default_rating_scale: Array<unknown>;
+    default_rating_scale: Array<{
+        value: number;
+        text: string;
+    }>;
     /**
      * Questionnaire for self evaluation
      */
     self_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire for manager evaluation
      */
     manager_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire for direct report evaluation
      */
     direct_report_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire for peers evaluation
      */
     peers_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire included in the end of self evaluation to evaluate the employee performance
      */
     employee_score_self_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire included in the end of manager evaluation to evaluate the employee performance
      */
     employee_score_manager_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     /**
      * Questionnaire included in the end of manager evaluation to evaluate the employee potential
      */
     employee_potential_score_manager_questionnaire?: {
-        [key: string]: unknown;
+        reviewer_strategy: 'self' | 'manager' | 'direct_reports' | 'peers';
+        content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
 };
 export type PerformanceReviewVisibilitySetting = {
@@ -6021,7 +6614,14 @@ export type ProcurementPurchaseOrder = {
      * Total cost of the purchase order
      */
     cost: {
-        [key: string]: unknown;
+        /**
+         * Total cost in cents (smallest currency unit)
+         */
+        cents: number;
+        /**
+         * Currency code in ISO 4217 format
+         */
+        currency: string;
     };
     /**
      * Date when the purchase order was created
@@ -6062,11 +6662,30 @@ export type ProcurementPurchaseOrder = {
     /**
      * Custom header field values, addressed by the field_key of the purchase order's PINNED template version, as an array of `{field_key, value}` pairs — exactly the shape the update endpoint accepts, so a GET -> modify -> PUT roundtrip works verbatim. Predefined fields (vendor, order_date, currency, due_date, payment_method, legal_entity) surface as top-level parameters instead, and computed or hidden values never appear (they are preserved server-side on update). Null for purchase orders without a template version.
      */
-    header_field_values_by_key?: Array<unknown>;
+    header_field_values_by_key?: Array<{
+        field_key: string;
+        value?: string;
+    }>;
     /**
      * Line items with their field values addressed by the field_key of the purchase order's PINNED template version — the same shape the update endpoint accepts: modify and send the whole set back. Rows are addressed by id (rows without an id are created, persisted rows missing from the set are deleted). Null for purchase orders without a template version.
      */
-    line_items_by_key?: Array<unknown>;
+    line_items_by_key?: Array<{
+        /**
+         * Identifier of the line item row.
+         */
+        id: string;
+        /**
+         * Zero-based position of the line item.
+         */
+        position: number;
+        /**
+         * Line-item values as `{field_key, value}` pairs.
+         */
+        fields: Array<{
+            field_key: string;
+            value?: string;
+        }>;
+    }>;
 };
 export type ProcurementPurchaseRequest = {
     /**
@@ -6089,7 +6708,14 @@ export type ProcurementPurchaseRequest = {
      * Total cost of the purchase request
      */
     cost: {
-        [key: string]: unknown;
+        /**
+         * Total cost in cents (smallest currency unit)
+         */
+        cents: number;
+        /**
+         * Currency code in ISO 4217 format
+         */
+        currency: string;
     };
     /**
      * Date when the purchase request was created
@@ -6933,7 +7559,16 @@ export type TimeoffAllowance = {
     /**
      * The tenure periods associated with the allowance.
      */
-    tenure_periods: Array<unknown>;
+    tenure_periods: Array<{
+        id: string;
+        period_type: 'months' | 'years';
+        period_length?: number;
+        adjustment_in_cents?: number;
+        balance_type: 'fixed_balance' | 'time_worked_based';
+        time_worked_based_hours_accrued_in_cents?: number;
+        time_worked_based_per_hours_worked_in_cents?: number;
+        max_cap_in_cents?: number;
+    }>;
     /**
      * Whether the allowance has tenure periods enabled or not.
      */
@@ -7021,11 +7656,60 @@ export type TimeoffAllowanceStatsNew = {
     /**
      * Array of cycle objects describing each accrual period for the allowance.
      */
-    cycles: Array<unknown>;
+    cycles: Array<{
+        id: string;
+        start_at: string;
+        end_at: string;
+        regular_start_at: string;
+        regular_end_at: string;
+        allowance_id: string;
+    }>;
     /**
      * Carry over entries between cycles, typed as an array of CycleCarryOver value objects.
      */
-    cycle_carry_overs: Array<unknown>;
+    cycle_carry_overs: Array<{
+        /**
+         * The date on which the source cycle ended, from which these carry-over units originate.
+         */
+        from_cycle_ending_on: string;
+        /**
+         * Number of months after the cycle end date before carry-over units expire. Null means no expiry.
+         */
+        expire_in_months?: number;
+        /**
+         * When true, carry-over units never expire regardless of expire_in_months.
+         */
+        non_expire: boolean;
+        /**
+         * Total carry-over units available from the source cycle (days or hours depending on allowance type).
+         */
+        total: string;
+        /**
+         * Individual leave entries that consumed carry-over units.
+         */
+        used: Array<{
+            /**
+             * Calendar day on which the leave was taken.
+             */
+            date: string;
+            /**
+             * Units consumed on that day (days or hours).
+             */
+            amount: string;
+        }>;
+        /**
+         * Total carry-over units accumulated (may differ from total when caps apply).
+         */
+        accumulated: string;
+        /**
+         * Carry-over units that have expired.
+         */
+        expired: string;
+        /**
+         * Carry-over units already consumed by leave.
+         */
+        taken: string;
+    }>;
     /**
      * Total carried over units accumulated from previous cycles.
      */
@@ -7107,7 +7791,16 @@ export type TimeoffBlockedPeriodsPolicy = {
     /**
      * The tenure periods associated with the allowance.
      */
-    time_periods: Array<unknown>;
+    time_periods: Array<{
+        id: string;
+        policy_id: string;
+        name: string;
+        period_type: string;
+        start_on?: string;
+        finish_on?: string;
+        duration?: number;
+        duration_unit?: string;
+    }>;
     /**
      * Type of access group
      */
@@ -7206,7 +7899,14 @@ export type TimeoffLeave = {
      * Per-day breakdown of the leave's workable and used units, keyed by calendar date. Populated only when the read requests `include_duration_by_day=true`; null otherwise.
      */
     duration_by_day_attributes?: {
-        [key: string]: unknown;
+        workable_units_by_day: {
+            days: unknown;
+            hours: unknown;
+        };
+        used_units_by_day: {
+            days: unknown;
+            hours: unknown;
+        };
     };
     /**
      * Number of days taken for paid leave. Reflects the summed per-day used total when the per-day breakdown is computed; otherwise the leave's calendar-day duration.
@@ -7351,7 +8051,21 @@ export type TimeoffPolicyTimeline = {
     employee_id: string;
     start_limit_date: string;
     end_limit_date: string;
-    items: Array<unknown>;
+    items: Array<{
+        policy_assignment: {
+            id?: string;
+            timeoff_policy_id: string;
+            timeoff_policy_name?: string;
+            is_initial?: boolean;
+            employee_id: string;
+            effective_at: string;
+            end_effective_at?: string;
+        };
+        start_at: string;
+        end_at: string;
+        is_first_item: boolean;
+        is_last_item: boolean;
+    }>;
     /**
      * This is the employee id since it's a virtual entity
      */
@@ -7861,7 +8575,18 @@ export type WorkScheduleSchedule = {
     /**
      * Overlap periods that make up the schedule
      */
-    periods: Array<unknown>;
+    periods: Array<{
+        id: string;
+        default: boolean;
+        schedule_id: string;
+        start_month: number;
+        start_day: number;
+        end_month: number;
+        end_day: number;
+        start_date: string;
+        end_date: string;
+        schedule_type: string;
+    }>;
 };
 export type BankingBankAccountNumber = {
     /**
@@ -8378,7 +9103,10 @@ export type PostApi20261001ResourcesAtsApplicationsData = {
         /**
          * answers
          */
-        answers?: Array<unknown>;
+        answers?: Array<{
+            ats_question_id: string;
+            value?: unknown;
+        }>;
     };
     path?: never;
     query?: never;
@@ -8532,7 +9260,10 @@ export type PostApi20261001ResourcesAtsApplicationsApplyData = {
         /**
          * answers
          */
-        answers?: Array<unknown>;
+        answers?: Array<{
+            ats_question_id: string;
+            value?: unknown;
+        }>;
     };
     path?: never;
     query?: never;
@@ -9356,7 +10087,10 @@ export type PostApi20261001ResourcesAtsQuestionsData = {
         /**
          * options for the question.
          */
-        options?: Array<unknown>;
+        options?: Array<{
+            text: string;
+            disqualifies?: boolean;
+        }>;
     };
     path?: never;
     query?: never;
@@ -9430,7 +10164,10 @@ export type PutApi20261001ResourcesAtsQuestionsByIdData = {
         /**
          * options for the question.
          */
-        options?: Array<unknown>;
+        options?: Array<{
+            text: string;
+            disqualifies?: boolean;
+        }>;
     };
     path: {
         /**
@@ -14244,7 +14981,9 @@ export type GetApi20261001ResourcesExpensesExpensablesData = {
         'ids[]'?: Array<string>;
         company_id?: string;
         'group_ids[]'?: Array<string>;
-        'by_resources[]'?: Array<unknown>;
+        'by_resources[]'?: Array<{
+            [key: string]: unknown;
+        }>;
         'employee_ids[]'?: Array<string>;
         'reporter_ids[]'?: Array<string>;
         'status[]'?: 'pending' | 'changes_requested' | 'approved' | 'paid' | 'rejected' | 'reversed' | 'draft' | 'in_payroll' | 'sent_to_pay';
@@ -14926,7 +15665,30 @@ export type PostApi20261001ResourcesFinanceContactsData = {
          * The address object containing street, city, etc.
          */
         address: {
-            [key: string]: unknown;
+            /**
+             * Street address line 1.
+             */
+            line1: string;
+            /**
+             * Street address line 2 or additional info.
+             */
+            line2?: string;
+            /**
+             * City where the Contact is located.
+             */
+            city: string;
+            /**
+             * Postal or ZIP code.
+             */
+            postal_code: string;
+            /**
+             * State or region for the Contact.
+             */
+            state: string;
+            /**
+             * Two-letter ISO country code.
+             */
+            country_code: string;
         };
         /**
          * International Bank Account Number if provided.
@@ -15008,7 +15770,30 @@ export type PutApi20261001ResourcesFinanceContactsByIdData = {
          * The address object containing street, city, etc. Example: { "city": "East Ariana", "country_code": "SC", "line1": "93402 Spencer Points", "line2": "Apt. 555", "postal_code": "61471", "state": "Oklahoma" }
          */
         address: {
-            [key: string]: unknown;
+            /**
+             * Street address line 1.
+             */
+            line1: string;
+            /**
+             * Street address line 2 or additional info.
+             */
+            line2?: string;
+            /**
+             * City where the Contact is located.
+             */
+            city: string;
+            /**
+             * Postal or ZIP code.
+             */
+            postal_code: string;
+            /**
+             * State or region for the Contact.
+             */
+            state: string;
+            /**
+             * Two-letter ISO country code.
+             */
+            country_code: string;
         };
         /**
          * The website of the Contact.
@@ -15177,7 +15962,13 @@ export type GetApi20261001ResourcesFinanceCostCenterMembershipsResponse = GetApi
 export type PostApi20261001ResourcesFinanceCostCenterMembershipsBulkCreateUpdateData = {
     body?: {
         employee_id: string;
-        memberships: Array<unknown>;
+        memberships: Array<{
+            id?: string;
+            cost_center_id: string;
+            start_date: string;
+            end_date?: string;
+            percentage: number;
+        }>;
         company_id: string;
     };
     path?: never;
@@ -15293,7 +16084,14 @@ export type PostApi20261001ResourcesFinanceFinancialDocumentsData = {
         /**
          * Purchase-invoice line items. When present they own the document totals.
          */
-        'line_items[]'?: Array<unknown>;
+        'line_items[]'?: Array<{
+            id?: string;
+            description: string;
+            quantity: number;
+            unit_price_cents: number;
+            tax_rate_id?: string;
+            discount_percentage?: number;
+        }>;
         /**
          * The document file to upload, the binary file. Required for purchase documents.
          */
@@ -15369,11 +16167,28 @@ export type PutApi20261001ResourcesFinanceFinancialDocumentsByIdData = {
         /**
          * Tax breakdown, as returned by the read endpoint — send back what you read (adjusted to your changes). Replaced as sent; ignored when line_items are provided, since the line items own the totals.
          */
-        taxes: Array<unknown>;
+        taxes: Array<{
+            amount_cents?: number;
+            percentage?: number;
+            base_amount_cents?: number;
+            type?: 'vat' | 'personal_income';
+            tax_type_id?: string;
+            tax_type_name?: string;
+            tax_rates?: Array<{
+                percentage: number;
+            }>;
+        }>;
         /**
          * Purchase-invoice line items. Rows are addressed by id, never by position: rows carrying an id update the matching line item, rows without an id create new ones, and persisted rows missing from the set are deleted. Send an empty array to remove all line items, or omit the field entirely to leave them untouched. When present they own the document totals.
          */
-        line_items?: Array<unknown>;
+        line_items?: Array<{
+            id?: string;
+            description: string;
+            quantity: number;
+            unit_price_cents: number;
+            tax_rate_id?: string;
+            discount_percentage?: number;
+        }>;
         /**
          * Legal entity identifier of the financial document.
          */
@@ -15473,7 +16288,24 @@ export type PostApi20261001ResourcesFinanceJournalEntriesData = {
         /**
          * Array of journal lines for this entry, example: [{"account_id": 9876, "debit_amount_cents": 0, "credit_amount_cents": 100, "external_id": "LINE-001"}, {"account_id": 9876, "debit_amount_cents": 100, "credit_amount_cents": 0, "external_id": "LINE-002"}]
          */
-        lines: Array<unknown>;
+        lines: Array<{
+            /**
+             * The debit amount in cents
+             */
+            debit_amount_cents: number;
+            /**
+             * The credit amount in cents
+             */
+            credit_amount_cents: number;
+            /**
+             * External identifier for the journal line
+             */
+            external_id?: string;
+            /**
+             * ID of the associated account
+             */
+            account_id: string;
+        }>;
         /**
          * Date of the associate source
          */
@@ -16172,7 +17004,30 @@ export type PostApi20261001ResourcesIntegrationsSyncableSyncRunsBulkUpsertData =
         /**
          * Outcome of each item the external system discovered/processed for this run. Rows are matched by (sync_run_id, external_identifier, syncable_type).
          */
-        items: Array<unknown>;
+        items: Array<{
+            /**
+             * Identifier of the item in the external system
+             */
+            external_identifier: string;
+            /**
+             * The Factorial resource type this item maps to
+             */
+            syncable_type: 'compensationscompensation' | 'expensesexpensable' | 'employeeupdatesleave' | 'employeeupdatesworkedtime' | 'financecontact';
+            /**
+             * Outcome of processing the item
+             */
+            status: 'success' | 'failed' | 'invalid';
+            /**
+             * The Factorial record this item resolved to (link). Only fills a missing link; re-linking to a different record is rejected.
+             */
+            syncable_id?: string;
+            /**
+             * Error or validation messages for failed rows
+             */
+            error_messages?: {
+                [key: string]: unknown;
+            };
+        }>;
     };
     path?: never;
     query?: never;
@@ -17407,19 +18262,19 @@ export type PostApi20261001ResourcesPayrollEmployeesGermanEmployeeDataData = {
          */
         health_insurer_company_number?: string;
         /**
-         * Health insurance contribution class
+         * Health insurance contribution class. 0: No contribution (private health insurance or voluntary health insurance as self-payer), 1: General contribution, 3: Reduced contribution, 4: Contribution to agricultural health insurance, 5: Employer's contribution to agricultural health insurance, 6: Flat-rate contribution for marginal employees, 9: Corporate payer
          */
         contribution_class_health_insurance?: number;
         /**
-         * Unemployment insurance contribution class
+         * Unemployment insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
          */
         contribution_class_unemployment_insurance?: number;
         /**
-         * Pension insurance contribution class
+         * Pension insurance contribution class. 0: No contribution, 1: Full contribution, 3: Half contribution, 5: Flat-rate contribution for marginal employees
          */
         contribution_class_pension_insurance?: number;
         /**
-         * Long-term (nursing) insurance contribution class
+         * Long-term (nursing) insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
          */
         contribution_class_nursing_insurance?: number;
         /**
@@ -17451,23 +18306,23 @@ export type PostApi20261001ResourcesPayrollEmployeesGermanEmployeeDataData = {
          */
         child_tax_allowance?: number;
         /**
-         * Denomination of the employee
+         * Denomination of the employee. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
          */
         denomination?: string;
         /**
-         * Denomination of the employee's spouse
+         * Denomination of the employee's spouse. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
          */
         spouses_denomination?: string;
         /**
-         * Personnel leasing status of the employee
+         * Personnel leasing status of the employee. 0: such as client data, 1: no, 2: yes
          */
         personnel_leasing?: number;
         /**
-         * Highest level of professional training of the employee
+         * Highest level of professional training of the employee. 0: No specification, 1: Without vocational qualification, 2: Completion of recognized vocational training, 3: Master craftsman/technician or equivalent technical school degree, 4: Bachelor, 5: Diploma/Magister/Master/State examination, 6: Doctorate, 9: Qualification unknown
          */
         highest_level_of_professional_training?: number;
         /**
-         * Highest level of education of the employee
+         * Highest level of education of the employee. 0: No specification, 1: Without school qualification, 2: Secondary school diploma, 3: Intermediate school diploma or equivalent, 4: High school diploma/vocational diploma, 9: Qualification unknown
          */
         highest_level_of_education?: number;
     };
@@ -17523,19 +18378,19 @@ export type PutApi20261001ResourcesPayrollEmployeesGermanEmployeeDataByIdData =
          */
         health_insurer_company_number?: string;
         /**
-         * Health insurance contribution class
+         * Health insurance contribution class. 0: No contribution (private health insurance or voluntary health insurance as self-payer), 1: General contribution, 3: Reduced contribution, 4: Contribution to agricultural health insurance, 5: Employer's contribution to agricultural health insurance, 6: Flat-rate contribution for marginal employees, 9: Corporate payer
          */
         contribution_class_health_insurance?: number;
         /**
-         * Unemployment insurance contribution class
+         * Unemployment insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
          */
         contribution_class_unemployment_insurance?: number;
         /**
-         * Pension insurance contribution class
+         * Pension insurance contribution class. 0: No contribution, 1: Full contribution, 3: Half contribution, 5: Flat-rate contribution for marginal employees
          */
         contribution_class_pension_insurance?: number;
         /**
-         * Long-term (nursing) insurance contribution class
+         * Long-term (nursing) insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution
          */
         contribution_class_nursing_insurance?: number;
         /**
@@ -17567,23 +18422,23 @@ export type PutApi20261001ResourcesPayrollEmployeesGermanEmployeeDataByIdData =
          */
         child_tax_allowance?: number;
         /**
-         * Denomination of the employee
+         * Denomination of the employee. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
          */
         denomination?: string;
         /**
-         * Denomination of the employee's spouse
+         * Denomination of the employee's spouse. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational
          */
         spouses_denomination?: string;
         /**
-         * Personnel leasing status of the employee
+         * Personnel leasing status of the employee. 0: such as client data, 1: no, 2: yes
          */
         personnel_leasing?: number;
         /**
-         * Highest level of professional training of the employee
+         * Highest level of professional training of the employee. 0: No specification, 1: Without vocational qualification, 2: Completion of recognized vocational training, 3: Master craftsman/technician or equivalent technical school degree, 4: Bachelor, 5: Diploma/Magister/Master/State examination, 6: Doctorate, 9: Qualification unknown
          */
         highest_level_of_professional_training?: number;
         /**
-         * Highest level of education of the employee
+         * Highest level of education of the employee. 0: No specification, 1: Without school qualification, 2: Secondary school diploma, 3: Intermediate school diploma or equivalent, 4: High school diploma/vocational diploma, 9: Qualification unknown
          */
         highest_level_of_education?: number;
     };
@@ -19006,7 +19861,10 @@ export type PostApi20261001ResourcesPerformanceReviewQuestionnaireByStrategiesUp
          * - `value`: Range value (0 to 10)
          * - `text`: Range description
          */
-        default_rating_scale: Array<unknown>;
+        default_rating_scale: Array<{
+            value: number;
+            text: string;
+        }>;
     };
     path?: never;
     query?: never;
@@ -19048,7 +19906,31 @@ export type PostApi20261001ResourcesPerformanceReviewQuestionnaireByStrategiesUp
          * - `max_choices`: Maximum number of choices. If `1`, it'll be a single choice question
          * - `choice_options`: List of options for single and multiple choice questions
          */
-        questionnaire_content: Array<unknown>;
+        questionnaire_content: Array<{
+            uuid: string;
+            type: 'question' | 'section';
+            section_title?: string;
+            questions: Array<{
+                uuid: string;
+                mandatory: boolean;
+                with_comment?: boolean;
+                title: string;
+                answer_type: 'text' | 'rating' | 'number' | 'multiple_choice';
+                scale?: Array<{
+                    value: number;
+                    text: string;
+                }>;
+                max_choices?: number;
+                choice_options?: Array<string>;
+                metadata?: {
+                    competency_id?: string;
+                    competency_level_id?: string;
+                    competency_level_name?: string;
+                    competency_level_description?: string;
+                };
+                description?: string;
+            }>;
+        }>;
     };
     path?: never;
     query?: never;
@@ -19852,11 +20734,32 @@ export type PostApi20261001ResourcesProcurementPurchaseOrdersData = {
         /**
          * Header field values of the ACTIVE purchase order template version, as an array of `{field_key, value}` pairs. Only custom (non-predefined, non-computed) field keys are accepted; predefined fields (vendor, order_date, currency, due_date, payment_method, legal_entity) are populated from the corresponding top-level parameters. Reference fields (employee, cost_center, project, tax_rate, team) take the referenced internal id as the value. If a field_key appears more than once, the last occurrence wins.
          */
-        header_field_values?: Array<unknown>;
+        header_field_values?: Array<{
+            /**
+             * Stable field key of the template field.
+             */
+            field_key: string;
+            /**
+             * Value for the field.
+             */
+            value?: string;
+        }>;
         /**
          * Line items of the purchase order, each carrying its values as an array of `{field_key, value}` pairs addressed by the line-item field keys of the ACTIVE template version (e.g. concept, quantity, unit_price, tax_rate). Computed keys (subtotal, tax_amount, total, discount_amount) are derived server-side and rejected as input.
          */
-        line_items?: Array<unknown>;
+        line_items?: Array<{
+            /**
+             * Zero-based position of the line item.
+             */
+            position: number;
+            /**
+             * Line-item values as `{field_key, value}` pairs.
+             */
+            fields: Array<{
+                field_key: string;
+                value?: string;
+            }>;
+        }>;
     };
     path?: never;
     query?: never;
@@ -19921,7 +20824,14 @@ export type PutApi20261001ResourcesProcurementPurchaseOrdersByIdData = {
          * Total cost of the purchase order, as returned by the read endpoint — send back what you read. The currency is applied as sent; on template-versioned purchase orders the amounts are owned by the line items and recomputed server-side.
          */
         cost: {
-            [key: string]: unknown;
+            /**
+             * Total cost in cents (smallest currency unit).
+             */
+            cents: number;
+            /**
+             * Currency code in ISO 4217 format.
+             */
+            currency: string;
         };
         /**
          * Identifier of the vendor (Finance contact) by internal Factorial id. Null clears the vendor on template-versioned purchase orders.
@@ -19938,11 +20848,21 @@ export type PutApi20261001ResourcesProcurementPurchaseOrdersByIdData = {
         /**
          * Header field values of the purchase order's template version, as an array of `{field_key, value}` pairs — the same shape the read returns. Replaced as sent: send the complete set; an empty array deletes all custom header values, and omitting the field leaves them untouched. Only custom field keys are accepted; predefined fields (vendor, order_date, currency, due_date, payment_method, legal_entity) come from the corresponding top-level parameters. Reference fields take the referenced id as the value. If a field_key appears more than once, the last occurrence wins.
          */
-        header_field_values_by_key?: Array<unknown>;
+        header_field_values_by_key?: Array<{
+            field_key: string;
+            value?: string;
+        }>;
         /**
          * Line items of the purchase order, replaced as sent — the same shape the read returns. Rows with an id update the matching line item, rows without an id create new ones, and persisted rows missing from the set are deleted. Send an empty array to remove all line items, or omit the field to leave them untouched. Values travel as `{field_key, value}` pairs; computed keys (subtotal, tax_amount, total, discount_amount) are derived server-side and rejected as input.
          */
-        line_items_by_key?: Array<unknown>;
+        line_items_by_key?: Array<{
+            id?: string;
+            position: number;
+            fields: Array<{
+                field_key: string;
+                value?: string;
+            }>;
+        }>;
     };
     path: {
         /**
@@ -21585,7 +22505,21 @@ export type PostApi20261001ResourcesProjectManagementTimeRecordsBulkDeleteRespon
 export type PostApi20261001ResourcesProjectManagementTimeRecordsBulkDeleteResponse = PostApi20261001ResourcesProjectManagementTimeRecordsBulkDeleteResponses[keyof PostApi20261001ResourcesProjectManagementTimeRecordsBulkDeleteResponses];
 export type PostApi20261001ResourcesProjectManagementTimeRecordsBulkProcessData = {
     body?: {
-        items: Array<unknown>;
+        items: Array<{
+            time_record_id?: string;
+            attendance_shift_id?: string;
+            project_worker_id?: string;
+            subproject_id?: string;
+            project_task_id?: string;
+            /**
+             * Imputed minutes for the time record (used when no attendance shift is provided)
+             */
+            imputed_minutes?: number;
+            /**
+             * Reference date for the time record (used when no attendance shift is provided)
+             */
+            date?: string;
+        }>;
     };
     path?: never;
     query?: never;
@@ -21790,11 +22724,87 @@ export type PostApi20261001ResourcesShiftManagementShiftsBulkCreateData = {
         /**
          * Array of shift objects to create. Each shift object represents a scheduled work period for an employee
          */
-        shifts: Array<unknown>;
+        shifts: Array<{
+            /**
+             * Display name of the shift. If not explicitly set, falls back to the default shift title or template week name
+             */
+            name?: string;
+            /**
+             * Timestamp indicating when the shift starts. Required parameter
+             */
+            start_at: string;
+            /**
+             * Timestamp indicating when the shift ends. Required parameter
+             */
+            end_at: string;
+            /**
+             * Optional notes or comments about the shift, visible to managers and schedulers
+             */
+            notes?: string;
+            /**
+             * Indicates whether this shift counts as extra hours beyond the employee's regular schedule. Used for overtime calculations
+             */
+            extra_hours?: boolean;
+            /**
+             * Initial state of the shift. 'draft' means the shift is not yet visible to employees, 'published' means it's visible and confirmed, 'backup' indicates a backup shift that can be replaced. Default is 'draft'
+             */
+            state: 'draft' | 'published' | 'backup';
+            /**
+             * Indicates how the shift is created. 'manual' means it's created by a user, 'automatic' means it's generated by the system (e.g., from templates or scheduling algorithms). Default is 'manual'
+             */
+            creation_mode: 'manual' | 'automatic';
+            /**
+             * Identifier of the employee assigned to this shift. Required parameter
+             */
+            employee_id: string;
+            /**
+             * Identifier of the location where the shift takes place. Can be null if the shift uses the employee's default location
+             */
+            location_id?: string;
+            /**
+             * Identifier of the specific work area within the location where the shift occurs. Work areas allow further subdivision of locations
+             */
+            work_area_id?: string;
+            /**
+             * Identifier of the company that owns this shift. Required parameter
+             */
+            company_id: string;
+            /**
+             * Identifier of the default shift template used to create this shift. Default shifts provide reusable shift patterns (start/end times, titles)
+             */
+            default_shift_id?: string;
+            /**
+             * Identifier of the template week used to generate this shift. Template weeks allow bulk creation of shifts following a pattern
+             */
+            template_week_id?: string;
+            /**
+             * Identifier of the unassigned shift placeholder that is being converted to create this shift. Unassigned shifts are temporary placeholders
+             */
+            unassigned_shift_id?: string;
+            /**
+             * Identifier of the leave (time off) associated with this shift, if applicable. Used when shifts are created or modified due to leave requests
+             */
+            leave_id?: string;
+            /**
+             * Identifier of the user/access who is creating this shift. Used for audit purposes. If null, uses the current authenticated user
+             */
+            author_id?: string;
+        }>;
         /**
          * An array of planned breaks to be added to the shifts created.
          */
-        planned_breaks?: Array<unknown>;
+        planned_breaks?: Array<{
+            id?: string;
+            start_at?: string;
+            end_at?: string;
+            duration?: number;
+            break_type?: string;
+            break_configuration_id: string;
+            default_shift_id?: string;
+            shift_id?: string;
+            day_configuration_id?: string;
+            shift_configuration_id?: string;
+        }>;
     };
     path?: never;
     query?: never;
@@ -22072,7 +23082,16 @@ export type PostApi20261001ResourcesTasksTasksBulkUpdateData = {
         /**
          * a list of tasks to update.
          */
-        tasks: Array<unknown>;
+        tasks: Array<{
+            id: string;
+            name?: string;
+            content?: string;
+            starts_on?: string;
+            due_on?: string;
+            assignee_ids?: Array<string>;
+            identifier?: 'single' | 'workflow' | 'project' | 'shared_and_single' | 'inbox';
+            status?: 'todo' | 'in_progress' | 'done' | 'discarded';
+        }>;
     };
     path?: never;
     query?: never;
@@ -22573,7 +23592,16 @@ export type PostApi20261001ResourcesTimeoffAllowancesData = {
         /**
          * The tenure periods associated with the allowance.
          */
-        tenure_periods: Array<unknown>;
+        tenure_periods: Array<{
+            adjustment_in_cents?: number;
+            balance_type: 'fixed_balance' | 'time_worked_based';
+            max_cap_in_cents?: number;
+            period_length: number;
+            period_type: 'months' | 'years';
+            temp_id?: string;
+            time_worked_based_hours_accrued_in_cents?: number;
+            time_worked_based_per_hours_worked_in_cents?: number;
+        }>;
         /**
          * The Id of the policy to which the allowance belongs to
          */
@@ -22728,7 +23756,18 @@ export type PutApi20261001ResourcesTimeoffAllowancesByIdData = {
         /**
          * The tenure periods associated with the allowance.
          */
-        tenure_periods?: Array<unknown>;
+        tenure_periods?: Array<{
+            id?: string;
+            adjustment_in_cents?: number;
+            balance_type?: 'fixed_balance' | 'time_worked_based';
+            max_cap_in_cents?: number;
+            period_length?: number;
+            period_type?: 'months' | 'years';
+            temp_id?: string;
+            time_worked_based_hours_accrued_in_cents?: number;
+            time_worked_based_per_hours_worked_in_cents?: number;
+            _destroy?: boolean;
+        }>;
         /**
          * Flag to indicate if there is unlimited accrual.
          */
@@ -23054,7 +24093,16 @@ export type PutApi20261001ResourcesTimeoffBlockedPeriodsByIdData = {
         /**
          * The tenure periods associated with the allowance edited.
          */
-        time_periods_attributes: Array<unknown>;
+        time_periods_attributes: Array<{
+            id?: string;
+            name?: string;
+            _destroy?: boolean;
+            period_type?: string;
+            duration?: number;
+            duration_unit?: string;
+            start_on?: string;
+            finish_on?: string;
+        }>;
         /**
          * Type of access group
          */
@@ -23150,6 +24198,10 @@ export type GetApi20261001ResourcesTimeoffLeavesData = {
          * Retrieve payable leaves
          */
         type_is_payable?: boolean;
+        /**
+         * Caps the per-day duration walk at this date. For endless leaves (`finish_on = nil`) it pins the walk end; for closed leaves whose `finish_on` sits past this date it truncates the walk. Never extends a leave past its real `finish_on`. Must fall inside the read window (from/to or overlaps_range_from/overlaps_range_to).
+         */
+        forced_finish_on?: string;
     };
     url: '/api/2026-10-01/resources/timeoff/leaves';
 };
@@ -23998,7 +25050,45 @@ export type PostApi20261001ResourcesTimePlanningPlannedBreaksBulkCreateData = {
         /**
          * List of planned breaks to create
          */
-        planned_breaks: Array<unknown>;
+        planned_breaks: Array<{
+            /**
+             * Planned break identifier
+             */
+            id?: string;
+            /**
+             * Break start time
+             */
+            start_at?: string;
+            /**
+             * Break end time
+             */
+            end_at?: string;
+            duration?: number;
+            /**
+             * Type of the break
+             */
+            break_type?: string;
+            /**
+             * Break configuration identifier
+             */
+            break_configuration_id: string;
+            /**
+             * Default shift identifier
+             */
+            default_shift_id?: string;
+            /**
+             * Shift identifier
+             */
+            shift_id?: string;
+            /**
+             * Day configuration identifier
+             */
+            day_configuration_id?: string;
+            /**
+             * Shift configuration identifier
+             */
+            shift_configuration_id?: string;
+        }>;
     };
     path?: never;
     query?: never;
@@ -24430,7 +25520,13 @@ export type PostApi20261001ResourcesTrainingsSessionsData = {
         /**
          * Session reminder notifications for those assigned to the session
          */
-        reminders?: Array<unknown>;
+        reminders?: Array<{
+            session_id?: string;
+            name: string;
+            content?: string;
+            scheduled_at?: string;
+            timeframe?: 'onehour' | 'oneday' | 'twodays' | 'threedays' | 'oneweek' | 'custom';
+        }>;
         /**
          * Send calendar invites to attendees assigned to the session
          */
@@ -24817,7 +25913,12 @@ export type PostApi20261001ResourcesTrainingsTrainingsData = {
         /**
          * Attachments of the training
          */
-        attachments: Array<unknown>;
+        attachments: Array<{
+            author_id: string;
+            file: Blob | File;
+            visibility: boolean;
+            title?: string;
+        }>;
         /**
          * The training validity period in years
          */
@@ -25335,7 +26436,12 @@ export type GetApi20261001ResourcesWorkScheduleDayConfigurationsByIdResponse = G
 export type PostApi20261001ResourcesWorkScheduleDayConfigurationsBulkCudData = {
     body?: {
         overlap_period_id: string;
-        day_configurations: Array<unknown>;
+        day_configurations: Array<{
+            id?: string;
+            weekday: string;
+            start_at?: string;
+            duration_in_seconds: number;
+        }>;
     };
     path?: never;
     query?: never;
@@ -25345,7 +26451,7 @@ export type PostApi20261001ResourcesWorkScheduleDayConfigurationsBulkCudResponse
     /**
      * OK
      */
-    200: WorkScheduleDayConfiguration;
+    200: Array<WorkScheduleDayConfiguration>;
 };
 export type PostApi20261001ResourcesWorkScheduleDayConfigurationsBulkCudResponse = PostApi20261001ResourcesWorkScheduleDayConfigurationsBulkCudResponses[keyof PostApi20261001ResourcesWorkScheduleDayConfigurationsBulkCudResponses];
 export type GetApi20261001ResourcesWorkScheduleOverlapPeriodsData = {
@@ -25379,7 +26485,12 @@ export type PostApi20261001ResourcesWorkScheduleOverlapPeriodsData = {
          * Attributes for the new overlap period (default flag, start/end day and month, and schedule type)
          */
         create_params?: {
-            [key: string]: unknown;
+            default: boolean;
+            start_day: number;
+            start_month: number;
+            end_day: number;
+            end_month: number;
+            schedule_type: string;
         };
     };
     path?: never;
@@ -25436,7 +26547,10 @@ export type PutApi20261001ResourcesWorkScheduleOverlapPeriodsByIdData = {
          * Attributes to update on the overlap period (start/end day and month)
          */
         update_params?: {
-            [key: string]: unknown;
+            start_day?: number;
+            start_month?: number;
+            end_day?: number;
+            end_month?: number;
         };
     };
     path: {