Generate personalized skincare routine

Generate a personalized skincare routine based on skin analysis results and user onboarding data. The AI-powered, retrieval-augmented generator blends quiz signals, stored onboarding details, and available vendor inventory to create a comprehensive routine with product recommendations. Optionally provide quiz_answers to override or supplement existing user onboarding data.

For widget scans whose vendor enabled "email scan results to users", a successful response also queues the scan-result email to the user (deduplicated per scan). If generation fails due to a system error, the scan is recorded so the email can be retried out-of-band by a scheduled job — no extra request is needed from the client.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The batch ID from a previous skin analysis

string
length ≤ 64

Alias of a registered webhook endpoint to send this scan's recommendation.ready event to, instead of every subscribed endpoint. An alias, not a URL — register destinations via POST /developers/webhook-endpoints. An alias that matches no active endpoint is recorded in the delivery log and skipped; it never fails the request.

boolean | null

An explicit boolean overrides the external-product choice for this request. When omitted or null, body routines use the actual scan vendor's saved scan-settings categories.products.allow_external_body_products preference (default false). Face routines and scans without a vendor continue to default to false. When false, the routine generator will ONLY recommend products from inventory search results. Categories with no matching inventory products will be omitted entirely. When true, the generator may suggest real, well-known products outside the vendor’s catalogue for categories with no matching inventory products, including a missing body moisturizer. Body suggestions must exactly match name and brand in the supplied verified candidate list from published products at other approved stores; unverified model suggestions are omitted. External suggestions have a null product_id and may display the matched catalogue photo in product_image. They are identified in the usage explanation; they are not products sold by this vendor. This flag does not bypass ingredient safety checks. Body acids are not removed solely because a moisturizer is absent; a gentle care note is shown instead.

quiz_answers
object

Optional quiz answers to provide more context about the user

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json