Update a user
Updates the given fields of the user; omitted fields stay untouched and null clears a field. A user managed by an HRIS directory integration gets its name and org info from the directory, so these fields are refused. Its manager can only be changed together with manager_override set to true, which stops the directory sync from changing the manager; manager_override false hands the manager back to the directory.
null
clears a field.
Authorizations
Bearer token authentication. Pass your AccessOwl API token in the Authorization header as Bearer <token>.
Headers
Optional key (1–255 chars) for safely retrying a request. Reusing the same key for the same request returns 409 Conflict and is not processed again — this confirms the request was already received. Keys are retained for 14 days.
1 - 255Path Parameters
User ID
Body
Update user parameters
Request body for updating a user. Omitted fields stay untouched; null clears a field. For a user managed by an HRIS directory integration, name and org-info fields are refused and a manager change requires manager_override.
Departments the user belongs to
Employment type
full_time, part_time, contract, freelance, internship, apprenticeship, working_student, training First name
Job title
Last name
City location
Only relevant for a user managed by an HRIS directory integration. true is required to change the manager and stops the directory sync from changing it; false hands the manager back to the directory.
Manager user ID. The user's own ID marks them as an executive, who reports to no one.
Teams the user belongs to
Response
User updated
A user in the organization
Email address
First name
User ID
Last name
Current status
active, inactive, onboarding, onboarding_provisioning_planned, offboarding, offboarding_planned, offboarded Deactivation timestamp
Departments the user belongs to
Employment type
full_time, part_time, contract, freelance, internship, apprenticeship, working_student, training Full name (computed)
Creation timestamp
Job title
City location
Manager user ID
Teams the user belongs to
Last update timestamp

