Current user

Set the profile picture

Makes an already-uploaded image the calling property manager's profile picture, replacing whatever was there before.

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

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

uploadSessionIdstringrequired

The upload session holding the image. A Snowflake id sent as a decimal string.

Response

200 · The property manager with the new picture in `image`.

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