Update employment

put

https://gateway.remote.com/v2/employments/{employment_id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

employment_id

string

required

Employment ID

Body Params

Employment params

Parameters for updating employment-level fields such as department, manager, work email, and external ID.

department_id

string | null

The department of the employment. The department must belong to the same company as the employment.
When set to null, the employment will be unassigned from a department.

external_id

string

length ≤ 64

A unique reference code for the employment record in a non-Remote system. This optional field links to external data sources. If not provided, it defaults to null. While uniqueness is recommended, it is not strictly enforced within Remote's system.

manager_id

string

The user id of the manager, who should have an admin, owner or people_manager role.
You can find these users by querying the Company Managers endpoint.

work_email

string

The work email of the employment.

Responses

Callback

200Success

400Bad Request

403Forbidden

409Conflict

422Unprocessable Entity

429Unprocessable Entity