Delete listing
Listings
Delete listing
Soft-delete a listing and enqueue a match recompute for the owner. SUPER or MODERATOR only.
DELETE
Delete listing
Overview
Soft-deletes a current-home listing. It:- Sets
current_homes.deletedAt = now(the row is preserved for audit; it just disappears from the public surface and the admin list). - Enqueues a match recompute for the owner so any matches anchored on this listing are torn down.
Authentication
Bearer <accessToken> with scope: 'admin' required (requireAdmin).
Path parameters
| Name | Type | Required | Notes | Example |
|---|---|---|---|---|
id | string | yes | Listing ObjectId, 1..64 chars. | 66400a8f1c2b4d5e6f7ad000 |
Query parameters
None.Request body
None.Response — 200 OK
Returns the listing row with deletedAt set.
Error responses
| Status | Code | Meaning |
|---|---|---|
| 401 | UNAUTHENTICATED | Missing, malformed, expired, or non-admin-scope token. |
| 403 | FORBIDDEN | Caller is a FINANCE admin. |
| 404 | NOT_FOUND | No listing with that id. |
Example error — 403 FORBIDDEN
Side effects
current_homes.deletedAtset (soft delete — the row and its photos are retained).- A match-recompute job is enqueued for the owner (only on the first delete; idempotent re-deletes skip it).
- Audit-log row written (action
listings.delete).
See also
- Admin listings list — find the listing to delete.
curl
Postman
Seedocs/postman/swappr.postman_collection.json → Admin Listings → Delete.