Get Mix and Match
get_mix_and_matchBuild a complete, multi-item Mix & Match outfit widget — several coordinated looks, each with multiple garments styled together. Use this when the shopper wants a full outfit or styling help, NOT a specific named item.
Three modes: • ANCHOR mode (anchor_sku): build outfits around one specific catalog product the shopper already has/likes. • QUERY mode (query): design complete outfits from an open-ended styling request with no anchor product — every item in every look is found via catalog search. • IMAGE mode (context_image_ref): style outfits around an uploaded image. Call request_context_image first to get a ref_id, then pass it here. If query and anchor_sku are both provided, query mode takes precedence. At least one of anchor_sku, query, or context_image_ref must be supplied.
DO NOT USE for a search where the shopper names a specific item/category with no styling ask (e.g. "red shoes", "blue dress", "men's oxford shoes") — that is a plain search, not an outfit request, even if a color/occasion/price filter is attached.
Examples:
"give me an outfit for a wedding" (no item named) → query mode: { query: "outfit for a wedding" }
"style me for a beach day" → query mode: { query: "beach day outfit" }
"what goes with my blue jeans" (jeans is a specific catalog SKU already shown) → anchor mode: { anchor_sku: "" }
"complete this look" (after showing/selecting a product) → anchor mode with that SKU
(after an uploaded photo) "build an outfit around this" → image mode: { context_image_ref: "" }
"red shoes" or "blue dress under 1000" → NOT this tool, just a plain product search
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Semantic styling request, e.g. 'casual summer outfit for a beach day' or 'smart-casual look for a business dinner'. The AI stylist designs complete outfits from scratch — every item is sourced from the catalog. Required field — pass an empty string "" if not applicable. Leave empty when there is a specific anchor product or an uploaded image instead. | |
| gender | Yes | Gender of the products to search for. This is a catalog filter — NOT the user's own gender. Users may search for any gender's products regardless of who they are. Infer from context (e.g. 'men’s jacket' → MALE, 'ladies kurta' → FEMALE). If the query gives no clear signal, ask the user which gender’s products they want — do not assume. | |
| caption | No | Optional widget headline. Defaults to 'Ways to style <name>' or 'Outfits for <query>'. | |
| country | No | ISO country code the shopper is buying in, e.g. 'IN', 'US'. Scopes pricing, availability, the anchor lookup, and every complementary product search. Defaults to 'IN'. | IN |
| occasion | No | Optional occasion context, e.g. 'casual', 'party', 'work', 'wedding'. | |
| max_price | No | Optional price ceiling for items. | |
| tenant_id | No | Optional tenant identifier. Forwarded to catalog search as context.tenant_id and used to select the brand DNA that drives the stylist prompt. | |
| anchor_sku | Yes | SKU of the anchor product to build outfits around, for anchor mode. Required field — pass an empty string "" if not applicable. Leave empty when using query mode or image mode. | |
| context_image_ref | Yes | ref_id returned by request_context_image. Pass it here to style outfits around the uploaded image — no anchor_sku or query needed. Required field — pass an empty string "" if not applicable. Call request_context_image first if the user has not uploaded an image yet. |