Set one-time password
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 15, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Set a one-time password for users after performing checks against the password policy. Users can log in with this password only once and must change the password the next time they log in.
Table 1. API details
Method
Resource address
Operation header
POST
service/authentication/setOneTimePassword
None

See the following sample HTTP request:

{ "UserCredential" :



{



"LoginName":"JohnDoe@example.com",



"NewPassword":"asdfggdf1",



}

}


For LoginName, specify the login ID or email address of the user. For NewPassword, specify the one-time password for the user.


For a list of common HTTP status codes that are returned for API calls, see HTTP status codes.

Parent topic: Authentication services
Input
Method URI Description
POST /api/bss/service/authentication/setOneTimePassword Set a one-time password for users after performing checks against the password policy. Users can log in with this password only once and must change the password the next time they log in.
Content Type: application/json
Sample Request:
{ "UserCredential" :

	{

	"LoginName":"JohnDoe@example.com",

	"NewPassword":"asdfggdf1",

	}
}
Output
Code Description
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.