Unsave match
Matches
Unsave match
Remove a matched property from the caller’s saved list.
DELETE
Unsave match
Overview
Removes the matched property from the caller’s saved list by clearing the caller’s own save slot (savedByA if the caller is userA, savedByB otherwise). The other participant’s slot is never touched.
Idempotent: unsaving a match that is not currently saved is a no-op and still returns 200 with savedAt: null.
Authentication
Bearer <accessToken> required. Scope: user. Requires completed onboarding + approved tenancy (requireOnboarded).
Path parameters
| Param | Type | Notes |
|---|---|---|
matchId | string | 24-char ObjectId of the match. 400 if malformed. |
Query parameters
None.Request body
None.Response — 200 OK
| Field | Type | Notes |
|---|---|---|
matchId | string | Echo of the match id. |
savedAt | null | Always null after an unsave. |
Example response
Error responses
| Status | Code | Meaning |
|---|---|---|
| 400 | VALIDATION_FAILED | matchId is not a 24-char ObjectId. |
| 401 | UNAUTHENTICATED | Missing, malformed, or expired access token. |
| 404 | NOT_FOUND | No such match, or the caller is not a participant. |
Side effects
Clears the caller’s ownsavedByA / savedByB slot on the matches row.