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.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the target Person.

string
required

The ID of the target Employment.

Body Params

An Employment resource.

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
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/problem+json

Updated 5 months ago