Units

Move a unit to another property

Reassigns a unit to a different property. The unit's portfolioId follows its new property.

PUT

https://api.portal.magicdoor.com/company-app/units/{unitId}/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

unitIdstringrequired

Snowflake id of the unit, as a decimal string.

example: 1830472847398404098

Body

application/json

propertyIdstringrequired

The property to move the unit to. Must differ from the one it is on — moving a unit to the property it already belongs to is rejected.

Response

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

400 · `propertyId` is missing, is not a decimal number, or names the property the unit is already on. 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 unit with that id, or it belongs to another company.

Request

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

Body

{
  "propertyId": "1830472847398404132"
}