Widget API Reference
Rate a Generation
Record shopper feedback (thumbs up or down, with a reason) on a try-on result.
POST
Let shoppers rate a try-on result. Ratings feed the quality dashboard in the Genlook admin and help you spot products that generate poorly. If you build a custom result screen, wire your thumbs up and thumbs down buttons to this endpoint.
Request
Shop is identified via app proxy authentication.string
required
The generation ID to rate.
number
required
The shopper’s rating:
1: thumbs up-1: thumbs down0: clear a previous rating
string
Optional reason code explaining a thumbs down. One of:
distorted_bodywrong_fitface_changedwrong_colorssomething_else
Response
number
The stored rating (
1, -1, or null once cleared).string
ISO 8601 timestamp of the rating, or
null once cleared.string
The stored reason code, or
null when none was provided.Error Cases
error
The generation ID does not exist for this shop.
error
The rating could not be recorded.

