Gemstones

Submit Price Feedback

POST /api/v1/gems/{gem_id}/price-feedback — consumer 👍👎 on a scan's valuation.

Captures whether the user thinks the estimated price is too low / about right / too high, plus an optional own-price guess. Persisted to scan_price_feedback as a labeled example (with the scan's price context) for future pricing eval and the consumer 👍👎 UI (app pair feat/2026-06-09-price-feedback-ui, LNK-PFB).

Auth required; users can only give feedback on their own gems. Idempotent per gem: the latest verdict for a gem wins (re-tapping updates the same row rather than appending), so the table stays one consumer-label row per gemstone.

Body:

  • verdict: "too_low" | "about_right" | "too_high"
  • user_estimate: optional number (the user's own price guess, USD)

Returns the saved scan_price_feedback row.

post/api/v1/gems/{gem_id}/price-feedback

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/gems/{gem_id}/price-feedback
  • Auth: HTTP bearer

Path parameters

gem_idinteger required

Request body

verdict'too_low' | 'about_right' | 'too_high' required
user_estimatenumber nullable

Response

Successful Response

idinteger required
gemstone_idinteger nullable
speciesstring required
user_verdictstring nullable
user_estimatenumber nullable
estimated_price_minnumber nullable
estimated_price_maxnumber nullable
market_pricenumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.