Sign in
latestOpenAPI 3.0.12026-08-11284749.9 KB

58e231ca118e

Users

Update user

This endpoint updates a user. Any parameters not provided will be left unchanged.

put/v2/users/{id}

Path parameters

idstring required

Headers

Idempotency-Keystring nullable

Request body

status'ACTIVE' | 'DISABLED'

Acceptable user status for update. To suspend a user, set status to 'disabled'. To unsuspend a user, set status to 'active'.

manager_idstring nullable

The user id of the manager of this user

department_idstring nullable
location_idstring nullable
title_idstring nullable
metadataobject nullable

The metadata or customized attributes of the user. Maximum number of entries: 100

Response

updateUser 200 response

idstring required
first_namestring required

First name of the user

last_namestring required

Last name of the user

emailstring required

Email address of the user

status'INVITED' | 'ACTIVE' | 'CLOSED' | 'DISABLED' | 'DELETED' | 'PENDING_ACTIVATION' | 'INACTIVE' | 'ARCHIVED'

Status of the user

manager_idstring nullable

The user id of the manager of this user

department_idstring nullable
location_idstring nullable
title_idstring nullable
metadataobject nullable

The metadata or customized attributes of the user. Maximum number of entries: 100

remote_display_idstring nullable

Identifier that is displayed on the IDP or HR system, eg, if OKTA identifies you as user xyz