User aliases can be used to assign multiple usernames to a single user. These additional usernames are called aliases. Use aliases to for example allow a user to authenticate using either the users username or e-mail address.
Aliases are only ever looked up during authentication, and can not be used as a substitute for the usernames. In this way, user aliases are different to external ids.
-
PUT
/user/
(username)/alias/
(name) Adds a new user alias for the specified user.
Status Codes: |
|
Role: | _administrator
|
Example
PUT /user/stephen/alias/stephen@example.com
NONE
GET API/user/stephen
NONE
<UserDocument xmlns="http://xml.vidispine.com/schema/vidispine" disabled="false">
<userName>stephen</userName>
<realName>Stephen</realName>
<alias>stephen@example.com</alias>
</UserDocument>
HTML/XML
-
DELETE
/user/
(username)/alias/
(name) Removes the specific user alias.
Example
DELETE /user/stephen/alias/stephen@example.com
NONE
GET API/user/stephen
NONE
<UserDocument xmlns="http://xml.vidispine.com/schema/vidispine" disabled="false">
<userName>stephen</userName>
<realName>Stephen</realName>
</UserDocument>
HTML/XML