Updates a Contract version

put

https://api.factorialhr.com/api/2025-10-01/resources/contracts/contract_versions/{id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

contract version identifier.

Body Params

integer

required

contract version identifier.

employee_id

integer

employee identifier, refers to /employees/employees endpoint.

effective_on

string

the day the specific contract starts, in case of hiring the same than starts_on.

starts_on

string

the day the employee is hired.

ends_on

string

the day the employee is terminated.

working_hours_frequency

string

the frequency of the working hours.

working_week_days

string

the days of the week the employee works.

working_hours

integer

the amount of hours the employee works.

salary_frequency

string

the frequency of the salary payment. When adding a salary to a contract that previously had none, both salary_amount and salary_frequency must be provided together.

salary_amount

integer

the amount of money the employee earns. When adding a salary to a contract that previously had none, both salary_amount and salary_frequency must be provided together.

job_title

string

job title of the employee.

es_cotization_group

integer

cotization group identifier.

es_professional_category_id

integer

professional category identifier.

es_education_level_id

integer

education level identifier.

es_contract_type_id

integer

contract type identifier.

es_working_day_type_id

integer

working day type identifier.

has_trial_period

boolean

a flag that indicates if the employee has a trial period.

trial_period_ends_on

string

when the trial period ends.

bank_holiday_treatment

string

enum

Defines whether a bank holiday should be considered as a workable or non-workable day.

Allowed:

working_time_percentage_in_cents

integer

Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).

annual_working_time_distribution

string

enum

Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.

Allowed:

Response

200OK