End a lease

Ends a lease, setting its ended flag and its status to ended. Do this only when the tenancy is actually over — a lease that has run past its end date is expired, which is a normal ongoing state, and MagicDoor never ends it for you.

POST

https://api.portal.magicdoor.com/company-app/leases/{leaseId}/end

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

leaseIdstringrequired

The lease to end. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Response

200 · The lease was ended. No body is returned.

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

404 · No lease matched the id, or it belongs to another company.

Expired is not ended

An expired lease is still live in MagicDoor: charges still post and the balance still moves. Ending is a separate, deliberate act, and it is what this endpoint does.