Update User Manager

Allowed Scopes: experimental:user:manage

Set the manager of a user of the company the token resolves to, by managerId or by managerEmail (exactly one of them), or remove it by sending null. The reporting managers feature must be enabled, and the manager must be another member of that company. A user has at most one manager: setting a new one replaces the previous one, and setting the same one again changes nothing. When another update of the user's manager happens at the same time and leaves them with a different manager, 409 is returned: read the user again before retrying. Users who are admin, account owner or travel manager in the company cannot be updated, and companies whose users are managed by an HRIS integration are refused.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID of the user to update.

Body Params
string | null

ID of the manager, or null to remove the manager.

string | null

Email of the manager, or null to remove the manager.

Headers
string

ID of the company the request acts on. Required with an organisation-level token; not needed with a company-level token.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json