close anchor

Initialize User Password

To initialize an existing user's password:

POST /user/pwd/init

This endpoint provides for a user to initialize a lost or forgotten password. In general, this would involve a page or view on which the user inputs their e-mail, which is then delivered to this endpoint:

Parameters

Provide the input field(s) below as a JSON-encoded data object:

Param Type Description
email string The e-mail identified with the user for which to initialize an existing password.

Data Fields

If the user exists, the data object provided by this endpoint includes:

Field Type Description
email string The e-mail provided by the user.
token string 128-byte password initialization token.

The password initialization token delivered by this endpoint is identified exclusively with both the user and the developer key for which it is provided, with a one day expiration time. This enables the developer to provide, for example, a direct e-mail invitation to a page or view on which the user would edit their password using this token (the /user/pwd/edit endpoint provides this functionality). Elebase does not e-mail the user directly, because the exact flow and user experience of this interaction ought to be up to the expression itself.

Errors

If there is an endpoint transaction failure, or a problem with user input data, an error is provided:

ID/Type Description
email_not_provided The user email was not provided.
invalid_email The user email is not valid.

If an error is not described on this page, the platform-wide error table provides further information.

Register for an Invitation
Thank you!
We'll be in touch.
First Name*
Last Name*
(optional) Business Name
Role*
Email*