POST
Approve tenancy verification

Overview

Approves a tenancy verification. In one operation it:
  1. Updates the verification row (reviewStatus = APPROVED, reviewedBy, reviewedAt).
  2. Flips users.tenancyStatus → APPROVED.
  3. Denormalises ownerTenancyApproved = true onto the user’s active current-home listing (this is what lets the listing count toward the live-listing total).
  4. Enqueues the tenancy.approved push notification and the approval email (Phase 5 fan-out — see Push notification fan-out).
Idempotent: re-approving an already-APPROVED row is a no-op (no duplicate push/email).

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 updated tenancy verification row with reviewStatus: "APPROVED".

Error responses

Example error — 409 STATE_CONFLICT

Side effects

  • Verification row + users.tenancyStatus updated.
  • ownerTenancyApproved denormalised onto the active listing.
  • tenancy.approved push job + approval email enqueued (best-effort; failures do not roll back the approval).
  • Audit-log row written (action tenancy.approve).

See also

curl

Postman

See docs/postman/swappr.postman_collection.json → Admin Tenancy → Approve.