anchor.diff:  
   `POST /_security/user/<username>` +
   
  -`PUT /_security/user/<username>` 
  +`PUT /_security/user/<username>`
   
   
   [[security-api-put-user-prereqs]]
  
positive.code: <titleabbrev>Create or update users</titleabbrev>
  ++++
  
  Adds and updates users in the native realm. These users are commonly referred 
  to as _native users_.
  
  
  
negative.code: [[security-api-put-user-desc]]
  ==== {api-description-title}
  
  A `password` is required for adding a new user but is optional when updating an
  existing user. To change a user's password without updating any other fields,
  use the <<security-api-change-password, change password API>>.
  
  For more information about the native realm, see
  <<realms>> and <<native-realm>>.
  
  [[security-api-put-user-path-params]]
  ==== {api-path-parms-title}
  