Change the current user's password

Changes the calling property manager's password. The current password must be given and is checked before the change, and a confirmation email is sent afterwards.

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Body

application/json

currentPasswordstringrequired

The password in use now, 1 to 150 characters.

clearTextPasswordstringrequired

The new password, 5 to 150 characters.

Response

200 · The property manager whose password was changed.

idstring

The property manager. A Snowflake id sent as a decimal string.

companyIdstring

The company this property manager belongs to.

emailstring

Email address, which is also the sign-in name.

phonestring

Phone number. Absent when none was recorded.

firstNamestring

First name.

lastNamestring

Last name. Absent when none was recorded.

activeboolean

Whether the account is enabled.

createdstring · date-time

When the account was created, in the company's timezone.

lastSeenstring · date-time

When the account was last used, in the company's timezone. Absent when it never has been.

namestring

First and last name joined with a space. Computed, not stored.

imageIdstring

The file holding the profile picture. Absent when there is none.

imageobject

Pre-signed URLs for the profile picture. Absent when there is none.

401 · The access token is missing, expired, or not valid for this company.

422 · The current password did not match, or the account has been deactivated.

"Me" is the API key's owner

An API key acts as the property manager who created it. Everything under /company-app/me therefore describes that person, not the machine calling the API. If several integrations share one key, they all read and write the same profile.

This does not invalidate API keys. Access tokens already issued keep working until they expire.