Password

Password reset flow for users who cannot sign in. Both endpoints are unauthenticated: request a reset email, then set the new password with the token from that email.

POST/password/reset

Send password reset email

Always responds with 200 regardless of whether the email matches a user.

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Request body schema

  • Name
    application/x-www-form-urlencoded
    Type
    schema
    Description

Body schema

  • Name
    email
    Type
    string required
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    400
    Type
    error
    Description
    Bad request

Request

POST
/password/reset
curl --location --request POST 'https://gw.onemap8.com/api/password/reset' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}' \
--data '{
"email": "<string>"
}'

Response

OK

POST/password/update

Set a new password using a reset token

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Request body schema

  • Name
    application/x-www-form-urlencoded
    Type
    schema
    Description

Body schema

  • Name
    token
    Type
    string required
    Description
  • Name
    password
    Type
    string <password> required
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    404
    Type
    error
    Description
    User not found

Request

POST
/password/update
curl --location --request POST 'https://gw.onemap8.com/api/password/update' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}' \
--data '{
"token": "<string>",
"password": "<password>"
}'

Response

OK