User Update API
Update user account information using an access token.
Keep account details current and enhance security by updating the email address and password.
This API is available on the Personal plan or higher.
/api/user/v1/update
X-Access-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
{
"eml": "yourchange@gmail.com",
"pwd": "Zght943!"
}
Request Parameters
- eml string
-
New email address to update.
Re-authentication is required when logging in after changing the email. - pwd string
-
New password to update.
Must be 6–30 characters long and contain a combination of letters and numbers.
{
"code": 0,
"message": "",
"result": null
}
Response Parameters
- code integer
- Response code: 0 = Success, other values = Error
- message string
- Response message. If the response code is not 0, an error message is returned.
- result null
When to Use This API
Use this API when a user needs to update their linked email address or reset their password for security reasons.
It is especially valuable for enforcing periodic password rotation policies in enterprise environments or automating workflows that require user data synchronization.
Things to consider when changing email
Changing an email address is not a simple update.
After the change, users must re-authenticate with the new email, and a new access token must be issued.
When automating email changes, calling additional APIs with the old token immediately after the update may result in authentication errors.
Always call the Authentication API again to obtain a new token before proceeding with subsequent requests.
Password Policy
pwd must be 6–30 characters long and include a combination of letters and numbers.
Requests that do not meet this requirement will be rejected.
When updating passwords in automated environments, ensure they are handled securely and never stored in plain text.
Key Points for Production Use
This API is not just a data update. It is a critical API that changes the account’s security state.
Updating email or password directly affects login credentials and authentication flows, and may require follow-up actions such as session invalidation, re-authentication, or security notifications.
Things to consider
Changing an email address directly affects account ownership and should be handled with care.
- Passwords must be transmitted only over secure channels (HTTPS).
- Calling this API directly from the client can introduce security risks.
- Apply a token invalidation policy immediately after the change.
- Always validate input on the server side.