DELETE
Delete listing

Overview

Soft-deletes a current-home listing. It:
  1. Sets current_homes.deletedAt = now (the row is preserved for audit; it just disappears from the public surface and the admin list).
  2. Enqueues a match recompute for the owner so any matches anchored on this listing are torn down.
Idempotent: re-deleting an already-deleted row returns the existing row without re-firing the recompute.

Authentication

Bearer <accessToken> with scope: 'admin' required (requireAdmin).
Role-gated: requires SUPER or MODERATOR. A FINANCE admin receives 403 FORBIDDEN.

Path parameters

Query parameters

None.

Request body

None.

Response — 200 OK

Returns the listing row with deletedAt set.

Error responses

Example error — 403 FORBIDDEN

Side effects

  • current_homes.deletedAt set (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

curl

Postman

See docs/postman/swappr.postman_collection.json → Admin Listings → Delete.