If ``access-key`` is specified and refers to an existing key owned by the user
then it will be modified.
+.. versionadded:: Luminous
+
+A ``tenant`` may either be specified as a part of uid or as an additional
+request param.
+
:caps: users=write
Syntax
:Type: String
:Example: ``foo_user``
:Required: Yes
+A tenant name may also specified as a part of ``uid``, by following the syntax ``tenant$user``, refer to `Multitenancy`_ for more details.
``display-name``
:Example: False [False]
:Required: No
+.. versionadded:: Jewel
+``tenant``
+
+:Description: the Tenant under which a user is a part of.
+:Type: string
+:Example: tenant1
+:Required: No
+
Response Entities
~~~~~~~~~~~~~~~~~
:Description: A container for the user data information.
:Type: Container
+``tenant``
+:Description: The tenant which user is a part of
+:Type: String
+:Parent: ``user``
+
``user_id``
:Description: The user id.
.. _Admin Guide: ../admin
.. _Quota Management: ../admin#quota-management
+.. _Multitenancy: ./multitenancy