Update Employee Job

---

PUT /services/api/v1/employee_jobs/{id}

Updates an existing employee job.

Parameters

Parameter	Type	Description
id	string	The ID of the employee job.

Request Body

Example

{
  "employee_id": "rQ6ZV6W5",
  "from": "2024-08-25",
  "to": "2024-12-18",
  "notes": null,
  "time_percentage": 60.0,
  "time_hours": 25.0,
  "time_type": "part_time",
  "time_table": null,
  "classification": null,
  "job_type": "unlimited",
  "supervisor_id": "KRBbJBwN",
  "department_id": "rQ6ZV6W5",
  "location_id": "KRBbJBwN",
  "name": "Regional Manager"
}

Schema

Attribute	Type	Required	Description
name	string	true	Name of the employee job. Usually the job title.
employee_id	string	true	Id of the employee the job belongs to.
from	date	true	Start date of the employee job (ISO8601).
to	date	false	End date of the employee job (ISO8601). Null if unlimited.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Job Fields API endpoint.

Response

201

The updated employee job.

Example

{
  "id": "7bBJADz2",
  "employee_id": "rQ6ZV6W5",
  "from": "2024-08-25",
  "to": "2024-12-18",
  "notes": null,
  "time_percentage": 60.0,
  "time_hours": 25.0,
  "time_type": "part_time",
  "time_table": null,
  "classification": null,
  "job_type": "unlimited",
  "supervisor_id": "KRBbJBwN",
  "department_id": "rQ6ZV6W5",
  "location_id": "KRBbJBwN",
  "name": "Regional Manager",
  "created_at": "2024-10-10T13:43:56.347Z",
  "updated_at": "2024-10-14T10:06:50.112Z"
}

Schema

Attribute	Type	Required	Description
id	string	readonly	Id of the employee job.
created_at	datetime	readonly	Employee job creation date.
updated_at	datetime	readonly	Employee job last updated at.
name	string	true	Name of the employee job. Usually the job title.
employee_id	string	true	Id of the employee the job belongs to.
from	date	true	Start date of the employee job (ISO8601).
to	date	false	End date of the employee job (ISO8601). Null if unlimited.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Job Fields API endpoint.

422

Unprocessable Entitiy.

Example:

{
  "from": ["This field is mandatory."],
  "supervisor_id": ["This field is invalid."]
}