Create User V2 Using POST
This API is used to add a user and assign roles to it. You can fetch different roles by triggering get all external roles.
Request
URI
POST
https://{api_host}/lcm/authzn/api/v2/users
COPY
Request Body
userRequestDTO
UserRequestDTO
of type(s)
application/json
Optional
{
"displayName": "configadmin configadmin",
"domain": "System Domain",
"isDisabled": false,
"mappedRoles": [
"string"
],
"password": "locker:password:<vmid>:<alias>",
"providerIdentifier": "6304f1ed-17e0-4128-b86f-e29c6563e32f",
"userMetadata": {
"additionalMeta": [
"string"
],
"distinguishedName": "string",
"emails": [
"[email protected]"
],
"externalId": "764195c6-5504-4f56-8c34-b372d47f5176",
"familyName": "user1",
"givenName": "LCM"
},
"userPrincipalName": "configadmin_upn",
"userType": "VIDM_LOCAL_USER",
"username": "configadmin"
}
Responses
200
OK
Operation doesn't return any data structure
201
Created
Returns
UserDTO
of type(s)
application/json
"UserDTO Object"
string
displayName
Optional
Display Name
string
domain
Optional
Domain
boolean
isDisabled
Optional
isDisabled
string
password
Optional
password
string
providerIdentifier
Optional
Provider ID
array of
object
roleMappings
Optional
roleMappings
object
userMetadata
Optional
userMetadata
string
userPrincipalName
Optional
User Principal Name
string
userType
Optional
User Type
string
username
Optional
Username
string
vmid
Optional
User ID
401
Unauthorized
Operation doesn't return any data structure
403
Forbidden
Operation doesn't return any data structure
404
Not Found
Operation doesn't return any data structure
500
Internal Server Error
Returns
GenericErrorResponseDTO
of type(s)
application/json
"GenericErrorResponseDTO Object"
string
errorCode
Optional
errorCode
string
errorLabel
Optional
errorLabel
string
message
Optional
message
array of
string
recommendations
Optional
recommendations
Code Samples
COPY
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/lcm/authzn/api/v2/users
On This Page
Authentication User Controller Operations
POST
Search Vidm User Grp V2 Using POST
POST
Create User V2 Using POST
GET
Get Users By User Name And Domain V2 Using GET
PUT
Update Local User Password V2 Using PUT
GET
Get All Provider Mapped Users V2 Using GET
GET
Get User By Provider Identifier V2 Using GET
GET
Get Users By Principal Name V2 Using GET
GET
Get Users By Principal Name And Domain V2 Using GET
PUT
Update User By Id V2 Using PUT
DELETE
Delete User By Id V2 Using DELETE
PATCH
Update User By Id V2 Using PATCH