API Reference
Become a Partner

Update an Employment.

patch
https://api.personio.de/v2/persons//employments/
  • This endpoint enables the update of an Employment resource.
  • The endpoint requires the personio:persons:write scope.
Path Params
string
required

The ID of the target Person.

string
required

The ID of the target Employment.

Body Params
supervisor
object | null

The supervisor object.

office
object | null

The office object.

org_units
array of objects | null

All Org Units, i.e. department and team, that are to be associated with the Employment.

org_units
subcompany
object | null
deprecated
legal_entity
object | null
position
object | null

The position object.

string
enum

Status of employment.

Allowed:
date

When the employment contract starts.

string
enum

The type of employment.

Allowed:
date | null

When the employment contract ends, if the contract is for temporary employment.

date | null

When the probation period ends. Only one of probation_period_length or probation_end_date should be set.

integer | null

Only one of probation_period_length or probation_end_date should be set.

float | null

The number of hours worked weekly.

float | null

The number of hours per week that is considered full time for the employment.

cost_centers
array of objects

The weight distribution of this employment between different cost centers, using percentages.

cost_centers
Responses
204

Employment updated successfully.

Updated 5 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/problem+json
Updated 5 months ago