Complete password reset
/accounts/complete_password_reset
Target audience: Developers
Release version: 4.1.3
Complete password reset¶
Introduction¶
This endpoint is used to complete the password reset flow. It will trigger the "account_password_reset_complete" event.
URI¶
| Environment | URI |
|---|---|
| Stage | https://payway-api.stage.adeprimo.se/external/api/v1/accounts/complete_password_reset |
| Production | https://backend.worldoftulo.com/external/api/v1/accounts/complete_password_reset |
Requirements¶
| Identity | Scope |
|---|---|
| No | /external/account/w |
Parameters¶
| Field | Required | Type | Description |
|---|---|---|---|
| id | Reguired | String | The id of the account. Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i" |
| confirmation_code | Required | String | The confirmation code for the account. Size: 36 |
| new_password | Required | String | The new password. Size range: 6..1024 |
Curl Example¶
curl --request POST \
--url https://payway-api.stage.adeprimo.se/external/api/v1/accounts/complete_password_reset \
--header 'accept: application/json' \
--header 'authorization: Bearer token' \
--header 'content-type: application/json' \
--data '{
"id": "50f3ac249f6aef294d000007",
"confirmation_code": "fd49ed16-d6ef-4271-a8e8-278215ab79bd",
"new_password": "new_password159!"
}'
Response¶
| Field | Description |
|---|---|
| id | id of the updated account |
Example Response¶
HTTP 200 Updated
{
"id": "50f3ac249f6aef294d000007"
}
Errors¶
Example error response¶
HTTP 400 Bad Request
{
"code": "invalid_parameter",
"field": "id",
"message": "Parameter must match format (/^[a-f\d]{24}$/)"
}
HTTP 400 Bad Request¶
| Name | Type | Description |
|---|---|---|
| invalid_parameter | Object | Validation error on any of the fields in the posted json |
| json_parser_error | Object | The request body could not be parsed as valid json |
| invalid_content_type_error | Object | The requests Content-Type header isn't set to application/json |
| unknown_parameter | Object | One or more of the fields in the posted json was not recognized |
HTTP 404 Not Found¶
| Name | Type | Description |
|---|---|---|
| not_found | Object | The package could not be found |
HTTP 500 Internal Server Error¶
| Name | Type | Description |
|---|---|---|
| internal_server_error | Object | Something unexpected happened server side |