Page Comparison

Excerpt

Description

In situation where you need to change or reset your password, you can do so using the REST API given below.

Resource Path /change-password

URL /mdm-admin/users/change-password

HTTP Method POST

Request/Response Format application/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/change-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/change-password

Sample output

Code Block

Anchor

	sample
	sample

Sample JSON Definition

Code Block
{ "username":"kim", "oldPassword":"kim$1234", "newPassword":"kim$12bar" }

Property	Definition	Data Type
`username`	Provide the name of the user you wish to change the password.	String
`oldPassword`	Provide the current password that is being used.	String
`newPassword`	Provide the new password.	String

Versions Compared