Current user

Update the current user

Changes the calling property manager's name, email and phone. Every field is written, so send the current value for anything you are not changing.

PUT
https://api.portal.magicdoor.com/company-app/me

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

firstNamestringrequired

First name, 1 to 150 characters.

lastNamestring

Last name, 1 to 150 characters.

emailstring · emailrequired

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

phonestring

Phone number. Validated as a phone number.

Response

200 · The property manager after the change.

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.

"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.

Changing email changes the sign-in name for that person.