PATCH
Set cover photo

Overview

Marks the photo identified by photoId as the cover photo on the caller’s current-home listing. In a single atomic write the server sets isCover: false on every other photo and isCover: true on the target — there is always exactly one cover photo while photos.length > 0. The endpoint is idempotent: calling it with the current cover photo’s id is a no-op that returns the same listing. The cover photo is the one used as the gallery thumbnail in match cards and in conversation post-share previews — it has no effect on matching scores.

Authentication

Bearer <accessToken> required. Scope: user.

Path parameters

Query parameters

None.

Request body

None.

Response — 200 OK

Returns the updated Home object. Exactly one photo will have isCover: true.

Error responses

Example error — 404

Side effects

  • $sets photos.$[].isCover = false for every photo on the listing, then $sets isCover = true on the matched photo — both in one Mongo update.
  • updatedAt is bumped.
  • No match.recompute is triggered (cover photo does not affect matching).

See also

curl