Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version 2

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
Description

In a situation where you need to block a user from accessing their EMM profile, the EMM administrator is able to reset the password. This will change the user's password and the user will not be able to able to login to the account.

Resource Path/reset-password
URL/mdm-admin/users/reset-password
HTTP MethodPOST
Request/Response Formatapplication/json
cURL command
Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/users/reset-password
  • For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
  • Define the path to the JSON file, which includes the required properties to change a user password as <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
  • By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

Example:

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'user.json' -k -v https://localhost:9443/mdm-admin/users/reset-password
 Sample output
Code Block
 
Anchor
sample
sample
Sample JSON Definition 
Code Block
{  
   "username":"kim",
   "oldPassword":"kim$1234",
   "newPassword":"kim$12bar"
}
PropertyDefinitionData
Type 
username

Provide the name of the user you wish to change the password.

String
oldPasswordProvide the current password that is being used.String
newPasswordProvide the new password.String