API Reference

Generate personalized skincare routine

post
https://api.sandbox.oysterskin.com/api/v1/skin/care-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

boolean
Defaults to false

When false (default), 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 well-known external products for categories with no inventory matches.

quiz_answers
object

Optional quiz answers to provide more context about the user

Responses

Updated 4 months ago

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

Updated 4 months ago

Did this page help you?