Unit listings

Deactivate a unit listing

Retires the listing. The unit itself is untouched — this only removes its marketing record from circulation.

DELETE

https://api.portal.magicdoor.com/company-app/unit-listings/{unitId}/deactivate

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. A unit listing has no id of its own — it is keyed by the unit it markets, so this is also the listing's id.

example: 1830472847398404098

Response

200 · The listing is now inactive. The response has no body.

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

404 · No listing for that unit, or it belongs to another company.

This is not the same as unpublishing

Setting listed to false on the update endpoint takes a listing off the market but keeps it editable. Deactivating retires the listing record, and afterwards the other listing endpoints report 404 for this unit.