{"openapi":"3.1.0","info":{"title":"PrintIdeas Storefront","description":"AI-readable storefront with custom printed home decor and gifts.","version":"1.1.0"},"paths":{"/products":{"get":{"summary":"Products Page","operationId":"products_page_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"XML sitemap","description":"XML sitemap","responses":{"200":{"description":"XML sitemap","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt File","operationId":"robots_txt_file_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt Public","operationId":"llms_txt_public_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/":{"get":{"summary":"Home","operationId":"home__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/catalog":{"get":{"summary":"Catalog Page","operationId":"catalog_page_catalog_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/for-agents":{"get":{"summary":"For Agents Page","operationId":"for_agents_page_for_agents_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/products/{product_id}/inspection.json":{"get":{"summary":"Product Inspection Json","operationId":"product_inspection_json_api_products__product_id__inspection_json_get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"string","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Product Inspection Json Api Products  Product Id  Inspection Json Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/{product_id}":{"get":{"summary":"Product Detail","operationId":"product_detail_products__product_id__get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"string","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products.json":{"get":{"summary":"Products Json","operationId":"products_json_products_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Products Json Products Json Get"}}}}},"description":"Simple public machine-readable product feed for AI agents and shopping assistants. No secrets, admin data, or private buyer data are exposed."}},"/api/catalog":{"get":{"summary":"Advanced agent-optimized catalog search with size and shipping filters","operationId":"catalog_api_catalog_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"product_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"}},{"name":"min_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"}},{"name":"occasion","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Occasion"}},{"name":"style","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style"}},{"name":"color","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"}},{"name":"recipient","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient"}},{"name":"ships_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ships To"}},{"name":"size","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size"}},{"name":"max_shipping_first_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Shipping First Usd"}},{"name":"min_shipping_first_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Shipping First Usd"}},{"name":"max_landed_cost_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Landed Cost Usd"}},{"name":"price_verified_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Price Verified Only"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"recommended","title":"Sort"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Primary discovery endpoint for AI agents. Supports powerful server-side filtering and sorting optimized for gift finding and cost comparison. Key parameters for agents: product_type, query, size, max_shipping_first_usd, min_shipping_first_usd, and sort (shipping_asc is recommended for cost-sensitive tasks). Returns enriched multi-category product and variant data. Mugs are one validation case, not the whole catalog model."}},"/api/products/compare":{"get":{"summary":"Products Compare","operationId":"products_compare_api_products_compare_get","parameters":[{"name":"ids","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated product IDs to compare, minimum 2 and maximum 5.","default":"","title":"Ids"},"description":"Comma-separated product IDs to compare, minimum 2 and maximum 5."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Products Compare Api Products Compare Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/compare":{"get":{"summary":"Compare Products","operationId":"compare_products_api_compare_get","parameters":[{"name":"product_ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated product IDs to compare, minimum 2 and maximum 5.","title":"Product Ids"},"description":"Comma-separated product IDs to compare, minimum 2 and maximum 5."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Compare Products Api Compare Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/catalog/facets":{"get":{"summary":"Catalog Facets","operationId":"catalog_facets_api_catalog_facets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Catalog Facets Api Catalog Facets Get"}}}}}}},"/api/collections":{"get":{"summary":"Collections Index","operationId":"collections_index_api_collections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Collections Index Api Collections Get"}}}}}}},"/api/collections/compare":{"get":{"summary":"Collections Compare","operationId":"collections_compare_api_collections_compare_get","parameters":[{"name":"slugs","in":"query","required":false,"schema":{"type":"string","default":"","title":"Slugs"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Collections Compare Api Collections Compare Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/collections/{collection_slug}":{"get":{"summary":"Collection Detail","operationId":"collection_detail_api_collections__collection_slug__get","parameters":[{"name":"collection_slug","in":"path","required":true,"schema":{"type":"string","title":"Collection Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Collection Detail Api Collections  Collection Slug  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/design-portability.json":{"get":{"summary":"Design Portability Options","operationId":"design_portability_options_api_design_portability_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Design Portability Options Api Design Portability Json Get"}}}}}}},"/api/mcp/tools":{"get":{"summary":"Get Mcp Tools","operationId":"get_mcp_tools_api_mcp_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Mcp Tools Api Mcp Tools Get"}}}}}}},"/sales-insights.json":{"get":{"summary":"Sales Insights","operationId":"sales_insights_sales_insights_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sales Insights Sales Insights Json Get"}}}}}}},"/negotiate":{"post":{"summary":"Negotiate","operationId":"negotiate_negotiate_post","parameters":[{"name":"x-agent-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Agent-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NegotiateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NegotiateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Required step before creating an order. Agent proposes a unit price (must not exceed retail price). Returns a short-lived (5 min) negotiation_token and quote snapshot identifiers. Max 3 attempts per product. See /checkout-policy.json for complete rules and limits."}},"/quote":{"post":{"summary":"Create Quote","operationId":"create_quote_quote_post","parameters":[{"name":"x-agent-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Agent-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Optional but recommended first step. Returns accurate per-variant pricing + shipping breakdown for a specific quantity and variant. Helps agents calculate real landed cost before negotiating and returns quote_id, pricing_snapshot_id, shipping_rate_snapshot_id, and quote_trace. Price and shipping must be verified."}},"/feedback":{"post":{"summary":"Submit Feedback","operationId":"submit_feedback_feedback_post","parameters":[{"name":"x-agent-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Agent-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order":{"post":{"summary":"Create Order","operationId":"create_order_order_post","parameters":[{"name":"X-Agent-API-Key","in":"header","required":true,"description":"Required for protected commerce endpoints such as POST /order and POST /negotiate. Public catalog endpoints may be accessed without this key.","schema":{"type":"string"}},{"name":"X-Idempotency-Key","in":"header","required":true,"description":"Unique key to prevent duplicate order processing.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Final step of the agent checkout flow. Requires a valid short-lived negotiation_token from /negotiate, plus X-Agent-API-Key and X-Idempotency-Key headers. Strict rules apply: US shipping only, max 10 items, max $250 value, price must be verified. Returns a checkout URL and checkout trace for human approval. The human buyer must complete payment. See /checkout-policy.json and /agent-tools.json for full rules."}},"/checkout/{order_token}":{"get":{"summary":"Get Checkout Page","operationId":"get_checkout_page_checkout__order_token__get","parameters":[{"name":"order_token","in":"path","required":true,"schema":{"type":"string","title":"Order Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/checkout/{order_token}/capture":{"post":{"summary":"Capture Payment","operationId":"capture_payment_checkout__order_token__capture_post","parameters":[{"name":"order_token","in":"path","required":true,"schema":{"type":"string","title":"Order Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Capture Payment Checkout  Order Token  Capture Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health.json":{"get":{"summary":"Health Public","operationId":"health_public_health_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Public Health Json Get"}}}}}}},"/health":{"get":{"summary":"Health Public","operationId":"health_public_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Public Health Get"}}}}}}},"/db-debug":{"get":{"summary":"Db Debug","operationId":"db_debug_db_debug_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Db Debug Db Debug Get"}}}}}}},"/admin/health":{"get":{"summary":"Health Private","operationId":"health_private_admin_health_get","parameters":[{"name":"x-agent-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Agent-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Health Private Admin Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Well Known Agent Json","operationId":"well_known_agent_json__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/ai-commerce.json":{"get":{"summary":"Well Known Ai Commerce Json","operationId":"well_known_ai_commerce_json__well_known_ai_commerce_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/agent-card.json":{"get":{"summary":"Well Known Agent Card Json","operationId":"well_known_agent_card_json__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/ai-manifest.json":{"get":{"summary":"Ai Manifest Json","operationId":"ai_manifest_json_ai_manifest_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-capabilities.json":{"get":{"summary":"Well Known Agent Capabilities Json","operationId":"well_known_agent_capabilities_json__well_known_agent_capabilities_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agent-tools.json":{"get":{"summary":"Agent Tools Json","operationId":"agent_tools_json_agent_tools_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/checkout-policy.json":{"get":{"summary":"Checkout Policy Json","operationId":"checkout_policy_json_checkout_policy_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/reputation.json":{"get":{"summary":"Reputation File","operationId":"reputation_file_reputation_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agents":{"get":{"summary":"Agents Page","operationId":"agents_page_agents_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/version.json":{"get":{"summary":"Version","operationId":"version_version_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/policies.json":{"get":{"summary":"Policies File","operationId":"policies_file_policies_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agent-policy.json":{"get":{"summary":"Agent Policy File","operationId":"agent_policy_file_agent_policy_json_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/catalog-stats.json":{"get":{"summary":"Catalog Stats","operationId":"catalog_stats_catalog_stats_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Catalog Stats Catalog Stats Json Get"}}}}}}},"/agent-guide.json":{"get":{"summary":"Agent Guide","operationId":"agent_guide_agent_guide_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Guide Agent Guide Json Get"}}}}}}},"/api/agent/mug-shipping-matrix":{"get":{"tags":["Agent Resources"],"summary":"Agent Mug Shipping Matrix","description":"Mug-specific current shipping matrix for variant validation.\n\nThis is a validation resource for one category, not the general catalog model\nand not final provider truth. Use /quote for runtime validation.\n\n11oz mugs: ~$6.99 first item, $3.99 additional.\n15oz mugs: ~$8.49 first item, $4.49 additional (heavier).\n\nThe matrix is also available as static file at /data/agent_mug_variants_matrix.json\nfor direct download and caching by agents/tools.","operationId":"agent_mug_shipping_matrix_api_agent_mug_shipping_matrix_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Mug Shipping Matrix Api Agent Mug Shipping Matrix Get"}}}}}}},"/admin/printify/shops":{"get":{"summary":"Printify Shops","operationId":"printify_shops_admin_printify_shops_get","parameters":[{"name":"X-Admin-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Printify Shops Admin Printify Shops Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sync-printify":{"post":{"summary":"Sync Printify","operationId":"sync_printify_admin_sync_printify_post","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}},{"name":"start_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Start Page"}},{"name":"max_pages","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Pages"}},{"name":"X-Admin-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync Printify Admin Sync Printify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sync-printify-background":{"post":{"summary":"Sync Printify Background","operationId":"sync_printify_background_admin_sync_printify_background_post","parameters":[{"name":"start_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Start Page"}},{"name":"max_pages","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Max Pages"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}},{"name":"X-Admin-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync Printify Background Admin Sync Printify Background Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sync-top-sales":{"post":{"summary":"Sync Top Sales","operationId":"sync_top_sales_admin_sync_top_sales_post","parameters":[{"name":"max_pages","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"default":20,"title":"Max Pages"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}},{"name":"top_sales_items","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":60,"title":"Top Sales Items"}},{"name":"X-Admin-API-Key","in":"header","required":true,"schema":{"type":"string","title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync Top Sales Admin Sync Top Sales Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/catalog-sync-status.json":{"get":{"summary":"Catalog Sync Status","operationId":"catalog_sync_status_catalog_sync_status_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Catalog Sync Status Catalog Sync Status Json Get"}}}}}}},"/recommend":{"post":{"summary":"Recommend","operationId":"recommend_recommend_post","parameters":[{"name":"x-agent-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Agent-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Buyer Intent"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CaptureRequest":{"properties":{"paypal_order_id":{"type":"string","title":"Paypal Order Id"},"payer_email":{"type":"string","title":"Payer Email"},"payment_status":{"type":"string","title":"Payment Status"}},"type":"object","required":["paypal_order_id","payer_email","payment_status"],"title":"CaptureRequest"},"CatalogResponse":{"properties":{"catalog_total":{"type":"integer","title":"Catalog Total"},"catalog_public_active":{"type":"integer","title":"Catalog Public Active"},"filtered_total":{"type":"integer","title":"Filtered Total"},"current_page_total":{"type":"integer","title":"Current Page Total"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"},"items":{"items":{"$ref":"#/components/schemas/ProductOut"},"type":"array","title":"Items"}},"type":"object","required":["catalog_total","catalog_public_active","filtered_total","current_page_total","page","limit","items"],"title":"CatalogResponse"},"FeedbackRequest":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"FeedbackRequest"},"FeedbackResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"FeedbackResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"NegotiateRequest":{"properties":{"product_id":{"type":"string","title":"Product Id"},"quantity":{"type":"integer","title":"Quantity","default":1},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant"},"proposed_unit_price":{"type":"number","title":"Proposed Unit Price"}},"type":"object","required":["product_id","proposed_unit_price"],"title":"NegotiateRequest"},"NegotiateResponse":{"properties":{"negotiation_token":{"type":"string","title":"Negotiation Token"},"valid_until":{"type":"string","format":"date-time","title":"Valid Until"},"quote_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Id"},"pricing_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Snapshot Id"},"shipping_rate_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipping Rate Snapshot Id"},"quote_trace":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quote Trace"},"checkout_policy_url":{"type":"string","title":"Checkout Policy Url","default":"/checkout-policy.json"},"next_steps":{"items":{},"type":"array","title":"Next Steps","default":[]}},"type":"object","required":["negotiation_token","valid_until"],"title":"NegotiateResponse"},"OrderRequest":{"properties":{"negotiation_token":{"type":"string","title":"Negotiation Token"},"shipping_address":{"additionalProperties":true,"type":"object","title":"Shipping Address"},"shipping_method":{"type":"string","title":"Shipping Method","default":"standard"}},"type":"object","required":["negotiation_token","shipping_address"],"title":"OrderRequest"},"OrderResponse":{"properties":{"checkout_url":{"type":"string","title":"Checkout Url","default":"https://www.paypal.com/checkoutnow?token=demo"},"checkout_policy_url":{"type":"string","title":"Checkout Policy Url","default":"/checkout-policy.json"},"status":{"type":"string","title":"Status","default":"checkout_session_created"},"next_step_for_human":{"type":"string","title":"Next Step For Human","default":"Human must approve and complete payment via PayPal"},"important":{"type":"string","title":"Important","default":"Agent must never complete payment. Human approval is mandatory."},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity"},"unit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unit Price"},"shipping_total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipping Total"},"estimated_total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Total"},"shipping_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipping Method"},"quote_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Id"},"pricing_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Snapshot Id"},"shipping_rate_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipping Rate Snapshot Id"},"checkout_trace":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Checkout Trace"},"checkout_shipping_options":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Checkout Shipping Options"},"printify_shipping_calculation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Printify Shipping Calculation"}},"type":"object","title":"OrderResponse"},"ProductOut":{"properties":{"product_id":{"type":"string","title":"Product Id"},"agent_title":{"type":"string","title":"Agent Title"},"agent_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Summary"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency","default":"USD"},"availability":{"type":"string","title":"Availability","default":"in_stock"},"ships_to":{"items":{"type":"string"},"type":"array","title":"Ships To","default":["US"]},"product_url":{"type":"string","title":"Product Url"},"product_inspection_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Inspection Url"},"product_inspection_schema_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Inspection Schema Ref"},"image_url":{"type":"string","title":"Image Url"},"checkout_requires_human":{"type":"boolean","title":"Checkout Requires Human","default":true},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style"},"styles":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Styles"},"occasion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Occasion"},"recipient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Id"},"etsy_sales_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Etsy Sales Count"},"etsy_recent_sales_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Etsy Recent Sales Count"},"etsy_last_sold_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Etsy Last Sold At"},"shipping":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Shipping"},"estimated_total_quantity_1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Total Quantity 1"},"image_display_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Display Class"},"price_verified":{"type":"boolean","title":"Price Verified","default":false},"variants":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Variants"},"images":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Images"},"agent_readiness":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Agent Readiness"},"motifs":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Motifs"},"gift_ideas":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Gift Ideas"},"fulfillment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fulfillment"},"trust_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trust Metrics"},"negative_facts":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Negative Facts"},"art_style":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Art Style"},"subject_matter":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Subject Matter"},"cultural_context":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Cultural Context"},"recipient_demographics":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Recipient Demographics"},"retail_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retail Price"}},"type":"object","required":["product_id","agent_title","agent_summary","price","product_url","image_url","product_type","style","occasion","recipient","color","variant_id"],"title":"ProductOut"},"QuoteRequest":{"properties":{"product_id":{"type":"string","title":"Product Id"},"quantity":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Quantity","default":1},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant"}},"type":"object","required":["product_id"],"title":"QuoteRequest"},"QuoteResponse":{"properties":{"quote_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Id"},"pricing_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Snapshot Id"},"shipping_rate_snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipping Rate Snapshot Id"},"quote_trace":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quote Trace"},"quoted_price":{"type":"number","title":"Quoted Price"},"valid_until":{"type":"string","format":"date-time","title":"Valid Until"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant"},"unit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unit Price"},"items_subtotal":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Items Subtotal"},"shipping_total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipping Total"},"estimated_total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Total"},"effective_total_per_item":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Effective Total Per Item"},"currency":{"type":"string","title":"Currency","default":"USD"},"shipping":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Shipping"},"production_cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Production Cost"},"retail_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retail Price"},"profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Profit"},"profit_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Profit Margin"},"price_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Source"},"price_verified":{"type":"boolean","title":"Price Verified","default":false},"checkout_policy_url":{"type":"string","title":"Checkout Policy Url","default":"/checkout-policy.json"},"next_steps":{"items":{},"type":"array","title":"Next Steps","default":[]}},"type":"object","required":["quoted_price","valid_until"],"title":"QuoteResponse"},"RecommendResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/RecommendResult"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"RecommendResponse"},"RecommendResult":{"properties":{"product_id":{"type":"string","title":"Product Id"},"agent_title":{"type":"string","title":"Agent Title"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency","default":"USD"},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"image_url":{"type":"string","title":"Image Url"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"ships_to":{"items":{"type":"string"},"type":"array","title":"Ships To","default":["US"]},"reason":{"type":"string","title":"Reason"},"confidence":{"type":"number","title":"Confidence"},"product_url":{"type":"string","title":"Product Url"}},"type":"object","required":["product_id","agent_title","price","image_url","reason","confidence","product_url"],"title":"RecommendResult"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"AgentApiKey":{"type":"apiKey","name":"X-Agent-API-Key","in":"header","description":"Required for protected commerce endpoints such as POST /order and POST /negotiate. Public catalog endpoints may be accessed without this key."}}}}