# Update user by ID

Endpoint: PUT /users/{userId}
Version: 5.1.45
Security: api_key

## Path parameters:

  - `userId` (integer, required)
    The ID of the user to update

## Request fields (application/json):

  - `userName` (string, required)
    The name for this User. Note that it must be unique among Users.
    Example: "DelphixUser1"

  - `password` (string)
    The password for this User. NOTE: For updates, this field does not have to be set. If no password is provided on an update, then the current password will persist.
    Example: "Password_123"

  - `firstName` (string, required)
    The first name of this User. This does not need to match the user name.
    Example: "First"

  - `lastName` (string, required)
    The last name of this User. This does not need to match the user name.
    Example: "Last"

  - `email` (string, required)
    The email address for this User.
    Example: "user@delphix.com"

  - `isAdmin` (boolean, required)
    True for an administrative User, false for a non-administrative User.

  - `showWelcome` (boolean)
    Flag to enable and disable welcome page for user, default true for a newly created User.
    Example: true

  - `userStatus` (string, required)
    Status of user account.
    Enum: "ACTIVE", "LOCKED", "DISABLED"

  - `disableReason` (string)
    The reason why the user's account was locked.

  - `nonAdminProperties` (object)
    Example: {"roleId":1,"environmentIds":[1,3,7]}

  - `nonAdminProperties.roleId` (integer, required)
    The ID of the role assigned to this User.
    Example: 1

  - `nonAdminProperties.environmentIds` (array)
    The list of ID numbers that correspond to the environments that this User has access to.
    Example: [1,3,7]

  - `apiAccess` (boolean)
    For use with SSO only. Flag to enable and disable api access for users. When SSO is enabled, the value defaults to true for admins and false for non-admins. When SSO is disabled, the value defaults to true for all users. The value is only modifiable when SSO is enabled and only by admins. The value is immutable for admin users except with DCT enabled. When SSO is disabled, the value is ignored and the user will be granted API access.

  - `principal` (string)
    Identifies this user on external identity services. Used for OAuth2 API authentication when the principal is selected as the field to match users with access tokens.

## Response 200 fields (application/json):

  - `userId` (integer)
    The ID of the User. This field will be generated by the Masking Engine.

  - `userName` (string, required)
    The name for this User. Note that it must be unique among Users.
    Example: "DelphixUser1"

  - `password` (string)
    The password for this User. NOTE: For updates, this field does not have to be set. If no password is provided on an update, then the current password will persist.
    Example: "Password_123"

  - `firstName` (string, required)
    The first name of this User. This does not need to match the user name.
    Example: "First"

  - `lastName` (string, required)
    The last name of this User. This does not need to match the user name.
    Example: "Last"

  - `email` (string, required)
    The email address for this User.
    Example: "user@delphix.com"

  - `isAdmin` (boolean, required)
    True for an administrative User, false for a non-administrative User.

  - `showWelcome` (boolean)
    Flag to enable and disable welcome page for user, default true for a newly created User.
    Example: true

  - `userStatus` (string, required)
    Status of user account.
    Enum: "ACTIVE", "LOCKED", "DISABLED"

  - `disableReason` (string)
    The reason why the user's account was locked.

  - `nonAdminProperties` (object)
    Example: {"roleId":1,"environmentIds":[1,3,7]}

  - `nonAdminProperties.roleId` (integer, required)
    The ID of the role assigned to this User.
    Example: 1

  - `nonAdminProperties.environmentIds` (array)
    The list of ID numbers that correspond to the environments that this User has access to.
    Example: [1,3,7]

  - `apiAccess` (boolean)
    For use with SSO only. Flag to enable and disable api access for users. When SSO is enabled, the value defaults to true for admins and false for non-admins. When SSO is disabled, the value defaults to true for all users. The value is only modifiable when SSO is enabled and only by admins. The value is immutable for admin users except with DCT enabled. When SSO is disabled, the value is ignored and the user will be granted API access.

  - `principal` (string)
    Identifies this user on external identity services. Used for OAuth2 API authentication when the principal is selected as the field to match users with access tokens.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 409 fields