Properties

Replace a property's magic tags

Rewrites just the property's magic tags, leaving its name, address and everything else alone. This is the narrow alternative to the full update endpoint.

PUT

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

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

magicTagsobjectrequired

The complete set of tags, as a map of string keys to string values. Send null to clear them.

Response

200 · The property with its new tags. This endpoint returns the plain property — none of the rollups the other property endpoints add.

idstring

Snowflake id of the property.

namestring

The name a property manager gave the property. Absent when the property was never named.

displayNamestring

What to show in a list: the name if there is one, otherwise streetAddress1, otherwise the literal "Unnamed Property". Computed on every read.

addressobject

The property's address. Absent when no address has been recorded.

portfolioIdstring

The portfolio this property sits in.

typeenum<string>

What kind of building this is. A singleFamily or condo property, and a townHome with exactly one unit, is treated as a single-unit property elsewhere in the API.

singleFamilymultiFamilycommercialcondotownHomeother

totalFloorsinteger

Number of floors in the building, 1 to 200. Absent when it was never set.

unitCountinteger

How many units belong to the property, active and deactivated together. Maintained by MagicDoor as units are created and deleted; you cannot set it.

recentRentalApplicationsinteger

How many rental applications naming this property arrived in the recent window. Computed; you cannot set it.

activeboolean

false once the property has been deactivated.

imageIdstring

The file behind the property's main photo. Absent when no photo has been set.

iconsstring[]

Icon keys pinned to the property. Free-form strings.

magicTagsobject

Free-form labels on the property, as a map of string keys to string values. MagicDoor stores them as given and uses them to scope things like vendor bills. Absent when none are set.

400 · The body is missing `magicTags`. 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.

422 · The property has been deactivated, so its tags cannot be changed.

What magic tags are

A magic tag is a free-form key and value a company pins to a property to slice its data its own way — a region, a fund, an accounting code. MagicDoor stores whatever you send and does not validate the keys or values. Other parts of the product read them, for example when scoping vendor bills to a subset of properties.

This replaces the whole map

Send the complete set every time. A key you leave out is removed, and sending "magicTags": null clears them all.