---
title: "Choose one favorite in a shared review set"
method: POST
path: "/api/shares/{token}/preference"
---

# Choose one favorite in a shared review set

`POST /api/shares/{token}/preference`

## Request

- Base URL: `https://api.peelaway.io`
- URL: `https://api.peelaway.io/api/shares/{token}/preference`
- Auth: one of:
  - none
  - API key in cookie `better-auth.session_token`

Requires a valid signed visit receipt bound to this link. First choice per visit wins; counts are visible to the link owner. Browser visits are not verified unique humans.

## Path parameters

- `token` string, required

## Request body

- object
  - `receipt` string, required
  - `index` integer, required
  - `anonymousId` string, uuid

## Response `200`

Preference saved or prior choice retained

## Other responses

- `400`: Unavailable option, link or receipt
- `429`: Rate limited

---

[API](https://skmtc.dev/peelaway/apis/peelaway-image-api.md) · [All operations](https://skmtc.dev/peelaway/apis/peelaway-image-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peelaway/apis/peelaway-image-api/revisions/8ce45533c9d0?raw)