---
updatedAt: 2026-07-02T10:18:47.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# Approves a Leave

Allows authorized users to approve employee time-off requests by approving the corresponding approval flow if it exists

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > ApiPublic > WebhookSubscription > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `api_public/webhook_subscription/create`",
        "deprecated": false,
        "summary": "ApiPublic > WebhookSubscription > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/api_public_webhook_subscription"
              }
            }
          }
        }
      }
    },
    "Webhooks > ApiPublic > WebhookSubscription > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `api_public/webhook_subscription/delete`",
        "deprecated": false,
        "summary": "ApiPublic > WebhookSubscription > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/api_public_webhook_subscription"
              }
            }
          }
        }
      }
    },
    "Webhooks > ApiPublic > WebhookSubscription > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `api_public/webhook_subscription/update`",
        "deprecated": false,
        "summary": "ApiPublic > WebhookSubscription > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/api_public_webhook_subscription"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Application > Applies": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/application/apply`",
        "deprecated": false,
        "summary": "Ats > Application > Applies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_application"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Application > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/application/create`",
        "deprecated": false,
        "summary": "Ats > Application > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_application"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Application > Create from employees": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/application/create_from_employee`",
        "deprecated": false,
        "summary": "Ats > Application > Create from employees",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_application"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Application > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/application/delete`",
        "deprecated": false,
        "summary": "Ats > Application > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_application"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Application > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/application/update`",
        "deprecated": false,
        "summary": "Ats > Application > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_application"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Candidate > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/candidate/create`",
        "deprecated": false,
        "summary": "Ats > Candidate > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_candidate"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Candidate > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/candidate/delete`",
        "deprecated": false,
        "summary": "Ats > Candidate > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_candidate"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > Candidate > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/candidate/update`",
        "deprecated": false,
        "summary": "Ats > Candidate > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_candidate"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > EvaluationForm > Save as templates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/evaluation_form/save_as_template`",
        "deprecated": false,
        "summary": "Ats > EvaluationForm > Save as templates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_evaluation_form"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > JobPosting > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/job_posting/create`",
        "deprecated": false,
        "summary": "Ats > JobPosting > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_job_posting"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > JobPosting > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/job_posting/delete`",
        "deprecated": false,
        "summary": "Ats > JobPosting > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_job_posting"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > JobPosting > Duplicates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/job_posting/duplicate`",
        "deprecated": false,
        "summary": "Ats > JobPosting > Duplicates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_job_posting"
              }
            }
          }
        }
      }
    },
    "Webhooks > Ats > JobPosting > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/job_posting/update`",
        "deprecated": false,
        "summary": "Ats > JobPosting > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_job_posting"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Autofills": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/autofill`",
        "deprecated": false,
        "summary": "Attendance > Shift > Autofills",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Break ends": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/break_end`",
        "deprecated": false,
        "summary": "Attendance > Shift > Break ends",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Break starts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/break_start`",
        "deprecated": false,
        "summary": "Attendance > Shift > Break starts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Clock ins": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/clock_in`",
        "deprecated": false,
        "summary": "Attendance > Shift > Clock ins",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Clock outs": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/clock_out`",
        "deprecated": false,
        "summary": "Attendance > Shift > Clock outs",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/create`",
        "deprecated": false,
        "summary": "Attendance > Shift > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/delete`",
        "deprecated": false,
        "summary": "Attendance > Shift > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Toggle clocks": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/toggle_clock`",
        "deprecated": false,
        "summary": "Attendance > Shift > Toggle clocks",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Attendance > Shift > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `attendance/shift/update`",
        "deprecated": false,
        "summary": "Attendance > Shift > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/attendance_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Banking > BankAccountNumber > Upserts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `banking/bank_account_number/upsert`",
        "deprecated": false,
        "summary": "Banking > BankAccountNumber > Upserts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/banking_bank_account_number"
              }
            }
          }
        }
      }
    },
    "Webhooks > BookkeepersManagement > Incidence > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `bookkeepers_management/incidence/update`",
        "deprecated": false,
        "summary": "BookkeepersManagement > Incidence > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/bookkeepers_management_incidence"
              }
            }
          }
        }
      }
    },
    "Webhooks > Companies > LegalEntity > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `companies/legal_entity/create`",
        "deprecated": false,
        "summary": "Companies > LegalEntity > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/companies_legal_entity"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersionRequest > Approves": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version_request/approve`. Triggered when a promote request is approved in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersionRequest > Approves",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version_request"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersionRequest > Create promote requests": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version_request/create_promote_request`. Triggered when a promote request is created using \"Promote\" in employee contracts page in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersionRequest > Create promote requests",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version_request"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersionRequest > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version_request/delete`. Triggered when a promote request is deleted in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersionRequest > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version_request"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersionRequest > Rejects": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version_request/reject`. Triggered when a promote request is rejected in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersionRequest > Rejects",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version_request"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersion > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version/create`. Triggered when a contract version is created via Public API (POST), an employee is created, using \"Start activity period\" for a discontinuous contract in employee contracts page in Factorial UI, or using \"Update conditions\" in employee contracts page in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersion > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersion > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version/delete`. Triggered when a contract version is deleted via Public API (DELETE), or using \"Delete contract\" in employee contracts page in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersion > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version"
              }
            }
          }
        }
      }
    },
    "Webhooks > Contracts > ContractVersion > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `contracts/contract_version/update`. Triggered when a contract version is updated via Public API (PUT), using \"Edit conditions\" in employee contracts page in Factorial UI, or using \"End activity period\" for a discontinuous contract in employee contracts page in Factorial UI.\n",
        "deprecated": false,
        "summary": "Contracts > ContractVersion > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/contracts_contract_version"
              }
            }
          }
        }
      }
    },
    "Webhooks > CustomResources > Schema > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `custom_resources/schema/create`",
        "deprecated": false,
        "summary": "CustomResources > Schema > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/custom_resources_schema"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Bulk creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/bulk_create`",
        "deprecated": false,
        "summary": "Documents > Document > Bulk creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/create`",
        "deprecated": false,
        "summary": "Documents > Document > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/delete`",
        "deprecated": false,
        "summary": "Documents > Document > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Move to trash bins": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/move_to_trash_bin`",
        "deprecated": false,
        "summary": "Documents > Document > Move to trash bins",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Restore from trash bins": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/restore_from_trash_bin`",
        "deprecated": false,
        "summary": "Documents > Document > Restore from trash bins",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Document > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/document/update`",
        "deprecated": false,
        "summary": "Documents > Document > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_document"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Folder > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/folder/create`",
        "deprecated": false,
        "summary": "Documents > Folder > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_folder"
              }
            }
          }
        }
      }
    },
    "Webhooks > Documents > Folder > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `documents/folder/update`",
        "deprecated": false,
        "summary": "Documents > Folder > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/documents_folder"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Create with contracts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/create_with_contract`",
        "deprecated": false,
        "summary": "Employees > Employee > Create with contracts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Invites": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/invite`",
        "deprecated": false,
        "summary": "Employees > Employee > Invites",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Set regular access start dates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/set_regular_access_start_date`",
        "deprecated": false,
        "summary": "Employees > Employee > Set regular access start dates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Terminates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/terminate`",
        "deprecated": false,
        "summary": "Employees > Employee > Terminates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Unterminates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/unterminate`",
        "deprecated": false,
        "summary": "Employees > Employee > Unterminates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Employees > Employee > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `employees/employee/update`",
        "deprecated": false,
        "summary": "Employees > Employee > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees_employee"
              }
            }
          }
        }
      }
    },
    "Webhooks > Expenses > Expensable > Bulk set to paids": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `expenses/expensable/bulk_set_to_paid`",
        "deprecated": false,
        "summary": "Expenses > Expensable > Bulk set to paids",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/expenses_expensable"
              }
            }
          }
        }
      }
    },
    "Webhooks > Expenses > Expensable > Update reimbursable amounts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `expenses/expensable/update_reimbursable_amount`",
        "deprecated": false,
        "summary": "Expenses > Expensable > Update reimbursable amounts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/expenses_expensable"
              }
            }
          }
        }
      }
    },
    "Webhooks > Finance > CostCenter > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `finance/cost_center/create`",
        "deprecated": false,
        "summary": "Finance > CostCenter > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/finance_cost_center"
              }
            }
          }
        }
      }
    },
    "Webhooks > Finance > CostCenter > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `finance/cost_center/delete`",
        "deprecated": false,
        "summary": "Finance > CostCenter > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/finance_cost_center"
              }
            }
          }
        }
      }
    },
    "Webhooks > Finance > CostCenter > Edits": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `finance/cost_center/edit`",
        "deprecated": false,
        "summary": "Finance > CostCenter > Edits",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/finance_cost_center"
              }
            }
          }
        }
      }
    },
    "Webhooks > Locations > Location > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `locations/location/create`",
        "deprecated": false,
        "summary": "Locations > Location > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/locations_location"
              }
            }
          }
        }
      }
    },
    "Webhooks > Locations > Location > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `locations/location/delete`",
        "deprecated": false,
        "summary": "Locations > Location > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/locations_location"
              }
            }
          }
        }
      }
    },
    "Webhooks > Locations > Location > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `locations/location/update`",
        "deprecated": false,
        "summary": "Locations > Location > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/locations_location"
              }
            }
          }
        }
      }
    },
    "Webhooks > Payroll > PolicyPeriod > Change statuses": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll/policy_period/change_status`",
        "deprecated": false,
        "summary": "Payroll > PolicyPeriod > Change statuses",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_policy_period"
              }
            }
          }
        }
      }
    },
    "Webhooks > Payroll > Supplement > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll/supplement/create`",
        "deprecated": false,
        "summary": "Payroll > Supplement > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_supplement"
              }
            }
          }
        }
      }
    },
    "Webhooks > Payroll > Supplement > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll/supplement/delete`",
        "deprecated": false,
        "summary": "Payroll > Supplement > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_supplement"
              }
            }
          }
        }
      }
    },
    "Webhooks > Payroll > Supplement > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll/supplement/update`",
        "deprecated": false,
        "summary": "Payroll > Supplement > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_supplement"
              }
            }
          }
        }
      }
    },
    "Webhooks > PayrollIntegrationsBase > Code > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll_integrations_base/code/create`",
        "deprecated": false,
        "summary": "PayrollIntegrationsBase > Code > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_integrations_base_code"
              }
            }
          }
        }
      }
    },
    "Webhooks > PayrollIntegrationsBase > Code > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll_integrations_base/code/delete`",
        "deprecated": false,
        "summary": "PayrollIntegrationsBase > Code > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_integrations_base_code"
              }
            }
          }
        }
      }
    },
    "Webhooks > PayrollIntegrationsBase > Code > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `payroll_integrations_base/code/update`",
        "deprecated": false,
        "summary": "PayrollIntegrationsBase > Code > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/payroll_integrations_base_code"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/create`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Create from templates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/create_from_template`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Create from templates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/delete`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Duplicates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/duplicate`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Duplicates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Remind in bulks": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/remind_in_bulk`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Remind in bulks",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Remove schedules": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/remove_schedule`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Remove schedules",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Reopens": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/reopen`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Reopens",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Schedules": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/schedule`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Schedules",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Starts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/start`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Starts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Stops": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/stop`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Stops",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Toggle archives": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/toggle_archive`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Toggle archives",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update agreements configurations": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_agreements_configuration`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update agreements configurations",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update basic infos": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_basic_info`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update basic infos",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update competencies assessments configurations": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_competencies_assessments_configuration`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update competencies assessments configurations",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update deadlines": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_deadline`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update deadlines",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update employee score configurations": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_employee_score_configuration`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update employee score configurations",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update reviewer strategies": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_reviewer_strategies`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update reviewer strategies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update schedules": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_schedule`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update schedules",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > Performance > ReviewProcess > Update target strategies": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/update_target_strategy`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Update target strategies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    },
    "Webhooks > ProjectManagement > TimeRecord > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `project_management/time_record/create`",
        "deprecated": false,
        "summary": "ProjectManagement > TimeRecord > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/project_management_time_record"
              }
            }
          }
        }
      }
    },
    "Webhooks > ProjectManagement > TimeRecord > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `project_management/time_record/delete`",
        "deprecated": false,
        "summary": "ProjectManagement > TimeRecord > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/project_management_time_record"
              }
            }
          }
        }
      }
    },
    "Webhooks > ProjectManagement > TimeRecord > Update imputed minutes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `project_management/time_record/update_imputed_minutes`",
        "deprecated": false,
        "summary": "ProjectManagement > TimeRecord > Update imputed minutes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/project_management_time_record"
              }
            }
          }
        }
      }
    },
    "Webhooks > ProjectManagement > TimeRecord > Update observations": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `project_management/time_record/update_observations`",
        "deprecated": false,
        "summary": "ProjectManagement > TimeRecord > Update observations",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/project_management_time_record"
              }
            }
          }
        }
      }
    },
    "Webhooks > ProjectManagement > TimeRecord > Update project workers": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `project_management/time_record/update_project_worker`",
        "deprecated": false,
        "summary": "ProjectManagement > TimeRecord > Update project workers",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/project_management_time_record"
              }
            }
          }
        }
      }
    },
    "Webhooks > ShiftManagement > Shift > Bulk creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `shift_management/shift/bulk_create`",
        "deprecated": false,
        "summary": "ShiftManagement > Shift > Bulk creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/shift_management_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > ShiftManagement > Shift > Bulk deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `shift_management/shift/bulk_delete`",
        "deprecated": false,
        "summary": "ShiftManagement > Shift > Bulk deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/shift_management_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > ShiftManagement > Shift > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `shift_management/shift/create`",
        "deprecated": false,
        "summary": "ShiftManagement > Shift > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/shift_management_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > ShiftManagement > Shift > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `shift_management/shift/delete`",
        "deprecated": false,
        "summary": "ShiftManagement > Shift > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/shift_management_shift"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Bulk creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/bulk_create`",
        "deprecated": false,
        "summary": "Tasks > Task > Bulk creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Bulk deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/bulk_delete`",
        "deprecated": false,
        "summary": "Tasks > Task > Bulk deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Bulk updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/bulk_update`",
        "deprecated": false,
        "summary": "Tasks > Task > Bulk updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Copies": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/copy`",
        "deprecated": false,
        "summary": "Tasks > Task > Copies",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/create`",
        "deprecated": false,
        "summary": "Tasks > Task > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Create comments": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/create_comment`",
        "deprecated": false,
        "summary": "Tasks > Task > Create comments",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/delete`",
        "deprecated": false,
        "summary": "Tasks > Task > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Tasks > Task > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `tasks/task/update`",
        "deprecated": false,
        "summary": "Tasks > Task > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tasks_task"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Membership > Bulk upserts": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/membership/bulk_upsert`",
        "deprecated": false,
        "summary": "Teams > Membership > Bulk upserts",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_membership"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Membership > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/membership/create`. Triggered when a direct membership is created — one placing the employee on that team itself, as opposed to a row they get through a sub-team. Fires whether the membership is created through the API or from Factorial. Inherited rows created afterwards in ancestor teams (nested teams) do not trigger this event; read the memberships endpoint if you need to track them. Nor is this a complete feed of additions, and which event an addition produces depends on the side it is made from. Adding people to a team emits `teams/membership/bulk_upsert` and not this event; adding a team to a person emits both, so `bulk_upsert` is the wider of the two feeds. For companies with nested teams there is a third shape: the employee profile and imports set the complete set of teams the employee belongs to, which emits nothing at all, so those rows are only observable by reading the memberships endpoint.",
        "deprecated": false,
        "summary": "Teams > Membership > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_membership"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Membership > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/membership/delete`. Triggered when a membership is deleted through this verb, whether the deletion is made through the API or from Factorial. The payload is the row the request named, which may itself be an inherited one. The direct rows removed in its source sub-teams as a consequence, and the inherited copies cleaned up afterwards in ancestor teams, do not trigger this event; read the memberships endpoint if you need to track them. Nor is this a complete feed of removals: for companies with nested teams, removing members in bulk and setting the complete set of teams an employee belongs to — which is also how imports write there — emit nothing at all, so those removals are only observable by reading that endpoint too.",
        "deprecated": false,
        "summary": "Teams > Membership > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_membership"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Membership > Moves": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/membership/move`. Triggered when a membership is moved to another team, whether the move is made through the API or from Factorial. The payload is the membership row created in the destination team, so `team_id` is that team and `id` is a new one — the row in the source team is removed without an event of its own, so reconcile by `employee_id` rather than by `id`, or the employee ends up in both teams. A move emits no create or delete event for the two teams involved, so this is the event that reports a change of team made through this verb — and only through it. Most ways an employee changes team in Factorial do not use it: some are carried out as a separate addition and removal, which arrive as their own events and not as this one, and some emit nothing at all. Treat this as one signal among several rather than a complete feed, and reconcile against the memberships endpoint.",
        "deprecated": false,
        "summary": "Teams > Membership > Moves",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_membership"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Membership > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/membership/update`",
        "deprecated": false,
        "summary": "Teams > Membership > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_membership"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Team > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/create`",
        "deprecated": false,
        "summary": "Teams > Team > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Team > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/delete`",
        "deprecated": false,
        "summary": "Teams > Team > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Team > Moves": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/move`. Triggered when a team is moved under a different parent team (or to the root of the hierarchy), whether the move is made through the API or from Factorial. This event belongs to the 2026-10-01 contract, where the payload carries the public team fields plus the resulting position — `parent_team_id` is the new parent (null when moved to the root) and `depth` its new level. A subscription pinned to an earlier version still receives the event, but without those two fields, and the hierarchy is absent from the teams read on those versions too, so upgrading is the only way to obtain the new position rather than infer it. The memberships re-propagated to the new ancestors are created afterwards and emit no membership events of their own, so a subscriber tracking who belongs where has to read the affected sub-tree.",
        "deprecated": false,
        "summary": "Teams > Team > Moves",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Team > Projects": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/project`",
        "deprecated": false,
        "summary": "Teams > Team > Projects",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    },
    "Webhooks > Teams > Team > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/update`",
        "deprecated": false,
        "summary": "Teams > Team > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > BlockedPeriod > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/blocked_period/create`",
        "deprecated": false,
        "summary": "Timeoff > BlockedPeriod > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_blocked_periods_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > BlockedPeriod > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/blocked_period/delete`",
        "deprecated": false,
        "summary": "Timeoff > BlockedPeriod > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_blocked_periods_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > BlockedPeriod > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/blocked_period/update`",
        "deprecated": false,
        "summary": "Timeoff > BlockedPeriod > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_blocked_periods_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > LeaveType > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave_type/create`",
        "deprecated": false,
        "summary": "Timeoff > LeaveType > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave_type"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > LeaveType > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave_type/update`",
        "deprecated": false,
        "summary": "Timeoff > LeaveType > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave_type"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Approves": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/approve`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Approves",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Bulk deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/bulk_delete`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Bulk deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/create`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/delete`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Rejects": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/reject`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Rejects",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Leave > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/update`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Policy > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/policy/create`",
        "deprecated": false,
        "summary": "Timeoff > Policy > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Policy > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/policy/delete`",
        "deprecated": false,
        "summary": "Timeoff > Policy > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Timeoff > Policy > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/policy/update`",
        "deprecated": false,
        "summary": "Timeoff > Policy > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_policy"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Category > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/category/create`",
        "deprecated": false,
        "summary": "Trainings > Category > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_category"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Category > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/category/delete`",
        "deprecated": false,
        "summary": "Trainings > Category > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_category"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Category > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/category/update`",
        "deprecated": false,
        "summary": "Trainings > Category > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_category"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Bulk deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/bulk_delete`",
        "deprecated": false,
        "summary": "Trainings > Training > Bulk deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Bulk update catalogs": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/bulk_update_catalog`",
        "deprecated": false,
        "summary": "Trainings > Training > Bulk update catalogs",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/create`",
        "deprecated": false,
        "summary": "Trainings > Training > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/delete`",
        "deprecated": false,
        "summary": "Trainings > Training > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/update`",
        "deprecated": false,
        "summary": "Trainings > Training > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > Trainings > Training > Update statuses": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/update_status`",
        "deprecated": false,
        "summary": "Trainings > Training > Update statuses",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/trainings_training"
              }
            }
          }
        }
      }
    },
    "Webhooks > WorkSchedule > Schedule > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `work_schedule/schedule/create`",
        "deprecated": false,
        "summary": "WorkSchedule > Schedule > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/work_schedule_schedule"
              }
            }
          }
        }
      }
    },
    "Webhooks > WorkSchedule > Schedule > Toggle archives": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `work_schedule/schedule/toggle_archive`",
        "deprecated": false,
        "summary": "WorkSchedule > Schedule > Toggle archives",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/work_schedule_schedule"
              }
            }
          }
        }
      }
    },
    "Webhooks > WorkSchedule > Schedule > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `work_schedule/schedule/update`",
        "deprecated": false,
        "summary": "WorkSchedule > Schedule > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/work_schedule_schedule"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "tags": [
    {
      "name": "Timeoff > Leave",
      "description": "A time off leave — one employee's request to be absent for a date range (or part of a day) under a given leave type. Its `approved` status is tri-state — null while the request is pending, true once approved, false once rejected."
    }
  ],
  "paths": {
    "/api/2026-10-01/resources/timeoff/leaves/approve": {
      "post": {
        "tags": [
          "Timeoff > Leave"
        ],
        "security": [
          {
            "oauth2": [
              "time_off"
            ]
          },
          {
            "apikey": []
          }
        ],
        "description": "Allows authorized users to approve employee time-off requests by approving the corresponding approval flow if it exists",
        "summary": "Approves a Leave",
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/timeoff_leave"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "id"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Identifier of the Leave",
                    "example": "1"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      },
      "apikey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    },
    "schemas": {
      "api_public_webhook_subscription": {
        "type": "object",
        "required": [
          "id",
          "target_url",
          "type",
          "company_id",
          "enabled",
          "api_version"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the webhook subscription",
            "example": "1"
          },
          "target_url": {
            "type": "string",
            "description": "URL where the webhook payload will be sent",
            "example": "https://webhook.site/"
          },
          "type": {
            "type": "string",
            "description": "Type of the webhook subscription",
            "example": "ats/job_posting/create"
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier of the webhook subscription",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the webhook subscription",
            "example": "Webhook subscription of a job posting created"
          },
          "challenge": {
            "type": "string",
            "description": "String to verify the subscription",
            "example": "2bca4e6d-9aaf-4f11-9e5d"
          },
          "enabled": {
            "type": "boolean",
            "description": "Boolean to enable/disable the subscription",
            "example": true
          },
          "api_version": {
            "type": "string",
            "description": "API version of the webhook subscription that determines the schema of the payload",
            "example": "2026-07-01"
          }
        }
      },
      "ats_application": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "ats_job_posting_id",
          "ats_candidate_id",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Id of the application",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company id of the application",
            "example": "1"
          },
          "ats_job_posting_id": {
            "type": "string",
            "description": "Job posting id of the application",
            "example": "1"
          },
          "ats_candidate_id": {
            "type": "string",
            "description": "Candidate id of the application",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "Employee id of the application",
            "example": "1"
          },
          "phone": {
            "type": "string",
            "description": "Candidate phone of the application",
            "example": "34612345678"
          },
          "qualified": {
            "type": "boolean",
            "description": "Qualified of the application",
            "example": true
          },
          "ats_application_phase_id": {
            "type": "string",
            "description": "Application phase id",
            "example": "1"
          },
          "created_at": {
            "type": "string",
            "description": "Application created at date",
            "example": "2024-08-19T14:30:00.000Z"
          },
          "cover_letter": {
            "type": "string",
            "description": "Application cover letter",
            "example": "This is my cover letter for the position"
          },
          "cv": {
            "type": "object",
            "description": "CV file attachment of the application (includes filename, url, byte_size, content_type, created_at)",
            "properties": {
              "filename": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "byte_size": {
                "type": "integer"
              },
              "content_type": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "filename",
              "url",
              "byte_size",
              "content_type"
            ]
          },
          "ats_conversation_id": {
            "type": "string",
            "description": "Application conversation id",
            "example": "1"
          },
          "medium": {
            "type": "string",
            "description": "Application medium",
            "example": "medium"
          },
          "rating_average": {
            "type": "integer",
            "description": "Application average rating",
            "example": 1
          },
          "ats_rejection_reason_id": {
            "type": "string",
            "description": "Application rejection reason id",
            "example": "1"
          },
          "source_id": {
            "type": "string",
            "description": "Application source id",
            "example": "1"
          }
        }
      },
      "ats_candidate": {
        "type": "object",
        "required": [
          "id",
          "first_name",
          "last_name",
          "full_name",
          "talent_pool",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "identifier of the candidate.",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "company identifier.",
            "example": "1"
          },
          "first_name": {
            "type": "string",
            "description": "name of the candidate.",
            "example": "Ana"
          },
          "last_name": {
            "type": "string",
            "description": "last name of the candidate.",
            "example": "Fernandez Perez"
          },
          "full_name": {
            "type": "string",
            "description": "full name of the candidate.",
            "example": "Ana Fernandez Perez"
          },
          "email": {
            "type": "string",
            "description": "email of the candidate.",
            "example": "ana@factorial.com"
          },
          "talent_pool": {
            "type": "boolean",
            "description": "is the candidate part of talent pool?",
            "example": true
          },
          "phone_number": {
            "type": "string",
            "description": "phone number of the candidate.",
            "example": 645786980
          },
          "created_at": {
            "type": "string",
            "description": "creation date of the candidate.",
            "example": "2021-01-01T00:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "description": "last update of the candidate.",
            "example": "2021-01-01T00:00:00Z"
          },
          "consent_given_at": {
            "type": "string",
            "description": "date when the consent was given.",
            "example": "2021-01-01T00:00:00Z"
          },
          "inactive_since": {
            "type": "string",
            "description": "date when the candidate became inactive.",
            "example": "2021-01-01T00:00:00Z"
          },
          "ats_job_posting_ids": {
            "type": "array",
            "description": "list of job posting identifiers.",
            "example": [
              "1",
              "2",
              "3"
            ],
            "items": {
              "type": "string"
            }
          },
          "personal_url": {
            "type": "string",
            "description": "personal web resource from the candidate.",
            "example": "https://anaperez.factorial.com"
          },
          "consent_expiration_date": {
            "type": "string",
            "description": "date when the consent expires.",
            "example": "2021-01-01T00:00:00Z"
          },
          "consent_to_talent_pool": {
            "type": "boolean",
            "description": "consent to talent pool.",
            "example": true
          },
          "medium": {
            "type": "string",
            "description": "specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.",
            "example": "email"
          },
          "source_id": {
            "type": "string",
            "description": "candidate source identifier, refers to ats/candidate_sources endpoint.",
            "example": "1"
          },
          "gender": {
            "type": "string",
            "description": "gender of the candidate.",
            "enum": [
              "female",
              "male",
              "unanswered",
              "other"
            ],
            "example": "female"
          },
          "score": {
            "type": "number",
            "description": "score of the candidate.",
            "example": 7
          }
        }
      },
      "ats_evaluation_form": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "name",
          "questions",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Id of the evaluation form.",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Id of the company that the evaluation form belongs to.",
            "example": "1"
          },
          "ats_job_posting_id": {
            "type": "string",
            "description": "Id of the job posting that the evaluation form is associated with.",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the evaluation form.",
            "example": "Technical Evaluation"
          },
          "based_on_id": {
            "type": "string",
            "description": "Id of the evaluation form that this evaluation form is related.",
            "example": "1"
          },
          "questions": {
            "type": "array",
            "description": "List of questions in the evaluation form.",
            "example": [
              {
                "id": 1,
                "text": "What is your experience with Ruby on Rails?",
                "description": "experience in years"
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "text"
              ]
            }
          },
          "created_at": {
            "type": "string",
            "description": "date and time when the evaluation form was created.",
            "example": "2021-01-01T00:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "description": "date and time when the evaluation form was last updated.",
            "example": "2021-01-01T00:00:00Z"
          }
        }
      },
      "ats_job_posting": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "ats_company_id",
          "title",
          "remote",
          "status",
          "cv_requirement",
          "cover_letter_requirement",
          "phone_requirement",
          "photo_requirement",
          "personal_url_requirement",
          "salary_period",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the job posting",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier of the company associated with the job posting",
            "example": "1"
          },
          "ats_company_id": {
            "type": "string",
            "description": "Identifier of the ATS company associated with the job posting",
            "example": "1"
          },
          "title": {
            "type": "string",
            "description": "Title of the job posting",
            "example": "My job title"
          },
          "description": {
            "type": "string",
            "description": "Description of the job posting",
            "example": "My job description"
          },
          "contract_type": {
            "type": "string",
            "enum": [
              "indefinite",
              "temporary",
              "intern",
              "training",
              "freelance",
              "vendor_contractor",
              "volunteer",
              "per_hour",
              "other",
              "alternant",
              "interim",
              "minijob",
              "werkstudent",
              "apprenticeship",
              "pj",
              "clt",
              "jovem_aprendiz",
              "a_termo_incerto",
              "a_termo_certo",
              "de_curta_duracao",
              "de_muita_curta_duracao",
              "promessa_de_trabalho",
              "a_tempo_parcial",
              "com_pluralidade_de_empregadores",
              "teletrabalho",
              "pre_reforma",
              "recibos_verdes",
              "estagio",
              "sem_termo",
              "apprentissage",
              "fixed_discontinued",
              "apprendistato"
            ],
            "example": "indefinite"
          },
          "category": {
            "type": "string",
            "enum": [
              "administration_and_secretariat",
              "design_and_architecture",
              "education_and_social_policy",
              "engineering",
              "finance",
              "hr",
              "it",
              "legal",
              "management_and_consulting",
              "marketing_and_communication",
              "nursing_and_therapy",
              "physicians",
              "public_sector",
              "purchasing_materials_administration_and_logistics",
              "sales",
              "sciences_and_research",
              "service_industry_and_manufacturing",
              "sports_art_and_creative_jobs",
              "other"
            ],
            "example": "engineering"
          },
          "workplace_type": {
            "type": "string",
            "enum": [
              "onsite",
              "remote",
              "hybrid"
            ],
            "example": "onsite"
          },
          "remote": {
            "type": "boolean",
            "description": "Indicates if the job posting is remote",
            "example": true
          },
          "status": {
            "type": "string",
            "description": "The current status of the job posting (e.g., draft, published, archived)",
            "enum": [
              "draft",
              "published",
              "unlisted",
              "archived",
              "cancelled",
              "deleted"
            ],
            "example": "draft"
          },
          "schedule_type": {
            "type": "string",
            "description": "The schedule type of the job posting (e.g., full_time, part_time)",
            "enum": [
              "full_time",
              "part_time"
            ],
            "example": "full_time"
          },
          "team_id": {
            "type": "string",
            "description": "Identifier of the team associated with the job posting",
            "example": "1"
          },
          "location_id": {
            "type": "string",
            "description": "Identifier of the location associated with the job posting",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "Identifier of the legal entity associated with the job posting",
            "example": "1"
          },
          "salary_format": {
            "type": "string",
            "description": "The format of the salary (e.g., range, fixed_amount)",
            "enum": [
              "fixed_amount",
              "range"
            ],
            "example": "range"
          },
          "salary_from_amount_in_cents": {
            "type": "integer",
            "description": "The minimum salary amount in cents",
            "example": 3000000
          },
          "salary_to_amount_in_cents": {
            "type": "integer",
            "description": "The maximum salary amount in cents",
            "example": 5000000
          },
          "hide_salary": {
            "type": "boolean",
            "description": "Indicates whether the salary information for the job posting should be hidden from applicants.",
            "example": false
          },
          "cv_requirement": {
            "type": "string",
            "description": "Requirement for the CV (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "mandatory"
          },
          "cover_letter_requirement": {
            "type": "string",
            "description": "Requirement for the cover letter (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "optional"
          },
          "phone_requirement": {
            "type": "string",
            "description": "Requirement for the phone number (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "photo_requirement": {
            "type": "string",
            "description": "Requirement for the phone number (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "personal_url_requirement": {
            "type": "string",
            "description": "Requirement for the personal URL (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "url": {
            "type": "string",
            "description": "If published, the public URL of the job posting. Otherwise will be null",
            "example": "https://my-factorial-domain/job_posting/job-title-slug"
          },
          "salary_period": {
            "type": "string",
            "description": "The period of the salary (e.g., annual, monthly, daily)",
            "enum": [
              "annual",
              "monthly",
              "daily"
            ],
            "example": "annual"
          },
          "published_at": {
            "type": "string",
            "description": "Published date in ISO 8601 format of the job. If never been published the value will be null",
            "example": "2024-07-02T08:28:00.000Z"
          },
          "created_at": {
            "type": "string",
            "description": "Date in ISO 8601 format when the job posting was created",
            "example": "2024-07-10T13:30:02.000Z"
          }
        }
      },
      "attendance_shift": {
        "type": "object",
        "required": [
          "id",
          "employee_id",
          "date",
          "reference_date",
          "created_at",
          "company_id",
          "updated_at",
          "minutes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the shift",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "Identifier for the employee assigned to the shift",
            "example": "1"
          },
          "date": {
            "type": "string",
            "description": "Date of the shift",
            "example": "2023-10-01"
          },
          "reference_date": {
            "type": "string",
            "description": "The business day this shift is attributed to; can differ from `date` for overnight shifts that cross midnight",
            "example": "2023-09-30"
          },
          "clock_in": {
            "type": "string",
            "description": "Time when the employee clocked in",
            "example": "08:30"
          },
          "clock_out": {
            "type": "string",
            "description": "Time when the employee clocked out",
            "example": "12:30"
          },
          "in_source": {
            "type": "string",
            "description": "Source of the clock-in time",
            "example": "automatic"
          },
          "out_source": {
            "type": "string",
            "description": "Source of the clock-out time",
            "example": "automatic"
          },
          "observations": {
            "type": "string",
            "description": "Additional observations about the shift",
            "example": "Employee arrived late due to traffic"
          },
          "location_type": {
            "type": "string",
            "description": "Type of location for the shift",
            "enum": [
              "office",
              "business_trip",
              "work_from_home"
            ],
            "example": "office"
          },
          "half_day": {
            "type": "string",
            "description": "Which half of the day the shift covers when it is a half-day — `beginning_of_day` or `end_of_day`; null for full-day shifts",
            "enum": [
              "beginning_of_day",
              "end_of_day"
            ],
            "example": "beginning_of_day"
          },
          "in_location_latitude": {
            "type": "number",
            "description": "Latitude of the clock-in location",
            "example": 37.7749
          },
          "in_location_longitude": {
            "type": "number",
            "description": "Longitude of the clock-in location",
            "example": -122.419
          },
          "in_location_accuracy": {
            "type": "number",
            "description": "Accuracy of the clock-in location",
            "example": 5
          },
          "out_location_latitude": {
            "type": "number",
            "description": "Latitude of the clock-out location",
            "example": 37.7749
          },
          "out_location_longitude": {
            "type": "number",
            "description": "Longitude of the clock-out location",
            "example": -122.419
          },
          "out_location_accuracy": {
            "type": "number",
            "description": "Accuracy of the clock-out location",
            "example": 5.7
          },
          "workable": {
            "type": "boolean",
            "description": "Whether the shift counts as worked (workable) time rather than a break",
            "example": true
          },
          "created_at": {
            "type": "string",
            "description": "Timestamp when the shift record was created",
            "example": "2023-10-01T08:00:00.000Z"
          },
          "workplace_id": {
            "type": "string",
            "description": "Identifier for the location",
            "example": "1"
          },
          "time_settings_break_configuration_id": {
            "type": "string",
            "description": "Identifier for the break configuration",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier for the company",
            "example": "1"
          },
          "updated_at": {
            "type": "string",
            "description": "Timestamp when the shift record was updated",
            "example": "2023-10-01T08:00:00.000Z"
          },
          "minutes": {
            "type": "integer",
            "description": "Number in minutes of the shift",
            "example": 240
          },
          "clock_in_with_seconds": {
            "type": "string",
            "description": "Clock in time with seconds",
            "example": "08:30:15"
          }
        }
      },
      "bookkeepers_management_incidence": {
        "type": "object",
        "required": [
          "id",
          "legal_entity_id",
          "name",
          "target_id",
          "target_type",
          "status",
          "company_id",
          "created_at",
          "is_reopened"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "identifier of the incidence (aka employee update).",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "identifier of employee related.",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "identifier of legal entity related.",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "name of the incidence (aka employee update). It also represent the incidence type. For example a new hire incidence will be",
            "example": "hiring"
          },
          "custom_name": {
            "type": "string"
          },
          "target_id": {
            "type": "string",
            "description": "The incidence (aka employee update) is also related to a another resource, for example for a leave target, the target identifier will be the leave id.",
            "example": "1"
          },
          "target_type": {
            "type": "string",
            "description": "The incidence (aka employee update) is also related to a another resource, for example a leave. This is the target type. The other types are Employee, Contracts::ContractVersion, BookkeepersManagement::ManualIncidence, Finance::CostCenterMembership.",
            "example": "Timeoff::Leave"
          },
          "starts_on": {
            "type": "string",
            "description": "The date the incidence (aka employee update) starts.",
            "example": "2020-01-01"
          },
          "ends_on": {
            "type": "string",
            "description": "The date the incidence (aka employee update) end.",
            "example": "2020-01-01"
          },
          "read_at": {
            "type": "string",
            "description": "The date the incidence (aka employee update) was read.",
            "example": "2020-01-01"
          },
          "status": {
            "type": "string"
          },
          "company_id": {
            "type": "string",
            "description": "identifier of company related.",
            "example": "1"
          },
          "message_from": {
            "type": "string",
            "description": "Indicate the message sender on the incidence (aka employee update). It can be any of 'bookkeeper', 'admin'",
            "example": "admin"
          },
          "has_message": {
            "type": "boolean",
            "description": "Boolean that indicates if the incidence (aka employee update) has unread messages.",
            "example": true
          },
          "created_at": {
            "type": "string",
            "description": "Date in which incidence (aka employee update) was created.",
            "example": true
          },
          "is_reopened": {
            "type": "boolean",
            "description": "Boolean that indicates if the incidence (aka employee update) has been reopened.",
            "example": true
          },
          "legal_entity_name": {
            "type": "string"
          },
          "employee_first_name": {
            "type": "string"
          },
          "employee_last_name": {
            "type": "string"
          }
        }
      },
      "companies_legal_entity": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "country",
          "legal_name",
          "currency"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "identifier of the legal entity",
            "example": "754"
          },
          "company_id": {
            "type": "string",
            "description": "company identifier",
            "example": "1"
          },
          "country": {
            "type": "string",
            "description": "Country code of the jurisdiction the legal entity is registered in (lowercase two-letter code, e.g. \"es\").",
            "example": "es"
          },
          "legal_name": {
            "type": "string",
            "description": "Legal name of the legal entity",
            "example": "Acme Inc."
          },
          "currency": {
            "type": "string",
            "description": "The currency code in ISO 4217 format",
            "example": "EUR"
          },
          "tin": {
            "type": "string",
            "description": "Tax identification number",
            "example": "H41192410"
          },
          "siret": {
            "type": "string",
            "description": "SIRET number (France-specific). System for identifying French establishments. 14-digit identifier for each French establishment.",
            "example": "12345678901234"
          },
          "city": {
            "type": "string",
            "description": "City of the legal entity",
            "example": "Barcelona"
          },
          "state": {
            "type": "string",
            "description": "State of the legal entity",
            "example": "Barcelona"
          },
          "postal_code": {
            "type": "string",
            "description": "Postal code of the legal entity",
            "example": "08005"
          },
          "address_line_1": {
            "type": "string",
            "description": "Address line 1 of the legal entity",
            "example": "Carrer Mallorca"
          },
          "address_line_2": {
            "type": "string",
            "description": "Address line 2 of the legal entity",
            "example": "61 2A"
          }
        }
      },
      "contracts_contract_version": {
        "type": "object",
        "required": [
          "company_id",
          "employee_id",
          "effective_on",
          "has_payroll",
          "bank_holiday_treatment",
          "created_at",
          "updated_at",
          "fr_forfait_jours"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "identifier for the contract version.",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "identifier for company.",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "employee identifier, refers to /employees/employees endpoint.",
            "example": "1"
          },
          "effective_on": {
            "type": "string",
            "description": "the day the specific contract starts, in case of hiring the same than starts_on.",
            "example": "2024-10-06"
          },
          "country": {
            "type": "string",
            "description": "nationality country code of the employee (Spain ES, United Kingdom GB).",
            "example": "es"
          },
          "contracts_contract_id": {
            "type": "string",
            "description": "contract identifier, refers to the /contracts/contracts endpoint. Use it to read the contract this version belongs to, and its activity periods.",
            "example": "1"
          },
          "job_title": {
            "type": "string",
            "description": "job title of the employee.",
            "example": "Designer"
          },
          "job_catalog_level_id": {
            "type": "string",
            "description": "job catalog level identifier, refers to /job_catalog/levels endpoint.",
            "example": "1"
          },
          "job_catalog_tree_node_uuid": {
            "type": "string",
            "description": "the uuid node in the job catalog tree. For now it only supports level nodes. From this point in the job catalog tree you can get the full ancestor path to the root node including the role. Refer to job_catalog/tree_nodes endpoint.",
            "example": "jobcatalog_treelevel-14"
          },
          "starts_on": {
            "type": "string",
            "description": "the day the employee is hired.",
            "example": "2024-10-06"
          },
          "ends_on": {
            "type": "string",
            "description": "the day the employee is terminated. It has nothing to do with trial period, these are concepts totally unrelated.",
            "example": "2024-10-06"
          },
          "has_payroll": {
            "type": "boolean",
            "description": "boolean that indicates if the employee asociated to this contract belongs to a payroll policy.",
            "example": false
          },
          "has_trial_period": {
            "type": "boolean",
            "description": "a flag that indicates if the contract version has ever had a trial period.",
            "example": false
          },
          "trial_period_ends_on": {
            "type": "string",
            "description": "when the trial period ends. If there is no date, it means that the employee has never been in trial. This date is not related with the end date of a contract.",
            "example": "2024-10-06"
          },
          "salary_amount": {
            "type": "integer",
            "description": "the amount of money the employee earns in cents.",
            "example": 1000
          },
          "salary_currency": {
            "type": "string",
            "description": "the currency of the salary amount, inherited from the governing legal entity.",
            "example": "EUR"
          },
          "salary_frequency": {
            "type": "string",
            "description": "the frequency of the salary payment.",
            "example": "yearly"
          },
          "working_week_days": {
            "type": "string",
            "description": "the days of the week the employee works.",
            "example": "monday,tuesday,wednesday,thursday,friday"
          },
          "working_hours": {
            "type": "integer",
            "description": "the amount of hours the employee works.",
            "example": 40
          },
          "working_hours_frequency": {
            "type": "string",
            "description": "the frequency of the working hours.",
            "example": "week"
          },
          "max_legal_yearly_hours": {
            "type": "integer",
            "description": "the maximum amount of hours the employee can work in a year.",
            "example": 2000
          },
          "maximum_weekly_hours": {
            "type": "integer",
            "description": "the maximum amount of hours the employee can work in a week.",
            "example": 40
          },
          "bank_holiday_treatment": {
            "type": "string",
            "description": "Defines whether a bank holiday should be considered as a workable or non-workable day.",
            "enum": [
              "workable",
              "non_workable"
            ],
            "example": "workable"
          },
          "working_time_percentage_in_cents": {
            "type": "integer",
            "description": "Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).",
            "example": 8000
          },
          "annual_working_time_distribution": {
            "type": "string",
            "description": "Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.",
            "enum": [
              "limit_workdays",
              "limit_daily_hours"
            ],
            "example": "limit_workdays"
          },
          "version_data": {
            "type": "object",
            "description": "Country-specific contract data (template fragments and fields).",
            "example": {
              "country_data": {
                "country": "es",
                "fields": [
                  {
                    "name": "contract_type",
                    "field_name": "Tipo de contrato",
                    "value_label": "Indefinido",
                    "value_id": "1"
                  },
                  {
                    "name": "working_hours",
                    "field_name": "working_hours",
                    "value_label": "40",
                    "value_id": "40"
                  }
                ],
                "template_fragments": {
                  "company_fragment_id": "1",
                  "country_fragment_id": "2",
                  "legal_entity_fragment_id": "3"
                }
              }
            },
            "properties": {
              "country_data": {
                "type": "object",
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Country code (e.g. es, fr, de, pt)."
                  },
                  "fields": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "field_name": {
                          "type": "string"
                        },
                        "value_label": {
                          "type": "string"
                        },
                        "value_id": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "field_name",
                        "value_id"
                      ]
                    }
                  },
                  "template_fragments": {
                    "type": "object",
                    "description": "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).\n",
                    "properties": {
                      "company_fragment_id": {
                        "type": "string"
                      },
                      "country_fragment_id": {
                        "type": "string"
                      },
                      "legal_entity_fragment_id": {
                        "type": "string"
                      }
                    }
                  }
                },
                "required": [
                  "country",
                  "fields",
                  "template_fragments"
                ]
              }
            }
          },
          "min_rest_minutes_between_days": {
            "type": "integer",
            "description": "the minimum amount of minutes the employee must rest between working periods.",
            "example": 2880
          },
          "max_work_minutes_per_day": {
            "type": "integer",
            "description": "the maximum amount of minutes the employee can work in a day.",
            "example": 480
          },
          "max_work_days_in_row": {
            "type": "integer",
            "description": "the maximum amount of days the employee can work in a row.",
            "example": 6
          },
          "min_rest_hours_in_row": {
            "type": "integer",
            "description": "the minimum amount of hours the employee must rest in a row.",
            "example": 36
          },
          "created_at": {
            "type": "string",
            "description": "the date the contract version was created.",
            "example": "2024-10-06T00:00:00.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "the date of the last contract version updated.",
            "example": "2024-10-06T00:00:00.000Z"
          },
          "es_has_teleworking_contract": {
            "type": "boolean",
            "description": "flag that indicates if the contract has teleworking.",
            "example": false
          },
          "es_cotization_group": {
            "type": "integer",
            "description": "the group of cotization of the employee.",
            "example": 1
          },
          "contracts_es_tariff_group_id": {
            "type": "string",
            "description": "the group of cotization of the employee.",
            "example": "1"
          },
          "es_contract_observations": {
            "type": "string",
            "description": "observations of the contract.",
            "example": "review contract for job promotion"
          },
          "es_job_description": {
            "type": "string",
            "description": "the job description of the employee.",
            "example": "Designer"
          },
          "es_contract_type_id": {
            "type": "string",
            "description": "contract type identifier.",
            "example": "1"
          },
          "es_working_day_type_id": {
            "type": "string",
            "description": "working day type identifier.",
            "example": "1"
          },
          "es_education_level_id": {
            "type": "string",
            "description": "education level identifier.",
            "example": "1"
          },
          "es_professional_category_id": {
            "type": "string",
            "description": "professional category identifier.",
            "example": "1"
          },
          "fr_employee_type": {
            "type": "string",
            "description": "employee type.",
            "example": "apprenti"
          },
          "fr_forfait_jours": {
            "type": "boolean",
            "description": "flag that indicates if the employee is allowed to work within the framework of a fixed number of days.",
            "example": false
          },
          "fr_jours_par_an": {
            "type": "integer",
            "description": "the number of days the employee is allowed to work.",
            "example": 200
          },
          "fr_coefficient": {
            "type": "string",
            "description": "coefficient for france contracts.",
            "example": "1"
          },
          "fr_contract_type_id": {
            "type": "string",
            "description": "contract type identifier.",
            "example": "1"
          },
          "fr_level_id": {
            "type": "string",
            "description": "level identifier.",
            "example": "1"
          },
          "fr_step_id": {
            "type": "string",
            "description": "step identifier.",
            "example": "1"
          },
          "fr_mutual_id": {
            "type": "string",
            "description": "mutual identifier.",
            "example": "1"
          },
          "fr_professional_category_id": {
            "type": "string",
            "description": "professional category identifier.",
            "example": "1"
          },
          "fr_work_type_id": {
            "type": "string",
            "description": "work type identifier.",
            "example": "1"
          },
          "de_contract_type_id": {
            "type": "string",
            "description": "contract type identifier.",
            "example": "1"
          },
          "de_base_salary_type_id": {
            "type": "string",
            "description": "Identifier for the German base salary type. References a payroll concept available via the /payroll/concepts endpoint.",
            "example": "1"
          },
          "pt_contract_type_id": {
            "type": "string",
            "description": "contract type identifier.",
            "example": "1"
          }
        }
      },
      "custom_resources_schema": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id",
          "hidden"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Schema identifier",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Schema name",
            "example": "Company Offsite"
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier where this schema belongs",
            "example": "2"
          },
          "hidden": {
            "type": "boolean",
            "description": "Manages visibility of the schema",
            "example": false
          },
          "position": {
            "type": "integer",
            "description": "Schema position within employee profile",
            "example": 1
          }
        }
      },
      "documents_document": {
        "type": "object",
        "required": [
          "created_at",
          "filename",
          "id",
          "public",
          "space",
          "updated_at"
        ],
        "properties": {
          "author_id": {
            "type": "string",
            "description": "access identifier of the author, refers to /employees/employees endpoint.",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "company identifier, refers to /api/me endpoint.",
            "example": "1"
          },
          "content_type": {
            "type": "string",
            "description": "document content type.",
            "example": "application/pdf"
          },
          "created_at": {
            "type": "string",
            "description": "creation date of the document.",
            "example": "2020-01-01T00:00:00Z"
          },
          "employee_id": {
            "type": "string",
            "description": "employee identifier associated to the document.",
            "example": "1"
          },
          "extension": {
            "type": "string",
            "description": "document extension.",
            "example": "pdf"
          },
          "file_size": {
            "type": "integer",
            "description": "document file size in bytes.",
            "example": 1024
          },
          "filename": {
            "type": "string",
            "description": "name of the document.",
            "example": "document.pdf"
          },
          "folder_id": {
            "type": "string",
            "description": "folder identifier, references to documents/folders endpoint.",
            "example": "1"
          },
          "id": {
            "type": "string",
            "description": "document identifier.",
            "example": "1"
          },
          "is_company_document": {
            "type": "boolean",
            "description": "flag that indicates if the document is a company document.",
            "example": true
          },
          "is_management_document": {
            "type": "boolean",
            "description": "flag that indicates if the document is a management document.",
            "example": true
          },
          "is_pending_assignment": {
            "type": "boolean",
            "description": "flag that indicates if the document is pending assignment.",
            "example": true
          },
          "leave_id": {
            "type": "string",
            "description": "leave identifier associated to the document, refers to /timeoff/leaves endpoint.",
            "example": "1"
          },
          "public": {
            "type": "boolean",
            "description": "flag to indicate if the document is public.",
            "example": true
          },
          "signature_status": {
            "type": "string",
            "description": "document signature status.",
            "enum": [
              "pending",
              "partially_signed",
              "declined",
              "completed",
              "bounced_email",
              "cancelled",
              "error",
              "expired"
            ],
            "example": "pending"
          },
          "signees": {
            "type": "array",
            "description": "list of signee access identifiers associated to the document, refers to /employees/employees endpoint.",
            "items": {
              "type": "string"
            }
          },
          "space": {
            "type": "string",
            "description": "document space.",
            "example": "company_public"
          },
          "updated_at": {
            "type": "string",
            "description": "last update date of the document.",
            "example": "2020-01-01T00:00:00Z"
          },
          "deleted_at": {
            "type": "string",
            "description": "deletion date of the document.",
            "example": "2020-01-01T00:00:00Z"
          }
        }
      },
      "documents_folder": {
        "type": "object",
        "required": [
          "active",
          "id",
          "name",
          "space"
        ],
        "properties": {
          "active": {
            "type": "boolean",
            "description": "Whether the folder is active or not",
            "example": true
          },
          "company_id": {
            "type": "string",
            "description": "Company ID of the folder",
            "example": "1"
          },
          "id": {
            "type": "string",
            "description": "Folder ID",
            "example": "10"
          },
          "name": {
            "type": "string",
            "description": "Folder name",
            "example": "Payslips"
          },
          "parent_folder_id": {
            "type": "string",
            "description": "Id of the parent folder",
            "example": "23"
          },
          "space": {
            "type": "string",
            "description": "The space of the folder is related to the place where the folder is displayed."
          }
        }
      },
      "employees_employee": {
        "type": "object",
        "required": [
          "id",
          "access_id",
          "first_name",
          "last_name",
          "full_name",
          "company_id",
          "location_id",
          "created_at",
          "updated_at",
          "is_terminating",
          "attendable"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "id of the employee.",
            "example": "2"
          },
          "access_id": {
            "type": "string",
            "description": "access_id associated to the employee.",
            "example": "1"
          },
          "first_name": {
            "type": "string",
            "description": "name of the employee.",
            "example": "Ana"
          },
          "last_name": {
            "type": "string",
            "description": "last name of the employee.",
            "example": "Blanco Perez"
          },
          "full_name": {
            "type": "string",
            "description": "full name of the employee.",
            "example": "Ana Blanco Perez"
          },
          "preferred_name": {
            "type": "string",
            "description": "nickname of the employee or a name that defines the employee better.",
            "example": "Anita"
          },
          "birth_name": {
            "type": "string",
            "description": "Birthname of the employee.",
            "example": "Anna"
          },
          "gender": {
            "type": "string",
            "description": "gender of the employee (male | female).",
            "example": "female"
          },
          "identifier": {
            "type": "string",
            "description": "national identifier number.",
            "example": "QKG587532Y"
          },
          "identifier_type": {
            "type": "string",
            "description": "type of identifier (ex passport).",
            "example": "passport"
          },
          "email": {
            "type": "string",
            "description": "company communications email of the employee (falls back to the login email). Not the personal email.",
            "example": "ana@factorial.com"
          },
          "login_email": {
            "type": "string",
            "description": "email associated to the session.",
            "example": "ana@factorial.com"
          },
          "birthday_on": {
            "type": "string",
            "description": "birthday of the employee.",
            "example": "1990-06-06"
          },
          "nationality": {
            "type": "string",
            "description": "nationality country code of the employee (Spain ES, United Kingdom GB).",
            "example": "es"
          },
          "address_line_1": {
            "type": "string",
            "description": "address of the employee.",
            "example": "Calle Adaro 10 1 A"
          },
          "address_line_2": {
            "type": "string",
            "description": "secondary address of the employee.",
            "example": "Calle Adaro 10 1 A"
          },
          "postal_code": {
            "type": "string",
            "description": "postal code of the employee.",
            "example": "27004"
          },
          "city": {
            "type": "string",
            "description": "city of the employee.",
            "example": "Santander"
          },
          "state": {
            "type": "string",
            "description": "state/province/region of the employee.",
            "example": "Cantabria"
          },
          "country": {
            "type": "string",
            "description": "country code of the employee (Spain ES, United Kingdom GB).",
            "example": "es"
          },
          "bank_number": {
            "type": "string",
            "description": "bank account number of the employee.",
            "example": "ES6220809324751871912999"
          },
          "swift_bic": {
            "type": "string",
            "description": "code to identify banks and financial institutions globally.",
            "example": "CAGLES2M510"
          },
          "bank_number_format": {
            "type": "string",
            "description": "bank number format.",
            "enum": [
              "iban",
              "sort_code_and_account_number",
              "routing_number_and_account_number",
              "clabe",
              "other",
              "bank_name_and_account_number"
            ],
            "example": "iban"
          },
          "company_id": {
            "type": "string",
            "description": "id of the company to which the employee belongs (not editable).",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "legal entity of the employee, references to companies/legal_entities.",
            "example": "1"
          },
          "location_id": {
            "type": "string",
            "description": "location id of the employee, references to locations/locations.",
            "example": "1"
          },
          "default_work_area_id": {
            "type": "string",
            "description": "Default work area ID for the employee at the default workplace. References locations/work_areas.",
            "example": "1"
          },
          "created_at": {
            "type": "string",
            "description": "creation date of the employee.",
            "example": "2010-10-06T00:00:00.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "date of last modification of the employee",
            "example": "2024-10-06T00:00:00.000Z"
          },
          "social_security_number": {
            "type": "string",
            "description": "social security number of the employee.",
            "example": "150126298420"
          },
          "is_terminating": {
            "type": "boolean",
            "description": "is the employee being terminated?",
            "example": false
          },
          "terminated_on": {
            "type": "string",
            "description": "termination date of the employee.",
            "example": "2024-10-06"
          },
          "termination_reason_type": {
            "type": "string",
            "description": "termination reason type of the employee",
            "example": "others"
          },
          "termination_reason": {
            "type": "string",
            "description": "A reason for the termination.",
            "example": "The employee has left the company"
          },
          "termination_observations": {
            "type": "string",
            "description": "observations about the termination.",
            "example": "Ana has been working on this project before she left"
          },
          "manager_id": {
            "type": "string",
            "description": "manager id of the employee, you can get the manager id from employees endpoint.",
            "example": "1"
          },
          "timeoff_manager_id": {
            "type": "string",
            "description": "Timeoff manager id of the employee.",
            "example": "1"
          },
          "phone_number": {
            "type": "string",
            "description": "phone number of the employee.",
            "example": "657483987"
          },
          "company_identifier": {
            "type": "string",
            "description": "identity number or string used inside a company to internally identify the employee.",
            "example": "bb9d281e"
          },
          "age_number": {
            "type": "integer",
            "description": "age of the employee.",
            "example": 30
          },
          "termination_type_description": {
            "type": "string",
            "description": "The description of the termination type.",
            "example": "Baja voluntaria/Dimisión"
          },
          "contact_name": {
            "type": "string",
            "description": "name of the employee contact.",
            "example": "Laura Delgado"
          },
          "contact_number": {
            "type": "string",
            "description": "phone number of the employee contact .",
            "example": "647384950"
          },
          "personal_email": {
            "type": "string",
            "description": "personal (non-corporate) email of the employee, shown as \"Personal email\" in the profile.",
            "example": "ana@factorial.com"
          },
          "seniority_calculation_date": {
            "type": "string",
            "description": "date since when the employee is working in the company.",
            "example": "2024-10-07"
          },
          "communications_email": {
            "type": "string",
            "description": "Confirmed email address for company communications and notifications. Separate from login email, used for internal company announcements.",
            "example": "employee@company.com"
          },
          "unconfirmed_communications_email": {
            "type": "string",
            "description": "unconfirmed communications email address for the employee.",
            "example": "new-email@example.com"
          },
          "pronouns": {
            "type": "string",
            "description": "pronouns that an employee uses to define themselves.",
            "example": "She/Her"
          },
          "active": {
            "type": "boolean",
            "description": "status of the employee, true when active, false when terminated.",
            "example": true
          },
          "disability_percentage_cents": {
            "type": "integer",
            "description": "officially certified level of disability granted by public administration for individuals with physical or mental impairments, expressed in cents",
            "example": 1200
          },
          "identifier_expiration_date": {
            "type": "string",
            "description": "identifier expiration date",
            "example": "2023-12-31"
          },
          "attendable": {
            "type": "boolean",
            "description": "employee included in a time tracking policy.",
            "example": true
          },
          "country_of_birth": {
            "type": "string",
            "description": "Country of birth of the employee.",
            "example": "Spain"
          },
          "birthplace": {
            "type": "string",
            "description": "Birthplace of the employee.",
            "example": "Barcelona"
          }
        }
      },
      "expenses_expensable": {
        "type": "object",
        "required": [
          "id",
          "type",
          "company_id",
          "employee_id",
          "created_at",
          "currency",
          "status",
          "status_updated_at",
          "updated_at",
          "cost_center_ids"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the expensable",
            "example": "1"
          },
          "type": {
            "type": "string",
            "description": "Type of the expensable. Can be either \"expense\" or \"mileage\" or \"perdiem\"",
            "enum": [
              "expense",
              "mileage",
              "perdiem"
            ],
            "example": "expense"
          },
          "company_id": {
            "type": "string",
            "description": "The ID of the company that owns the expensable",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "The ID of the employee that owns the expensable",
            "example": "1"
          },
          "group_id": {
            "type": "string",
            "description": "The ID of the expense report (group of expensables submitted together) this expensable was submitted in, if any",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "The optional ID of the legal entity that the expensable belongs to",
            "example": "1"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the expensable was created",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "amount": {
            "type": "integer",
            "description": "The optional amount in cents",
            "example": 1000
          },
          "currency": {
            "type": "string",
            "description": "The currency code in ISO 4217 format",
            "example": "EUR"
          },
          "status": {
            "type": "string",
            "description": "The lifecycle status of the expensable in the review/payment flow",
            "enum": [
              "pending",
              "changes_requested",
              "approved",
              "paid",
              "rejected",
              "reversed",
              "draft",
              "in_payroll",
              "sent_to_pay"
            ],
            "example": "approved"
          },
          "description": {
            "type": "string",
            "description": "The optional description of the expensable",
            "example": "Dinner with clients"
          },
          "reporter_id": {
            "type": "string",
            "description": "The optional ID of the employee that reported the expensable",
            "example": "1"
          },
          "status_updated_at": {
            "type": "string",
            "description": "The optional date and time when the status was last updated",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "effective_on": {
            "type": "string",
            "description": "The optional date and time when the expensable was effective",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "review_request_at": {
            "type": "string",
            "description": "The date and time the expensable was submitted for review. Null while it is a draft; set at submission and never cleared afterwards. Compare it with `effective_on` to measure how late a document was submitted.",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "paid_at": {
            "type": "string",
            "description": "The optional date and time when the expensable was set as paid",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time when the expensable was last updated",
            "example": "2024-06-06T12:00:00.000Z"
          },
          "reimbursable_amount": {
            "type": "integer",
            "description": "The optional reimbursable amount in cents",
            "example": 1000
          },
          "reimbursable_currency": {
            "type": "string",
            "description": "The optional reimbursable currency code in ISO 4217 format",
            "example": "EUR"
          },
          "reimbursement_method": {
            "type": "string",
            "description": "The optional reimbursement method",
            "enum": [
              "unknown",
              "sepa_transfer",
              "payroll"
            ],
            "example": "sepa_transfer"
          },
          "internal_reference": {
            "type": "string",
            "description": "The optional internal reference of the expensable",
            "example": "REF123"
          },
          "expense_id": {
            "type": "string",
            "description": "The ID of the receipt-backed expense detail record; set only when `type` is \"expense\"",
            "example": "1"
          },
          "mileage_id": {
            "type": "string",
            "description": "The ID of the mileage claim detail record; set only when `type` is \"mileage\"",
            "example": "1"
          },
          "per_diem_id": {
            "type": "string",
            "description": "The ID of the per-diem allowance detail record; set only when `type` is \"perdiem\"",
            "example": "1"
          },
          "budget_id": {
            "type": "string",
            "description": "The ID of the budget this expensable draws from, when one is linked",
            "example": "1"
          },
          "project_id": {
            "type": "string",
            "description": "The ID of the project this expensable is charged to, when one is linked",
            "example": "1"
          },
          "cost_center_ids": {
            "type": "array",
            "description": "The IDs of the cost centers the expensable's cost is allocated to",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "finance_cost_center": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id",
          "active_employees_count",
          "historical_employees_count",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Factorial id of the cost center.",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the cost center.",
            "example": "Marketing"
          },
          "company_id": {
            "type": "string",
            "description": "Company id the cost center belongs to.",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "Legal entity id the cost center belongs to.",
            "example": "125"
          },
          "code": {
            "type": "string",
            "description": "Optional unique code of the cost center.",
            "example": "CC-001"
          },
          "description": {
            "type": "string",
            "description": "Optional free text describing the cost center.",
            "example": "Cost center for the marketing department"
          },
          "active_employees_count": {
            "type": "integer",
            "description": "Number of employees currently assigned to the cost center.",
            "example": 0
          },
          "historical_employees_count": {
            "type": "integer",
            "description": "Number of employees ever assigned to the cost center.",
            "example": 0
          },
          "status": {
            "type": "string",
            "description": "Whether the cost center is active or inactive.",
            "example": "active"
          },
          "deactivation_date": {
            "type": "string",
            "description": "Date the cost center was deactivated, if inactive."
          }
        }
      },
      "locations_location": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "name",
          "main"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the workplace",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company this workplace belongs to",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the workplace (e.g. \"Barcelona Office\")",
            "example": "Barcelona Office"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone the workplace operates in (e.g. \"Europe/Madrid\")",
            "example": "Europe/Madrid"
          },
          "country": {
            "type": "string",
            "description": "ISO country code of the workplace — the jurisdiction it sits in, often used for country-specific policy thresholds",
            "example": "es"
          },
          "state": {
            "type": "string",
            "description": "State or province the workplace is located in",
            "example": "Barcelona"
          },
          "city": {
            "type": "string",
            "description": "City the workplace is located in",
            "example": "Barcelona"
          },
          "address_line_1": {
            "type": "string",
            "description": "First line of the workplace street address",
            "example": "Carrer Mallorca"
          },
          "address_line_2": {
            "type": "string",
            "description": "Second line of the workplace street address (suite, floor, …)",
            "example": "61 2A"
          },
          "postal_code": {
            "type": "string",
            "description": "Postal/ZIP code of the workplace address",
            "example": "08005"
          },
          "phone_number": {
            "type": "string",
            "description": "Contact phone number for the workplace",
            "example": "657483987"
          },
          "main": {
            "type": "boolean",
            "description": "Whether this is the company's main (HQ) workplace",
            "example": false
          },
          "latitude": {
            "type": "number",
            "description": "latitude of the location",
            "example": 52.378
          },
          "longitude": {
            "type": "number",
            "description": "longitude of the location",
            "example": 4.898
          },
          "radius": {
            "type": "number",
            "description": "radius of the location",
            "example": 5
          },
          "siret": {
            "type": "string",
            "description": "siret of the location (only for France)",
            "example": "FR00123456789"
          }
        }
      },
      "payroll_policy_period": {
        "type": "object",
        "required": [
          "id",
          "starts_on",
          "policy_id",
          "company_id",
          "ends_on",
          "period"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Policy period id",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Policy name with start and end date",
            "example": "Policy name example 20 aug - 13 sep"
          },
          "starts_on": {
            "type": "string",
            "description": "The start date of the policy period",
            "example": "2020-01-01"
          },
          "policy_id": {
            "type": "string",
            "description": "The id of the policy associated with the policy period",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "The id of the company",
            "example": "1"
          },
          "ends_on": {
            "type": "string",
            "description": "The start date of the policy period",
            "example": "2020-01-01"
          },
          "period": {
            "type": "string",
            "description": "Period for the policy",
            "example": "20 aug - 13 sep 2021"
          },
          "status": {
            "type": "string",
            "description": "Policy period status",
            "example": "preparation"
          },
          "policy_name": {
            "type": "string",
            "description": "Policy name",
            "example": "Policy name example"
          },
          "calculation_started_at": {
            "type": "string",
            "description": "The date and time the calculation started",
            "example": "2020-01-01"
          }
        }
      },
      "payroll_supplement": {
        "type": "object",
        "required": [
          "id",
          "employee_id",
          "company_id",
          "unit"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The identifier of the supplement",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "The identifier of the employee associated with the supplement",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "The identifier of the company associated with the supplement",
            "example": "1"
          },
          "contracts_compensation_id": {
            "type": "string",
            "description": "The contract compensation identifier associated with the supplement",
            "example": "1"
          },
          "contracts_taxonomy_id": {
            "type": "string",
            "description": "The taxonomy identifier associated with the supplement",
            "example": "2"
          },
          "amount_in_cents": {
            "type": "integer",
            "description": "The amount of the supplement in cents",
            "example": 50000
          },
          "unit": {
            "type": "string",
            "description": "The unit of the supplement",
            "enum": [
              "money",
              "units",
              "time"
            ],
            "example": "money"
          },
          "effective_on": {
            "type": "string",
            "description": "The date on which the supplement becomes effective",
            "example": "2024-01-01"
          },
          "created_at": {
            "type": "unknown",
            "description": "The created at date when the supplement was created",
            "example": "2024-01-01T12:00:00Z"
          },
          "updated_at": {
            "type": "unknown",
            "description": "The last updated at date when the supplement was last updated",
            "example": "2024-01-05T12:00:00Z"
          },
          "description": {
            "type": "string",
            "description": "The description of the supplement",
            "example": "Cantidad fija"
          },
          "payroll_policy_period_id": {
            "type": "string",
            "description": "The payroll policy period identifier associated with the supplement",
            "example": "1"
          },
          "employee_observations": {
            "type": "array",
            "description": "Observations on the employee made by the admin or manager",
            "example": [
              "Worked extra shifts",
              "Bonus for holiday work"
            ],
            "items": {
              "type": "string"
            }
          },
          "raw_minutes_in_cents": {
            "type": "integer",
            "description": "The raw value of minutes in cents associated with the supplement",
            "example": 5000
          },
          "minutes_in_cents": {
            "type": "integer",
            "description": "The value of minutes in cents after adjustments",
            "example": 4800
          },
          "equivalent_minutes_in_cents": {
            "type": "integer",
            "description": "The equivalent value of minutes in cents for payroll processing",
            "example": 4600
          },
          "currency": {
            "type": "string",
            "description": "The currency used for the supplement, typically in ISO 4217 format",
            "example": "EUR"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "The legal entity identifier associated with the supplement",
            "example": "1"
          }
        }
      },
      "payroll_integrations_base_code": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "code",
          "codeable_id",
          "codeable_type",
          "integration"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Code identifier",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company ID where the code belongs to",
            "example": "2"
          },
          "code": {
            "type": "string",
            "description": "Code value",
            "example": "COD-51"
          },
          "codeable_id": {
            "type": "string",
            "description": "Related object ID. Used together with codeable_type",
            "example": "5"
          },
          "codeable_type": {
            "type": "string",
            "description": "Related object type. Used together with codeable_id",
            "example": "Employee | Company | LegalEntity | Location | TimeoffLeaveType"
          },
          "integration": {
            "type": "string",
            "description": "Integration name",
            "enum": [
              "a3innuva",
              "a3nom",
              "agenda",
              "paierh",
              "yeap_paierh",
              "silae",
              "sage100",
              "datev",
              "datev_api",
              "datev_lug_api",
              "datev_lauds",
              "team_system",
              "zucchetti",
              "gispaghe",
              "job_sistemi"
            ],
            "example": "a3innuva"
          }
        }
      },
      "performance_review_process": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "status",
          "start_validation_errors",
          "archived",
          "agreements_configuration",
          "competencies_assessments_configuration"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Review process ID",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company ID",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Review process name",
            "example": "Performance Review - Q1 2024"
          },
          "description": {
            "type": "string",
            "description": "A brief description of the review process",
            "example": "The performance review for the first quarter of 2024 has started!"
          },
          "status": {
            "type": "string",
            "description": "Review process status",
            "enum": [
              "draft",
              "scheduled",
              "starting",
              "active",
              "finished"
            ],
            "example": "draft"
          },
          "target_strategy": {
            "type": "object",
            "description": "Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts",
            "example": {
              "arguments": [],
              "strategy": "all_employees"
            },
            "properties": {
              "strategy": {
                "type": "string",
                "enum": [
                  "all_employees",
                  "by_locations",
                  "by_teams",
                  "by_employees",
                  "manual_selection"
                ]
              },
              "arguments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "strategy"
            ]
          },
          "reviewer_strategies": {
            "type": "array",
            "description": "Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts",
            "enum": [
              "self",
              "manager",
              "direct_reports",
              "peers"
            ],
            "example": [
              "self",
              "manager"
            ],
            "items": {
              "type": "string"
            }
          },
          "starts_at": {
            "type": "string",
            "description": "Date when the review process should start",
            "example": "2024-01-01T00:00:00.000Z"
          },
          "ends_at": {
            "type": "string",
            "description": "Date when the review process should end",
            "example": "2024-04-01T00:00:00.000Z"
          },
          "start_validation_errors": {
            "type": "array",
            "description": "Missing or invalid information to be able to start the review process",
            "enum": [
              "missing_deadline",
              "invalid_deadline",
              "missing_title",
              "missing_target_strategy",
              "missing_target_strategy_members",
              "missing_reviewer_strategy",
              "missing_questions",
              "missing_potential_reviewers",
              "invalid_section_weights_sum"
            ],
            "example": [
              "invalid_deadline",
              "missing_target_strategy_members"
            ],
            "items": {
              "type": "string"
            }
          },
          "archived": {
            "type": "boolean",
            "description": "Whether the review process is archived or not",
            "example": false
          },
          "agreements_configuration": {
            "type": "object",
            "description": "Action plans help track goal progress, and facilitate performance review discussions.",
            "example": {
              "enabled": true
            },
            "properties": {
              "enabled": {
                "type": "boolean"
              },
              "esignature_enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled",
              "esignature_enabled"
            ]
          },
          "competencies_assessments_configuration": {
            "type": "object",
            "description": "Assess employees based on their assigned competencies through both manager and self-reviews. Ensure roles with designated competencies are properly set up.",
            "example": {
              "enabled": false
            },
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ]
          },
          "last_bulk_reminder": {
            "type": "string",
            "description": "Date when the last bulk reminder was sent",
            "example": "2024-03-01T00:00:00.000Z"
          }
        }
      },
      "project_management_time_record": {
        "type": "object",
        "required": [
          "id",
          "project_worker_id",
          "employee_id",
          "project_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Id of the time record",
            "example": "1"
          },
          "project_worker_id": {
            "type": "string",
            "description": "Id of the project worker",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "Id of the employee the time record belongs to",
            "example": "31415"
          },
          "project_id": {
            "type": "string",
            "description": "Id of the project the time record belongs to",
            "example": "28172"
          },
          "attendance_shift_id": {
            "type": "string",
            "description": "Id of the attendance shift",
            "example": "1"
          },
          "subproject_id": {
            "type": "string",
            "description": "Id of the subproject",
            "example": "1"
          },
          "project_task_id": {
            "type": "string",
            "description": "Id of the project task assigned to the time record. Refers to project_management/project_tasks endpoint.",
            "example": "1"
          },
          "date": {
            "type": "string",
            "description": "Reference date of the shift",
            "example": "2021-01-01"
          },
          "imputed_minutes": {
            "type": "integer",
            "description": "Minutes difference between the clock in and clock out",
            "example": 480
          },
          "clock_in": {
            "type": "string",
            "description": "Clock in time",
            "example": "2021-01-01T08:00:00Z"
          },
          "clock_out": {
            "type": "string",
            "description": "Clock out time",
            "example": "2021-01-01T17:00:00Z"
          },
          "observations": {
            "type": "string",
            "description": "Comment for the time record",
            "example": "Comment for the time record"
          }
        }
      },
      "shift_management_shift": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "state",
          "employee_id",
          "start_at",
          "end_at",
          "extra_hours",
          "timezone",
          "local_start_at",
          "local_end_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the shift",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier of the company that owns this shift",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Display name of the shift. If not explicitly set, falls back to the default shift title or template week name",
            "example": "Morning shift"
          },
          "state": {
            "type": "string",
            "description": "Current 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",
            "enum": [
              "draft",
              "published",
              "backup"
            ],
            "example": "draft"
          },
          "location_id": {
            "type": "string",
            "description": "Identifier of the location where the shift takes place. Can be null if the shift uses the employee's default location",
            "example": "3"
          },
          "locations_work_area_id": {
            "type": "string",
            "description": "Identifier of the specific work area within the location where the shift occurs. Work areas allow further subdivision of locations",
            "example": "5"
          },
          "employee_id": {
            "type": "string",
            "description": "Identifier of the employee assigned to this shift",
            "example": "1"
          },
          "start_at": {
            "type": "string",
            "description": "Timestamp indicating when the shift starts",
            "example": "2020-09-07T06:00:00.000+00:00"
          },
          "end_at": {
            "type": "string",
            "description": "Timestamp indicating when the shift ends",
            "example": "2020-09-07T15:00:00.000+00:00"
          },
          "notes": {
            "type": "string",
            "description": "Optional notes or comments about the shift, visible to managers and schedulers",
            "example": "This is a shift note"
          },
          "extra_hours": {
            "type": "boolean",
            "description": "Indicates whether this shift counts as extra hours beyond the employee's regular schedule. Used for overtime calculations",
            "example": false
          },
          "default_shift_title": {
            "type": "string",
            "description": "Title from the default shift template that was used to create this shift, if applicable",
            "example": "Morning shift"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone identifier (e.g., 'Europe/Madrid', 'America/New_York') used to display the shift times in the local timezone",
            "example": "Europe/Madrid"
          },
          "local_start_at": {
            "type": "string",
            "description": "Start time of the shift converted to the local timezone. This is what employees see in their schedule",
            "example": "2020-09-07T08:00:00.000+00:00"
          },
          "local_end_at": {
            "type": "string",
            "description": "End time of the shift converted to the local timezone. This is what employees see in their schedule",
            "example": "2020-09-07T17:00:00.000+00:00"
          }
        }
      },
      "tasks_task": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id",
          "assignee_ids",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the task",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the task",
            "example": "My task"
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier of the author of the task",
            "example": "1"
          },
          "content": {
            "type": "string",
            "description": "Content of the task",
            "example": "Complete your performance review before Friday"
          },
          "due_on": {
            "type": "string",
            "description": "Due on date of the task",
            "example": "2024-06-06"
          },
          "assignee_ids": {
            "type": "array",
            "description": "Employees assigned to the task, assignee_id references to access_id",
            "example": [
              "1"
            ],
            "items": {
              "type": "string"
            }
          },
          "author_employee_id": {
            "type": "string",
            "description": "Employee id of the author of the task",
            "example": "1"
          },
          "completed_at": {
            "type": "string",
            "description": "Completed at date of the task",
            "example": "2024-01-01T00:00:00Z"
          },
          "completed_by_id": {
            "type": "string",
            "description": "Completed by identifier",
            "example": "1"
          },
          "created_at": {
            "type": "string",
            "example": "2024-01-20T18:05:45.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "Updated at date of the task",
            "example": "2024-01-20T18:05:45.000Z"
          },
          "status": {
            "type": "string",
            "description": "Status of the task",
            "enum": [
              "todo",
              "in_progress",
              "done",
              "discarded"
            ],
            "example": "todo"
          }
        }
      },
      "teams_membership": {
        "type": "object",
        "required": [
          "id",
          "employee_id",
          "team_id",
          "lead",
          "source_team_ids",
          "parent_team_ids"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Membership ID",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company ID of the membership",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "Employee ID of the membership",
            "example": "12"
          },
          "team_id": {
            "type": "string",
            "description": "Team ID of the membership",
            "example": "3"
          },
          "lead": {
            "type": "boolean",
            "description": "Whether the employee is a lead of the team or not",
            "example": true
          },
          "source_team_ids": {
            "type": "array",
            "description": "IDs of the teams this membership originates from (nested teams). In a company with nested teams, a direct membership includes the team itself; an inherited one, the sub-team(s) where the employee is a direct member. Only populated on reads that compute source attribution — reads filtered by a single team, or by a single employee with `with_source_attribution` enabled. Empty otherwise, including create, update and delete responses, and always empty for companies without nested teams. An empty array does not distinguish \"computed and genuinely empty\" from \"not computed for this read\" or \"could not be computed\", so only apply attribution-dependent logic to a read you explicitly shaped for it. A team-anchored read stops attributing above roughly a thousand members of the filtered team: past that the attribution is not computed at all and every row comes back empty, behind a normal `200`.",
            "example": [
              "3"
            ],
            "items": {
              "type": "string"
            }
          },
          "parent_team_ids": {
            "type": "array",
            "description": "IDs of the ancestor teams that receive an inherited membership through this row (nested teams) — the teams this membership rolls up into. Populated under the same conditions as `source_team_ids`; empty otherwise.",
            "example": [
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "direct": {
            "type": "boolean",
            "description": "Whether the employee is a direct member of the team (nested teams). Always present. `true` means direct member; `false` means the row exists only through inheritance from a sub-team; `null` means not computed for this read. Computed on reads filtered by a single `team_ids` value, and on reads filtered by a single employee with `with_source_attribution` enabled — always `null` otherwise, including create, update and delete responses and companies without nested teams. `null` is also returned when directness could not be resolved for a transient reason, so never treat `null` as `false` — retry the read instead."
          }
        }
      },
      "teams_team": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the team",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the team (e.g. \"Engineering\")",
            "example": "Engineering"
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the team",
            "example": "Engineering team description"
          },
          "avatar": {
            "type": "string",
            "description": "URL of the team's avatar image (null when the team has none)",
            "example": "https://api.factorialhr.com/rails/active_storage/representations/redirect/team.png"
          },
          "employee_ids": {
            "type": "array",
            "description": "IDs of the employees who are members of this team",
            "example": [
              "10",
              "12"
            ],
            "items": {
              "type": "string"
            }
          },
          "lead_ids": {
            "type": "array",
            "description": "IDs of the employees who are leads of this team (subset of employee_ids)",
            "example": [
              "10"
            ],
            "items": {
              "type": "string"
            }
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company this team belongs to",
            "example": "1"
          },
          "depth": {
            "type": "integer",
            "description": "Depth of this team in the nested-team hierarchy: 1 for a top-level team, 2 for its children, and so on. Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.",
            "example": 2
          },
          "parent_team_id": {
            "type": "string",
            "description": "ID of the parent team this team is nested under (null for a root team). Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.",
            "example": "5"
          }
        }
      },
      "timeoff_blocked_periods_policy": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "name",
          "leave_type_ids",
          "time_periods",
          "strategy",
          "members"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the blocked period",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company id of the blocked period",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the blocked period.",
            "example": "Onboarding period"
          },
          "leave_type_ids": {
            "type": "array",
            "description": "Leave types for which absence request has been blocked",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "time_periods": {
            "type": "array",
            "description": "The tenure periods associated with the allowance.",
            "example": [
              {
                "name": "Product offsite",
                "period_type": "by_contract_start_date",
                "duration": 2,
                "duration_unit": "months",
                "start_on": "2024-01-01",
                "finish_on": "2024-02-28"
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "policy_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "period_type": {
                  "type": "string"
                },
                "start_on": {
                  "type": "string"
                },
                "finish_on": {
                  "type": "string"
                },
                "duration": {
                  "type": "integer"
                },
                "duration_unit": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "policy_id",
                "name",
                "period_type"
              ]
            }
          },
          "strategy": {
            "type": "string",
            "description": "Type of access group",
            "example": "everyone"
          },
          "members": {
            "type": "array",
            "description": "Employees whose timeoff will be affected",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "location_ids": {
            "type": "array",
            "description": "List of locations workplace identifiers where the employees are located",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "team_ids": {
            "type": "array",
            "description": "List of team identifiers which the selected employees belong to",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "legal_entity_ids": {
            "type": "array",
            "description": "List of legal entity identifiers which the selected employees belong to",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "timeoff_leave": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "employee_id",
          "start_on",
          "updated_at",
          "days_taken"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the Leave",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company the leave belongs to",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "ID of the employee taking the leave",
            "example": "1"
          },
          "start_on": {
            "type": "string",
            "description": "First day of the leave",
            "example": "2028-09-05"
          },
          "finish_on": {
            "type": "string",
            "description": "Last day of the leave (inclusive); null while an open-ended leave has no end yet",
            "example": "2028-09-05"
          },
          "half_day": {
            "type": "string",
            "description": "Which half of the day a half-day leave covers — `beginning_of_day` or `end_of_day`; null for full-day leaves"
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the leave",
            "example": "Annual family vacation"
          },
          "reason": {
            "type": "string",
            "description": "The reason provided by the employee for taking the leave",
            "example": "Medical appointment"
          },
          "leave_type_id": {
            "type": "string",
            "description": "ID of the leave type this leave is of",
            "example": "36"
          },
          "leave_type_name": {
            "type": "string",
            "description": "Denormalised name of the leave type"
          },
          "approved": {
            "type": "boolean",
            "description": "Tri-state approval status — true = approved, false = rejected, null = pending approval",
            "example": true
          },
          "employee_full_name": {
            "type": "string",
            "description": "The full name of the employee taking the leave",
            "example": "Bob The Boss"
          },
          "start_time": {
            "type": "string",
            "description": "The start time of the leave",
            "example": "09:00"
          },
          "hours_amount_in_cents": {
            "type": "integer",
            "description": "Total hours the leave consumes, in hundredths of an hour (e.g. 800 = 8 hours); set for hourly leaves",
            "example": 800
          },
          "updated_at": {
            "type": "string",
            "description": "The updated at date of the leave",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "created_at": {
            "type": "string",
            "description": "The created at date of the leave",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "deleted_at": {
            "type": "string",
            "description": "The date when the leave was deleted",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "duration_attributes": {
            "type": "string",
            "description": "The duration attributes of the leave",
            "example": {
              "accrues_list": {
                "2028": 1
              },
              "workable_units": {
                "days": {
                  "2028": 1
                },
                "hours": {
                  "2028": 8
                }
              },
              "used_units": {
                "days": {
                  "2028": 1
                },
                "hours": {
                  "2028": 8
                }
              },
              "french_calendar_flag_enabled": false,
              "finish_on_natural": "2028-09-05"
            }
          },
          "duration_by_day_attributes": {
            "type": "object",
            "description": "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.",
            "properties": {
              "workable_units_by_day": {
                "type": "object",
                "properties": {
                  "days": {},
                  "hours": {}
                },
                "required": [
                  "days",
                  "hours"
                ]
              },
              "used_units_by_day": {
                "type": "object",
                "properties": {
                  "days": {},
                  "hours": {}
                },
                "required": [
                  "days",
                  "hours"
                ]
              }
            },
            "required": [
              "workable_units_by_day",
              "used_units_by_day"
            ]
          },
          "days_taken": {
            "type": "number",
            "description": "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.",
            "example": 1
          }
        }
      },
      "timeoff_leave_type": {
        "type": "object",
        "required": [
          "id",
          "name",
          "identifier",
          "color",
          "attachment",
          "visibility",
          "workable",
          "company_id",
          "allowance_ids",
          "details_required"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the leave type",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the leave type",
            "example": "Annual Leave"
          },
          "translated_name": {
            "type": "string",
            "description": "Translated name of the leave type, if available",
            "example": "Congé Annuel"
          },
          "identifier": {
            "type": "string",
            "description": "Unique identifier of the leave type",
            "example": "annual_leave"
          },
          "color": {
            "type": "string",
            "description": "The color associated with this leave type",
            "example": "red"
          },
          "active": {
            "type": "boolean",
            "description": "Whether the leave type is active",
            "example": true
          },
          "editable": {
            "type": "boolean",
            "description": "Whether the leave type is editable",
            "example": false
          },
          "approval_required": {
            "type": "boolean",
            "description": "Whether leaves of this type must be approved before they take effect (when false, requests are auto-approved on creation)",
            "example": true
          },
          "accrues": {
            "type": "boolean",
            "description": "Whether leaves of this type consume an accruing balance/allowance (vs. a non-accruing type that does not draw down a balance)",
            "example": true
          },
          "attachment": {
            "type": "boolean",
            "description": "Whether an attachment (e.g. a sick note) can be added to leaves of this type",
            "example": true
          },
          "allow_endless": {
            "type": "boolean",
            "description": "Whether leaves of this type may be open-ended (created with no finish date)",
            "example": false
          },
          "restricted": {
            "type": "boolean",
            "description": "Whether requesting this leave type is restricted to specific employees or conditions rather than open to everyone",
            "example": false
          },
          "visibility": {
            "type": "boolean",
            "description": "Whether the leave type is visible to employees (vs. admin-only)",
            "example": true
          },
          "workable": {
            "type": "boolean",
            "description": "Whether days taken under this leave type still count as workable (working) days",
            "example": false
          },
          "payable": {
            "type": "boolean",
            "description": "Whether leaves of this type are paid",
            "example": true
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company this leave type belongs to",
            "example": "1"
          },
          "is_attachment_mandatory": {
            "type": "boolean",
            "description": "Whether an attachment is mandatory (not just allowed) to request this leave type",
            "example": false
          },
          "allowance_ids": {
            "type": "array",
            "description": "IDs of the allowances this leave type draws its balance from",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "half_days_units_enabled": {
            "type": "boolean",
            "description": "Whether leaves of this type can be requested in half-day units",
            "example": true
          },
          "max_days_in_cents": {
            "type": "integer",
            "description": "Maximum number of days a single request may take, in hundredths of a day (e.g. 5000 = 50 days); null if unbounded",
            "example": 5000
          },
          "min_days_in_cents": {
            "type": "integer",
            "description": "Minimum number of days a single request must take, in hundredths of a day (e.g. 1000 = 10 days); null if unbounded",
            "example": 1000
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the leave type",
            "example": "This leave type is for annual holidays."
          },
          "details_required": {
            "type": "boolean",
            "description": "Whether the requester must provide additional details (a reason) when requesting this leave type",
            "example": false
          }
        }
      },
      "timeoff_policy": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The policy id.",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Policy name.",
            "example": "Policy for remotes"
          },
          "main": {
            "type": "boolean",
            "description": "Whether this is the company's main (default) time off policy — the one employees fall under unless assigned a specific policy.",
            "example": true
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company that owns this policy.",
            "example": "1"
          },
          "description": {
            "type": "string",
            "description": "The policy description.",
            "example": "This policy will apply only for remote employees"
          }
        }
      },
      "trainings_category": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "company_id": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        }
      },
      "trainings_training": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "author_id",
          "name",
          "description",
          "external",
          "fundae_subsidized",
          "subsidized",
          "cost",
          "subsidized_cost",
          "cost_decimal",
          "subsidized_cost_decimal",
          "year",
          "catalog",
          "competency_ids",
          "total_training_cost",
          "total_training_indirect_cost",
          "total_training_salary_cost",
          "total_training_subsidized_cost",
          "total_participants",
          "training_attendance_status",
          "total_duration",
          "is_mandatory"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the course",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier",
            "example": "1"
          },
          "author_id": {
            "type": "string",
            "description": "The person that creates the training",
            "example": "20"
          },
          "author_employee_id": {
            "type": "string",
            "description": "Employee identifier of the training author",
            "example": "15"
          },
          "name": {
            "type": "string",
            "description": "Name of the training",
            "example": "Communication Course"
          },
          "code": {
            "type": "string",
            "description": "Code of the training",
            "example": "COM-101"
          },
          "description": {
            "type": "string",
            "description": "Description of the training",
            "example": "Intermediate-level communication course that focuses on building and enhancing language skills."
          },
          "created_at": {
            "type": "string",
            "description": "Creation date of the course",
            "example": "2025-02-04T10:31:48.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "Last modification date of the course",
            "example": "2025-02-04T10:31:48.000Z"
          },
          "external_provider": {
            "type": "string",
            "description": "The name of the provider if any"
          },
          "external": {
            "type": "boolean",
            "description": "External training",
            "example": false
          },
          "total_cost": {
            "type": "integer",
            "example": 0
          },
          "fundae_subsidized": {
            "type": "boolean",
            "description": "Subsidized by Fundae",
            "example": false
          },
          "subsidized": {
            "type": "boolean",
            "description": "Marked as subsidized",
            "example": false
          },
          "cost": {
            "type": "integer",
            "example": 0
          },
          "subsidized_cost": {
            "type": "integer",
            "example": 0
          },
          "total_cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "subsidized_cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "category_ids": {
            "type": "array",
            "description": "List of ids of training categories",
            "example": [
              "1",
              "20"
            ],
            "items": {
              "type": "string"
            }
          },
          "status": {
            "type": "string",
            "description": "Training status. Can be one of the following values",
            "enum": [
              "draft",
              "active",
              "deleted"
            ],
            "example": "active"
          },
          "year": {
            "type": "integer",
            "description": "Year of the training",
            "example": 2025
          },
          "catalog": {
            "type": "boolean",
            "description": "Visible in catalog",
            "example": true
          },
          "competency_ids": {
            "type": "array",
            "description": "List of ids of training competencies",
            "example": [
              "1",
              "3"
            ],
            "items": {
              "type": "string"
            }
          },
          "total_training_cost": {
            "type": "string",
            "description": "The total direct cost of all course's groups",
            "example": "0.0"
          },
          "total_training_indirect_cost": {
            "type": "string",
            "description": "The total indirect cost of all course's groups",
            "example": "0.0"
          },
          "total_training_salary_cost": {
            "type": "string",
            "description": "The total salary cost of all course's groups",
            "example": "0.0"
          },
          "total_training_subsidized_cost": {
            "type": "string",
            "description": "The total subsidized cost of all course's groups",
            "example": "0.0"
          },
          "total_participants": {
            "type": "integer",
            "description": "Number of participants of all course's groups",
            "example": 0
          },
          "training_attendance_status": {
            "type": "string",
            "enum": [
              "notassigned",
              "notstarted",
              "missing",
              "started",
              "partiallycompleted",
              "completed"
            ],
            "example": "completed"
          },
          "valid_for": {
            "type": "integer",
            "description": "Number of years this course is valid for"
          },
          "objectives": {
            "type": "string",
            "description": "Objectives of the course",
            "example": "Build and enhance language skills."
          },
          "number_of_expired_participants": {
            "type": "integer",
            "description": "Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.",
            "example": 2
          },
          "total_duration": {
            "type": "number",
            "description": "The total duration in hours and minutes of the course",
            "example": 2.5
          },
          "is_mandatory": {
            "type": "boolean",
            "description": "This field is used to define if the training is mandatory or not",
            "example": false
          }
        }
      },
      "work_schedule_schedule": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id",
          "created_at",
          "updated_at",
          "employee_ids",
          "periods"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the schedule",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Name of the schedule",
            "example": "Morning shift"
          },
          "archived_at": {
            "type": "string",
            "description": "When the schedule was archived; null when the schedule is active"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier of the company the schedule belongs to",
            "example": "1"
          },
          "created_at": {
            "type": "string",
            "description": "When the schedule was created",
            "example": "2024-01-01T00:00:00.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "When the schedule was last updated",
            "example": "2024-01-01T00:00:00.000Z"
          },
          "employee_ids": {
            "type": "array",
            "description": "Identifiers of the employees assigned to the schedule",
            "example": [
              "1",
              "2"
            ],
            "items": {
              "type": "string"
            }
          },
          "periods": {
            "type": "array",
            "description": "Overlap periods that make up the schedule",
            "example": [
              {
                "id": 1,
                "schedule_id": 1,
                "default": false,
                "start_day": 15,
                "start_month": 12,
                "end_day": 31,
                "end_month": 12,
                "schedule_type": "flexible"
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "default": {
                  "type": "boolean"
                },
                "schedule_id": {
                  "type": "string"
                },
                "start_month": {
                  "type": "integer"
                },
                "start_day": {
                  "type": "integer"
                },
                "end_month": {
                  "type": "integer"
                },
                "end_day": {
                  "type": "integer"
                },
                "start_date": {
                  "type": "string"
                },
                "end_date": {
                  "type": "string"
                },
                "schedule_type": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "default",
                "schedule_id",
                "start_month",
                "start_day",
                "end_month",
                "end_day",
                "start_date",
                "end_date",
                "schedule_type"
              ]
            }
          }
        }
      },
      "banking_bank_account_number": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "account_number",
          "format"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Employee id.",
            "example": 135
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier",
            "example": "1"
          },
          "account_number": {
            "type": "string",
            "description": "Account number",
            "example": "ES7520807723367311468673"
          },
          "complementary_data": {
            "type": "string",
            "description": "Additional banking information, depending on the selected format."
          },
          "format": {
            "type": "string",
            "description": "The format of the account number.",
            "enum": [
              "iban",
              "sort_code_and_account_number",
              "routing_number_and_account_number",
              "clabe",
              "other",
              "bank_name_and_account_number"
            ]
          }
        }
      },
      "contracts_contract_version_request": {
        "type": "object",
        "required": [
          "employee_id",
          "effective_on",
          "has_payroll",
          "created_at",
          "updated_at",
          "status",
          "fr_forfait_jours"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "company_id": {
            "type": "string"
          },
          "employee_id": {
            "type": "string"
          },
          "effective_on": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "job_title": {
            "type": "string"
          },
          "job_catalog_level_id": {
            "type": "string"
          },
          "job_catalog_level_name": {
            "type": "string"
          },
          "job_catalog_level": {
            "type": "string"
          },
          "job_catalog_role": {
            "type": "string"
          },
          "job_catalog_role_id": {
            "type": "string"
          },
          "job_catalog_tree_node_uuid": {
            "type": "string"
          },
          "starts_on": {
            "type": "string"
          },
          "ends_on": {
            "type": "string"
          },
          "has_payroll": {
            "type": "boolean"
          },
          "has_payroll_policies": {
            "type": "boolean"
          },
          "has_trial_period": {
            "type": "boolean"
          },
          "trial_period_ends_on": {
            "type": "string"
          },
          "salary_amount": {
            "type": "integer"
          },
          "salary_frequency": {
            "type": "string"
          },
          "working_week_days": {
            "type": "string"
          },
          "working_hours": {
            "type": "integer"
          },
          "working_hours_frequency": {
            "type": "string"
          },
          "max_legal_yearly_hours": {
            "type": "integer"
          },
          "maximum_weekly_hours": {
            "type": "integer"
          },
          "adjusted_daily_minutes": {
            "type": "integer"
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "created_by_name": {
            "type": "string"
          },
          "created_by_avatar": {
            "type": "string"
          },
          "action_type": {
            "type": "string"
          },
          "request_details": {
            "type": "string"
          },
          "approvers_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "",
              "pending",
              "approved",
              "rejected"
            ]
          },
          "approval_author_id": {
            "type": "string"
          },
          "approval_request_created_at": {
            "type": "string"
          },
          "approval_action_type": {
            "type": "string"
          },
          "es_has_teleworking_contract": {
            "type": "boolean"
          },
          "es_cotization_group": {
            "type": "integer"
          },
          "es_contract_observations": {
            "type": "string"
          },
          "es_job_description": {
            "type": "string"
          },
          "es_contract_type_id": {
            "type": "string"
          },
          "es_contract_type_name": {
            "type": "string"
          },
          "es_working_day_type_id": {
            "type": "string"
          },
          "es_working_day_type_name": {
            "type": "string"
          },
          "es_education_level_id": {
            "type": "string"
          },
          "es_education_level_name": {
            "type": "string"
          },
          "es_professional_category_id": {
            "type": "string"
          },
          "es_professional_category_name": {
            "type": "string"
          },
          "es_contribution_type_id": {
            "type": "string"
          },
          "es_contribution_type_name": {
            "type": "string"
          },
          "es_agreement_code_id": {
            "type": "string"
          },
          "es_agreement_code_name": {
            "type": "string"
          },
          "es_cno_occupation_id": {
            "type": "string"
          },
          "es_cno_occupation_name": {
            "type": "string"
          },
          "es_regime_id": {
            "type": "string"
          },
          "es_regime_name": {
            "type": "string"
          },
          "es_tariff_group_id": {
            "type": "string"
          },
          "es_tariff_group_name": {
            "type": "string"
          },
          "es_occupation_code_id": {
            "type": "string"
          },
          "es_occupation_code_name": {
            "type": "string"
          },
          "es_classification_id": {
            "type": "string"
          },
          "es_classification_name": {
            "type": "string"
          },
          "es_a3innuva_job_position_id": {
            "type": "string"
          },
          "es_a3innuva_job_position_name": {
            "type": "string"
          },
          "fr_employee_type": {
            "type": "string"
          },
          "fr_forfait_jours": {
            "type": "boolean"
          },
          "fr_jours_par_an": {
            "type": "integer"
          },
          "fr_jours_par_an_cents": {
            "type": "integer"
          },
          "fr_coefficient": {
            "type": "string"
          },
          "fr_contract_type_id": {
            "type": "string"
          },
          "fr_level_id": {
            "type": "string"
          },
          "fr_step_id": {
            "type": "string"
          },
          "fr_mutual_id": {
            "type": "string"
          },
          "fr_professional_category_id": {
            "type": "string"
          },
          "fr_work_type_id": {
            "type": "string"
          },
          "fr_contract_type_name": {
            "type": "string"
          },
          "fr_mutual_name": {
            "type": "string"
          },
          "fr_professional_category_name": {
            "type": "string"
          },
          "fr_work_type_name": {
            "type": "string"
          },
          "fr_level_name": {
            "type": "string"
          },
          "fr_step_name": {
            "type": "string"
          },
          "de_contract_type_id": {
            "type": "string"
          },
          "de_contract_type_name": {
            "type": "string"
          },
          "de_employment_type": {
            "type": "integer"
          },
          "de_flat_rate_tax": {
            "type": "integer"
          },
          "de_activity_type": {
            "type": "integer"
          },
          "de_personal_key_group_id": {
            "type": "string"
          },
          "de_personal_key_group_name": {
            "type": "string"
          },
          "de_base_salary_type_id": {
            "type": "string"
          },
          "de_base_salary_type_name": {
            "type": "string"
          },
          "pt_contract_type_id": {
            "type": "string"
          },
          "pt_contract_type_name": {
            "type": "string"
          }
        }
      }
    }
  }
}
```