Properties

Move a property to another portfolio

Reassigns a property to a different portfolio. The property's units follow it, so their portfolioId changes too.

PUT

https://api.portal.magicdoor.com/company-app/properties/{propertyId}/move

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.

Path parameters

propertyIdstringrequired

Snowflake id of the property, as a decimal string.

example: 1830472847398404097

Body

application/json

portfolioIdstringrequired

The portfolio to move the property into. Must differ from the one it is in — moving a property to the portfolio it already sits in is rejected.

Response

200 · The property was moved. The response has no body.

400 · `portfolioId` is missing, is not a decimal number, or names the portfolio the property is already in. The response carries an `errors` member mapping each rejected field name to its message.

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

404 · No property with that id, or it belongs to another company.

Request

curl --request PUT \
  --url 'https://api.portal.magicdoor.com/company-app/properties/1830472847398404097/move' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "portfolioId": "1830472847398404131"
}'

Body

{
  "portfolioId": "1830472847398404131"
}