anchor.diff:  <titleabbrev>Create or update users</titleabbrev>
   ++++
   
  -Adds and updates users in the native realm. These users are commonly referred 
  +Adds and updates users in the native realm. These users are commonly referred
   to as _native users_.
   
   
  
positive.code: 
  `POST /_security/user/<username>` +
  
  `PUT /_security/user/<username>` 
  
  
  [[security-api-put-user-prereqs]]
  
negative.code: access  permissions. To create a user without any roles, specify an empty list:
  `[]`.
  
  --
  [[not-always-required]]
  *Indicates that the setting is required in some, but not all situations.
  --
  
  [[security-api-put-user-example]]
  ==== {api-examples-title}
  