POST
Reject tenancy verification

Overview

Rejects a tenancy verification. Updates the verification row (reviewStatus = REJECTED, reviewedBy, reviewedAt, reviewNotes = reason) and flips users.tenancyStatus → REJECTED. A reason is required so the user has actionable feedback. Idempotent: re-rejecting an already-REJECTED row is a no-op.

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

Example payload

Response — 200 OK

Returns the updated tenancy verification row with reviewStatus: "REJECTED" and reviewNotes set.

Error responses

Example error — 400 VALIDATION_FAILED

Side effects

  • Verification row + users.tenancyStatus updated.
  • Audit-log row written (action tenancy.reject).

See also

curl

Postman

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