Updated on 2026-04-16 GMT+08:00

Resetting a Password

Function

Reset a password.

URI

POST /koodrive/ose/v1/password/reset

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Traceid

No

String

Definition:

Service trace ID, which contains 58 bits.

Constraints:

N/A

Range:

The value contains 58 bits.

Default Value:

N/A

x-hw-agentName

Yes

String

Definition:

Agent name.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

phoneNumber

Yes

String

Mobile number.

captchaToken

Yes

String

Token of the verification code.

newPwd

Yes

String

New password after reset.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

code

String

Error Codes

msg

String

Error description.

Example Requests

POST /koodrive/ose/v1/password/reset

{
  "phoneNumber" : "123456789012345678901",
  "captchaToken" : "captchaToken",
  "newPwd" : "aASD27188460911"
}

Example Responses

Status code: 200

Password reset response

{
  "code" : 0,
  "msg" : "Success"
}

Status Codes

Status Code

Description

200

Password reset response