MagicDoorAPI
SupportOpen MagicDoor
Property owners

Change an owner's share of a property

Rewrites the percentage an owner holds in a property. The link must already exist.

PUT
https://api.portal.magicdoor.com/company-app/properties/{propertyId}/owners/{ownerId}

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.

example: 1830472847398404097
ownerIdstringrequired

Snowflake id of the owner, from the owners endpoints.

example: 1830472847398404100

Body

application/json

ownershipPercentagenumberrequired

The owner's new share of the property, as a percentage. Not validated against the shares already on the property.

Response

200 · The updated link, with the owner, property and portfolio expanded.

ownerOwner

The owner record, in the same shape the owners endpoints return.

propertyobject

The property, expanded.

portfolioobject

The portfolio behind the property, expanded.

ownershipPercentagenumber

This owner's share of the property, as a percentage such as 50.00.

400 · `propertyId` or `ownerId` is not a decimal number. 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 or no owner with that id, or one of them belongs to another company.

How ownership is modelled

An owner is a person or company record of its own, created through the owners endpoints. Linking one to a property records a share — a percentage — and a property can carry several owners. MagicDoor does not require the shares on a property to add up to 100, so it is on you to keep them consistent.