{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/":{"head":{"summary":"Head","operationId":"head__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/stripe-webhook":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/clerk-webhook":{"post":{"summary":"Clerk Webhook","operationId":"clerk_webhook_clerk_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/resend-webhook":{"post":{"summary":"Resend Webhook","operationId":"resend_webhook_resend_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/companies/search":{"get":{"tags":["public"],"summary":"Get Public Companies Search Handler","description":"This endpoint is used by our Particl website, to allow public searching of records in our db, caching is performed by the frontend.","operationId":"get_public_companies_search_handler_public_companies_search_get","parameters":[{"name":"search_term","in":"query","required":true,"schema":{"type":"string","title":"Search Term"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/assets":{"post":{"tags":["public"],"summary":"Get Assets List Handler","operationId":"get_assets_list_handler_public_assets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetsListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/assets/{company_id}/{asset_id}":{"get":{"tags":["public"],"summary":"Get Asset Details Handler","operationId":"get_asset_details_handler_public_assets__company_id___asset_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/slack/send_message":{"post":{"tags":["public"],"summary":"Send Slack Message Handler","operationId":"send_slack_message_handler_public_slack_send_message_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendSlackMessagePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/free-tools/inflation/table":{"get":{"tags":["public"],"summary":"Get Inflation Table Rows Handler","operationId":"get_inflation_table_rows_handler_public_free_tools_inflation_table_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/inflation/macro-time-series":{"get":{"tags":["public"],"summary":"Get Inflation Macro Time Series Data Handler","operationId":"get_inflation_macro_time_series_data_handler_public_free_tools_inflation_macro_time_series_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/inflation/top-companies-table":{"get":{"tags":["public"],"summary":"Get Top Companies Table Data Handler","operationId":"get_top_companies_table_data_handler_public_free_tools_inflation_top_companies_table_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/bfcm-participating-companies":{"get":{"tags":["public"],"summary":"Get Report Center Participating Companies Percentage Handler","operationId":"get_report_center_participating_companies_percentage_handler_public_free_tools_report_center_bfcm_participating_companies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/top-companies":{"get":{"tags":["public"],"summary":"Get Report Center Top Companies Handler","operationId":"get_report_center_top_companies_handler_public_free_tools_report_center_top_companies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/top-campaigns":{"get":{"tags":["public"],"summary":"Get Report Center Top Campaigns Handler","operationId":"get_report_center_top_campaigns_handler_public_free_tools_report_center_top_campaigns_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/recent-campaigns":{"get":{"tags":["public"],"summary":"Get Report Center Recent Campaigns Handler","operationId":"get_report_center_recent_campaigns_handler_public_free_tools_report_center_recent_campaigns_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/avg-discount":{"get":{"tags":["public"],"summary":"Get Avg Discount Data Handler","operationId":"get_avg_discount_data_handler_public_free_tools_report_center_avg_discount_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/free-tools/report-center/companies-running-sales":{"get":{"tags":["public"],"summary":"Get Companies Running Sales Handler","operationId":"get_companies_running_sales_handler_public_free_tools_report_center_companies_running_sales_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/public/marketing_event":{"post":{"tags":["public"],"summary":"Record Marketing Event Handler","description":"Append-only marketing funnel events from particl-home (page_view, cta_click).","operationId":"record_marketing_event_handler_public_marketing_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketingEventBatchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/send_gated_report_email":{"post":{"tags":["public"],"summary":"Send Gated Report Email Handler","description":"Particl Home: email a gated report link using API Resend credentials + noreply@particl.com.","operationId":"send_gated_report_email_handler_public_send_gated_report_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendGatedReportEmailPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/create_education_account_request":{"post":{"tags":["public"],"summary":"Create Education Account Request Handler","operationId":"create_education_account_request_handler_public_create_education_account_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEducationAccountRequestPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/{audience_id}/add_contact_to_resend":{"post":{"tags":["public"],"summary":"Add Contact To Resend Handler","operationId":"add_contact_to_resend_handler_public__audience_id__add_contact_to_resend_post","parameters":[{"name":"audience_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddContactToResendPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/unsubscribe/{newsletter_type}/{uid}":{"post":{"tags":["public"],"summary":"Unsubscribe","operationId":"unsubscribe_public_unsubscribe__newsletter_type___uid__post","parameters":[{"name":"newsletter_type","in":"path","required":true,"schema":{"type":"string","title":"Newsletter Type"}},{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/communication_settings/{identifier}":{"get":{"tags":["public"],"summary":"Get Communication Setting Handler","description":"Get settings by user_id (UUID) or email token. Token links work without login.","operationId":"get_communication_setting_handler_public_communication_settings__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/communication_settings/{setting_id}":{"put":{"tags":["public"],"summary":"Update Communication Setting Handler","operationId":"update_communication_setting_handler_public_communication_settings__setting_id__put","parameters":[{"name":"setting_id","in":"path","required":true,"schema":{"type":"string","title":"Setting Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCommunicationSettingPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/images/proxy/{encoded_url}":{"get":{"tags":["images"],"summary":"Proxy Image","operationId":"proxy_image_images_proxy__encoded_url__get","parameters":[{"name":"encoded_url","in":"path","required":true,"schema":{"type":"string","title":"Encoded Url"}},{"name":"sig","in":"query","required":true,"schema":{"type":"string","title":"Sig"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/integrations/fullcart/influencers":{"get":{"tags":["integrations"],"summary":"Get Fullcart Influencers Handler","operationId":"get_fullcart_influencers_handler_integrations_fullcart_influencers_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":250,"minimum":1,"default":50,"title":"Page Size"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"min_metric_score","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Metric Score"}},{"name":"partnership_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated partnership_category values.","title":"Partnership Category"},"description":"Comma-separated partnership_category values."},{"name":"primary_topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated primary_topic values.","title":"Primary Topic"},"description":"Comma-separated primary_topic values."},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated ISO-3166-1 alpha-2 country codes.","title":"Country"},"description":"Comma-separated ISO-3166-1 alpha-2 country codes."},{"name":"has_contact","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Contact"}},{"name":"min_followers","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Followers"}},{"name":"max_followers","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Max Followers"}},{"name":"instagram_handle","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Handle"}},{"name":"tiktok_handle","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tiktok Handle"}},{"name":"influencer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Influencer Id"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated extras to hydrate per row. Supported: 'recent_posts' adds recent_posts[] (captions + engagement), 'brand_mentions' adds recent_brand_partners[] (LLM-extracted brand mentions from captions). Both are opt-in and add follow-up SingleStore queries scoped to the page's influencer_ids.","title":"Include"},"description":"Comma-separated extras to hydrate per row. Supported: 'recent_posts' adds recent_posts[] (captions + engagement), 'brand_mentions' adds recent_brand_partners[] (LLM-extracted brand mentions from captions). Both are opt-in and add follow-up SingleStore queries scoped to the page's influencer_ids."},{"name":"recent_posts_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Recent Posts Limit"}},{"name":"recent_posts_window_days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":90,"title":"Recent Posts Window Days"}},{"name":"brand_mentions_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Brand Mentions Limit"}},{"name":"brand_mentions_window_days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":90,"title":"Brand Mentions Window Days"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/integrations/fullcart/catalog/variant-snapshots":{"post":{"tags":["integrations"],"summary":"Get Fullcart Variant Snapshots Handler","operationId":"get_fullcart_variant_snapshots_handler_integrations_fullcart_catalog_variant_snapshots_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FullcartVariantSnapshotsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FullcartVariantSnapshotsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/resolve-key":{"post":{"tags":["mcp-internal"],"summary":"Resolve Mcp Key Handler","description":"Resolve an MCP API key to user_id + customer_id. Only callable with the MCP service key.","operationId":"resolve_mcp_key_handler_mcp_resolve_key_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpResolveKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/service/log-tool-call":{"post":{"tags":["mcp-internal"],"summary":"Log Mcp Tool Call Service Handler","description":"Log an MCP tool call using the service key. Does not require user auth.","operationId":"log_mcp_tool_call_service_handler_mcp_service_log_tool_call_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpServiceToolCallLogRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/list":{"post":{"tags":["assets"],"summary":"Get Assets List Handler","operationId":"get_assets_list_handler_assets_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetsListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/request-tracking":{"post":{"tags":["assets"],"summary":"Request Asset Tracking Handler","operationId":"request_asset_tracking_handler_assets_request_tracking_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTrackingRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestAssetTrackingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{company_id}/stats":{"get":{"tags":["assets"],"summary":"Get Asset Stats Handler","operationId":"get_asset_stats_handler_assets__company_id__stats_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetMetrics"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assets/{company_id}/{asset_id}":{"get":{"tags":["assets"],"summary":"Get Asset Details Handler","operationId":"get_asset_details_handler_assets__company_id___asset_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/":{"post":{"tags":["companies"],"summary":"Get Multi Company Details Handler","description":"Return active companies as meta data for use in UI display","operationId":"get_multi_company_details_handler_companies__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompaniesSetPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EnhancedCompanyDetail"},"type":"array","title":"Response Get Multi Company Details Handler Companies  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/search":{"get":{"tags":["companies"],"summary":"Company Search Handler","description":"Search for companies.","operationId":"company_search_handler_companies_search_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Page Size"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"product_term","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Term"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"default":[],"title":"Status"}},{"name":"company_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"online","title":"Company Type"}},{"name":"high_priority_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"High Priority Only"}},{"name":"dataset_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Type"}},{"name":"data_available","in":"query","required":false,"schema":{"anyOf":[{"enum":["pricing","sales","location","ratings","ai_classification"],"type":"string"},{"type":"null"}],"title":"Data Available"}},{"name":"signature_status","in":"query","required":false,"schema":{"anyOf":[{"enum":["signature","non_signature"],"type":"string"},{"type":"null"}],"title":"Signature Status"}},{"name":"company_vertical","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Vertical"}},{"name":"product_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"}},{"name":"auto_renew","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"","title":"Auto Renew"}},{"name":"is_report","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Report"}},{"name":"sort_order","in":"query","required":false,"schema":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","title":"Sort Order"}},{"name":"sort_field","in":"query","required":false,"schema":{"anyOf":[{"enum":["popularity","start_date","keyword_rank"],"type":"string"},{"type":"null"}],"default":"popularity","title":"Sort Field"}},{"name":"purchased_first","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"title":"Purchased First"}},{"name":"full_text","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"title":"Full Text"}},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"}},{"name":"exclude_data_exclusion","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Exclude Data Exclusion"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/collection/stats":{"get":{"tags":["companies"],"summary":"Company Collection Stats Handler","description":"Return some shared global stats on companies we are collecting, mainly to show off in the UI.","operationId":"company_collection_stats_handler_companies_collection_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/companies/collections":{"get":{"tags":["companies"],"summary":"Collections Handler","description":"Get all collections for the current user's group.","operationId":"collections_handler_companies_collections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyCollection"},"type":"array","title":"Response Collections Handler Companies Collections Get"}}}}}},"post":{"tags":["companies"],"summary":"Post Company Collection Handler","operationId":"post_company_collection_handler_companies_collections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCompanyCollectionPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/top_brands":{"get":{"tags":["companies"],"summary":"Top Brands Handler","description":"Get all collections for the current user's group.","operationId":"top_brands_handler_companies_top_brands_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Page Size"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"min_revenue","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"title":"Min Revenue"}},{"name":"max_revenue","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":100000000000,"title":"Max Revenue"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopBrandResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/list_purchased_companies":{"get":{"tags":["companies"],"summary":"Get List Purchased Companies Handler","operationId":"get_list_purchased_companies_handler_companies_list_purchased_companies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/companies/leaderboard":{"get":{"tags":["companies"],"summary":"Get Leaderboard Handler","operationId":"get_leaderboard_handler_companies_leaderboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/companies/purchased_competitors_stats":{"get":{"tags":["companies"],"summary":"Get Purchased Competitors Stats Handler","operationId":"get_purchased_competitors_stats_handler_companies_purchased_competitors_stats_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Page Size"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}":{"get":{"tags":["companies"],"summary":"Get Details Handler","description":"Get an individual company's details.","operationId":"get_details_handler_companies__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/mcp-summary":{"get":{"tags":["companies"],"summary":"Get Mcp Summary Handler","description":"Get enriched company summary for MCP consumption.","operationId":"get_mcp_summary_handler_companies__company_id__mcp_summary_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/preview":{"get":{"tags":["companies"],"summary":"Get Preview Handler","description":"Get an individual company's preview.","operationId":"get_preview_handler_companies__company_id__preview_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["companies"],"summary":"Post Company Preview Handler","description":"Kick off a preview QC for a company.","operationId":"post_company_preview_handler_companies__company_id__preview_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/counts":{"get":{"tags":["companies"],"summary":"Get Counts Handler","operationId":"get_counts_handler_companies__company_id__counts_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyCountsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/events/{event_id}":{"get":{"tags":["companies"],"summary":"Get Event Summary Details Handler","operationId":"get_event_summary_details_handler_companies__company_id__events__event_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/rank":{"get":{"tags":["companies"],"summary":"Get Company Rank Handler","operationId":"get_company_rank_handler_companies__company_id__rank_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/collections/{collection_id}":{"get":{"tags":["companies"],"summary":"Get Company Collection Handler","operationId":"get_company_collection_handler_companies_collections__collection_id__get","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["companies"],"summary":"Delete Company Collection Handler","operationId":"delete_company_collection_handler_companies_collections__collection_id__delete","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["companies"],"summary":"Update Company Collection Handler","operationId":"update_company_collection_handler_companies_collections__collection_id__patch","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyCollectionPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/parent_company/{parent_company_id}":{"get":{"tags":["companies"],"summary":"Get Parent Company Details Handler","operationId":"get_parent_company_details_handler_companies_parent_company__parent_company_id__get","parameters":[{"name":"parent_company_id","in":"path","required":true,"schema":{"type":"string","title":"Parent Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParentCompanyDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/diagnostics/timeseries":{"post":{"tags":["companies"],"summary":"Get Company Data Quality Diagnostics Handler","description":"Pulls diagnostics for the data quality drawer in the app","operationId":"get_company_data_quality_diagnostics_handler_companies_diagnostics_timeseries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataQualityTimeseriesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/diagnostics/summary":{"post":{"tags":["companies"],"summary":"Get Company Data Quality Diagnostics Summary Handler","operationId":"get_company_data_quality_diagnostics_summary_handler_companies_diagnostics_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataQualityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/diagnostics/product-confidence-scores":{"post":{"tags":["companies"],"summary":"Get Product Data Quality Confidence Scores Handler","description":"Per-product confidence score (0–1), same as Data Quality drawer Confidence card.","operationId":"get_product_data_quality_confidence_scores_handler_companies_diagnostics_product_confidence_scores_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDataQualityConfidenceBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/diagnostics/hidden-products":{"post":{"tags":["companies"],"summary":"Get Company Data Quality Hidden Products Handler","operationId":"get_company_data_quality_hidden_products_handler_companies_diagnostics_hidden_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataQualityPaginatedRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}/notes":{"get":{"tags":["companies"],"summary":"Get Company Notes Handler","description":"Get an individual company's notes.","operationId":"get_company_notes_handler_companies__company_id__notes_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboards/":{"get":{"tags":["dashboards"],"summary":"All Dashboards Handler","operationId":"all_dashboards_handler_dashboards__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllDashboardsResponse"}}}}}},"post":{"tags":["dashboards"],"summary":"Create New Dashboard","operationId":"create_new_dashboard_dashboards__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomDashboardBase"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboards/{dashboard_id}":{"get":{"tags":["dashboards"],"summary":"Dashboard Details Handler","operationId":"dashboard_details_handler_dashboards__dashboard_id__get","parameters":[{"name":"dashboard_id","in":"path","required":true,"schema":{"title":"Dashboard Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomDashboard-Output"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["dashboards"],"summary":"Update Dashboard Handler","operationId":"update_dashboard_handler_dashboards__dashboard_id__put","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomDashboard-Input"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["dashboards"],"summary":"Delete Dashboard Handler","operationId":"delete_dashboard_handler_dashboards__dashboard_id__delete","parameters":[{"name":"dashboard_id","in":"path","required":true,"schema":{"type":"string","title":"Dashboard Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboards/{dashboard_id}/view":{"post":{"tags":["dashboards"],"summary":"Increment Dashboard View Handler","operationId":"increment_dashboard_view_handler_dashboards__dashboard_id__view_post","parameters":[{"name":"dashboard_id","in":"path","required":true,"schema":{"type":"string","title":"Dashboard Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboards/check_cache":{"post":{"tags":["dashboards"],"summary":"Check Is Cached","operationId":"check_is_cached_dashboards_check_cache_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/events/{company_id}/list":{"post":{"tags":["events"],"summary":"Get Event Summaries List Handler","operationId":"get_event_summaries_list_handler_events__company_id__list_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsListBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/view_count":{"get":{"tags":["group"],"summary":"Get Customer View Count Handler","description":"Gets view count for a specific user","operationId":"get_customer_view_count_handler_group_view_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/subscribed_companies":{"get":{"tags":["group"],"summary":"Get Subscribed Competitors Handler","operationId":"get_subscribed_competitors_handler_group_subscribed_companies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/favorite_competitors":{"get":{"tags":["group"],"summary":"Get Favorite Competitors Handler","operationId":"get_favorite_competitors_handler_group_favorite_competitors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/list":{"get":{"tags":["group"],"summary":"Get All Customers Handler","description":"Get all groups","operationId":"get_all_customers_handler_group_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/offboard":{"post":{"tags":["group"],"summary":"Offboard Group Handler","operationId":"offboard_group_handler_group_offboard_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OffboardCustomer"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/edit_group":{"patch":{"tags":["group"],"summary":"Edit Group Handler","operationId":"edit_group_handler_group_edit_group_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupEdit"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/create_stripe_billing_session":{"post":{"tags":["group"],"summary":"Create Stripe Billing Session Handler","operationId":"create_stripe_billing_session_handler_group_create_stripe_billing_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBillingPortalSession"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/platform_subscription":{"post":{"tags":["group"],"summary":"Platform Subscription","operationId":"platform_subscription_group_platform_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCheckoutSession"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/one-time-payment":{"post":{"tags":["group"],"summary":"One Time Payment Handler","operationId":"one_time_payment_handler_group_one_time_payment_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/update_subscription":{"post":{"tags":["group"],"summary":"Update Subscription Handler","description":"Update an existing subscription to a new plan.","operationId":"update_subscription_handler_group_update_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscription"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/resubscribe_to_plan":{"post":{"tags":["group"],"summary":"Resubscribe To Plan Handler","operationId":"resubscribe_to_plan_handler_group_resubscribe_to_plan_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/customer_interests":{"get":{"tags":["group"],"summary":"Get Group Interests Handler","description":"Get the competitors that a customer is interested in and return the status of the competitors","operationId":"get_group_interests_handler_group_customer_interests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/customer_requests":{"get":{"tags":["group"],"summary":"Get Customers Requests Handler","description":"Get the customers requests from the customer_request table","operationId":"get_customers_requests_handler_group_customer_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/export-credit-pricing":{"get":{"tags":["group"],"summary":"Get Credit Pricing Handler","operationId":"get_credit_pricing_handler_group_export_credit_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/purchase-additional-credits":{"post":{"tags":["group"],"summary":"Purchase Additional Credits Handler","operationId":"purchase_additional_credits_handler_group_purchase_additional_credits_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/cancel-additional-credits":{"post":{"tags":["group"],"summary":"Cancel Additional Credits Handler","operationId":"cancel_additional_credits_handler_group_cancel_additional_credits_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/export-credit-purchases":{"get":{"tags":["group"],"summary":"Get Credit Purchases Handler","operationId":"get_credit_purchases_handler_group_export_credit_purchases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/{group_id}":{"get":{"tags":["group"],"summary":"Get Group Details Handler","description":"Get group details","operationId":"get_group_details_handler_group__group_id__get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["group"],"summary":"Delete Group Handler","description":"Permananent hard delete the contents of a group (mainly users and any customized data), leaving the group entity for our records\nwith details logged temporarily so we could reverse if needed.","operationId":"delete_group_handler_group__group_id__delete","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/{group_id}/hard-delete-preview":{"get":{"tags":["group"],"summary":"Hard Delete Preview Handler","description":"Open invoice link for hard-delete confirmation dialogs.","operationId":"hard_delete_preview_handler_group__group_id__hard_delete_preview_get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/{customer_id}/onboarding":{"post":{"tags":["group"],"summary":"Post Customer Onboarding Handler","description":"Post customer onboarding details","operationId":"post_customer_onboarding_handler_group__customer_id__onboarding_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerOnboardingFields"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/{customer_id}/onboarding/complete":{"post":{"tags":["group"],"summary":"Post Customer Onboarding Completed Handler","description":"Mark a customer as done with onboarding","operationId":"post_customer_onboarding_completed_handler_group__customer_id__onboarding_complete_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/{customer_id}/onboarding/ai-demo":{"post":{"tags":["group"],"summary":"Post Onboarding Ai Demo Handler","description":"Stream an AI-powered demo insight during onboarding","operationId":"post_onboarding_ai_demo_handler_group__customer_id__onboarding_ai_demo_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiDemoRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/{group_id}/view_requests":{"get":{"tags":["group"],"summary":"Get Customer Requests Handler","operationId":"get_customer_requests_handler_group__group_id__view_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/end_free_trial_now":{"post":{"tags":["group"],"summary":"End Free Trial Now Handler","operationId":"end_free_trial_now_handler_group_end_free_trial_now_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/group/request_additional_seats":{"post":{"tags":["group"],"summary":"Request Additional Competitor Handler","operationId":"request_additional_competitor_handler_group_request_additional_seats_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/share/url":{"post":{"tags":["group"],"summary":"Post Share Url Handler","operationId":"post_share_url_handler_group_share_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareUrlBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/reports/list":{"get":{"tags":["group"],"summary":"List Reports Handler","operationId":"list_reports_handler_group_reports_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListReportsResponse"}}}}}}},"/group/reports/{report_id}/download":{"get":{"tags":["group"],"summary":"Download Report Handler","operationId":"download_report_handler_group_reports__report_id__download_get","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","title":"Report Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadReportRespsonse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/upvote":{"post":{"tags":["group"],"summary":"Request Company Handler","operationId":"request_company_handler_group_upvote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpvoteCompanyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/add_competitor":{"post":{"tags":["group"],"summary":"Add Competitor Handler","operationId":"add_competitor_handler_group_add_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddOrRemoveCompetitorBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/remove_competitor":{"post":{"tags":["group"],"summary":"Remove Competitor Handler","operationId":"remove_competitor_handler_group_remove_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddOrRemoveCompetitorBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/downgrade_competitors":{"post":{"tags":["group"],"summary":"Downgrade Competitors Handler","operationId":"downgrade_competitors_handler_group_downgrade_competitors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DowngradeCompetitorsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/favorite_competitor":{"post":{"tags":["group"],"summary":"Favorite Competitor Handler","operationId":"favorite_competitor_handler_group_favorite_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFavoriteCompetitor"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/unfavorite_competitor":{"post":{"tags":["group"],"summary":"Unfavorite Competitor Handler","operationId":"unfavorite_competitor_handler_group_unfavorite_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFavoriteCompetitor"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/customer_view_log":{"post":{"tags":["group"],"summary":"Post Customer View Log Handler","operationId":"post_customer_view_log_handler_group_customer_view_log_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerViewPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/company_id_representing_customer":{"post":{"tags":["group"],"summary":"Post Company Id Representing Customer Handler","operationId":"post_company_id_representing_customer_handler_group_company_id_representing_customer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyIdRepresentingCustomerBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/cancel_subscription":{"post":{"tags":["group"],"summary":"Cancel Stripe Subscription Handler","operationId":"cancel_stripe_subscription_handler_group_cancel_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelSubscriptionBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/group/accept_retention_offer":{"post":{"tags":["group"],"summary":"Accept Retention Offer Handler","operationId":"accept_retention_offer_handler_group_accept_retention_offer_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/market/research/details":{"post":{"tags":["market"],"summary":"Get Market Details Handler","operationId":"get_market_details_handler_market_research_details_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/sales":{"post":{"tags":["market"],"summary":"Get Market Sales Handler","operationId":"get_market_sales_handler_market_research_sales_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketSalesDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/top_products":{"post":{"tags":["market"],"summary":"Get Market Top Products Handler","operationId":"get_market_top_products_handler_market_research_top_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketTopProductsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/pricing":{"post":{"tags":["market"],"summary":"Get Market Pricing Handler","operationId":"get_market_pricing_handler_market_research_pricing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketPricingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/top_companies":{"post":{"tags":["market"],"summary":"Get Market Top Companies Handler","operationId":"get_market_top_companies_handler_market_research_top_companies_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketTopCompaniesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/product_types":{"post":{"tags":["market"],"summary":"Get Product Types Handler","operationId":"get_product_types_handler_market_research_product_types_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/research/trends":{"post":{"tags":["market"],"summary":"Get Trend Handler","operationId":"get_trend_handler_market_research_trends_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResearchTrendPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/product_tag_search":{"post":{"tags":["market"],"summary":"Get Product Tag Search Handler","description":"Get total count for all tags across all companies","operationId":"get_product_tag_search_handler_market_product_tag_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketProductTagSearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/user-info":{"get":{"tags":["mcp"],"summary":"Get Mcp User Info","description":"Return the authenticated user's identity for the MCP server.","operationId":"get_mcp_user_info_mcp_user_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/company-access/{company_id}":{"get":{"tags":["mcp"],"summary":"Get Mcp Company Access Handler","description":"Return whether a company is blocked by global customer data exclusion.","operationId":"get_mcp_company_access_handler_mcp_company_access__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/onboarding-status":{"get":{"tags":["mcp"],"summary":"Get Mcp Onboarding Status","description":"Return first-session sample prompts and follow-ups for MCP assistant clients.","operationId":"get_mcp_onboarding_status_mcp_onboarding_status_get","parameters":[{"name":"minimal","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Minimal"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/record-usage":{"post":{"tags":["mcp"],"summary":"Record Mcp Usage Handler","description":"Check credits and record MCP tool usage. Returns error if insufficient credits.","operationId":"record_mcp_usage_handler_mcp_record_usage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpUsageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/log-tool-call":{"post":{"tags":["mcp"],"summary":"Log Mcp Tool Call Handler","description":"Log an MCP tool call for observability tracking.","operationId":"log_mcp_tool_call_handler_mcp_log_tool_call_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpToolCallLogRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/usage":{"get":{"tags":["mcp"],"summary":"Get Mcp Usage Handler","description":"Paginated list of MCP usage records for the customer.","operationId":"get_mcp_usage_handler_mcp_usage_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Page Size"}},{"name":"tool_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpUsageListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/usage/summary":{"get":{"tags":["mcp"],"summary":"Get Mcp Usage Summary Handler","description":"Aggregated MCP usage summary with breakdowns by tool and user.","operationId":"get_mcp_usage_summary_handler_mcp_usage_summary_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpUsageSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/usage/timeseries":{"get":{"tags":["mcp"],"summary":"Get Mcp Usage Timeseries Handler","description":"Daily credit usage time-series for charting.","operationId":"get_mcp_usage_timeseries_handler_mcp_usage_timeseries_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpUsageTimeseriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/products":{"post":{"tags":["products"],"summary":"Get Product Research Products Handler","operationId":"get_product_research_products_handler_products_research_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTableResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/variants":{"post":{"tags":["products"],"summary":"Get Product Research Variants Handler","operationId":"get_product_research_variants_handler_products_research_variants_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LooseProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductVariantsResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/stats":{"post":{"tags":["products"],"summary":"Get Post Product Elasticity Scores","operationId":"get_post_product_elasticity_scores_products_research_stats_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductsStatsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProductsStatsResponse"},"type":"array","title":"Response Get Post Product Elasticity Scores Products Research Stats Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/timeseries":{"post":{"tags":["products"],"summary":"Get Product Research Timeseries Handler","operationId":"get_product_research_timeseries_handler_products_research_timeseries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingEventResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchTimeseriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/ratings/buckets":{"post":{"tags":["products"],"summary":"Get Ratings Buckets Handler","operationId":"get_ratings_buckets_handler_products_research_ratings_buckets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/companies":{"post":{"tags":["products"],"summary":"Get Product Research Companies Handler","operationId":"get_product_research_companies_handler_products_research_companies_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchCompanyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/locations":{"post":{"tags":["products"],"summary":"Get Product Research Locations Handler","operationId":"get_product_research_locations_handler_products_research_locations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/gender":{"post":{"tags":["products"],"summary":"Get Product Research Genders Handler","operationId":"get_product_research_genders_handler_products_research_gender_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTagGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchTagGroupingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/product_type":{"post":{"tags":["products"],"summary":"Get Product Research Product Types Handler","operationId":"get_product_research_product_types_handler_products_research_product_type_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTypeGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchProductTypesGroupingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/customer_product_type":{"post":{"tags":["products"],"summary":"Get Product Research Customer Product Types Handler","operationId":"get_product_research_customer_product_types_handler_products_research_customer_product_type_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchProductTypesGroupingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/customer_similar_products":{"post":{"tags":["products"],"summary":"Get Product Research Customer Similar Products Handler","operationId":"get_product_research_customer_similar_products_handler_products_research_customer_similar_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarProductsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/customer_missing_products":{"post":{"tags":["products"],"summary":"Get Customer Missing Products Handler","operationId":"get_customer_missing_products_handler_products_research_customer_missing_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MissingProductResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/customer_search":{"get":{"tags":["products"],"summary":"Get Customer Product Search Handler","operationId":"get_customer_product_search_handler_products_customer_search_get","parameters":[{"name":"search","in":"query","required":true,"schema":{"type":"string","title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerProductSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/customer_companies":{"post":{"tags":["products"],"summary":"Get Product Research Customer Company Handler","operationId":"get_product_research_customer_company_handler_products_research_customer_companies_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBenchmarkCompanyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/customer_timeseries":{"post":{"tags":["products"],"summary":"Get Product Research Customer Timeseries Handler","operationId":"get_product_research_customer_timeseries_handler_products_research_customer_timeseries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchTimeseriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/pivot":{"post":{"tags":["products"],"summary":"Get Product Research Product Pivot Handler","operationId":"get_product_research_product_pivot_handler_products_research_pivot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchPivotBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchPivotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/keyword":{"post":{"tags":["products"],"summary":"Get Product Research Keywords Handler","operationId":"get_product_research_keywords_handler_products_research_keyword_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTagGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchTagGroupingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/material":{"post":{"tags":["products"],"summary":"Get Product Research Materials Handler","operationId":"get_product_research_materials_handler_products_research_material_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTagGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchTagGroupingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/colors":{"post":{"tags":["products"],"summary":"Get Product Research Colors Handler","operationId":"get_product_research_colors_handler_products_research_colors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ColorResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/brands":{"post":{"tags":["products"],"summary":"Get Product Research Brands Handler","operationId":"get_product_research_brands_handler_products_research_brands_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTagGroupingResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandsResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/prices":{"post":{"tags":["products"],"summary":"Get Product Research Prices Handler","operationId":"get_product_research_prices_handler_products_research_prices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchPricesBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricesResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/variants":{"get":{"tags":["products"],"summary":"Variants Handler","operationId":"variants_handler_products_variants_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"product_id","in":"query","required":true,"schema":{"type":"string","title":"Product Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/collections":{"get":{"tags":["products"],"summary":"Get Product Collections Handler","description":"Get groups collections","operationId":"get_product_collections_handler_products_research_collections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["products"],"summary":"Post Product Collections Handler","operationId":"post_product_collections_handler_products_research_collections_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostProductCollectionBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["products"],"summary":"Put Product Collections Handler","operationId":"put_product_collections_handler_products_research_collections_put","parameters":[{"name":"collection_id","in":"query","required":true,"schema":{"type":"string","title":"Collection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutProductCollectionBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["products"],"summary":"Delete Product Collections Handler","operationId":"delete_product_collections_handler_products_research_collections_delete","parameters":[{"name":"collection_id","in":"query","required":true,"schema":{"type":"string","title":"Collection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/presets":{"get":{"tags":["products"],"summary":"Get All Presets","operationId":"get_all_presets_products_presets_get","parameters":[{"name":"page_location_id","in":"query","required":true,"schema":{"type":"string","title":"Page Location Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["products"],"summary":"Post Preset","operationId":"post_preset_products_presets_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresetBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/presets/{preset_id}":{"delete":{"tags":["products"],"summary":"Delete Preset Handler","operationId":"delete_preset_handler_products_presets__preset_id__delete","parameters":[{"name":"preset_id","in":"path","required":true,"schema":{"type":"string","title":"Preset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/customer/{customer_product_id}":{"get":{"tags":["products"],"summary":"Get Customer Product Handler","description":"Get details and sales for a customer product","operationId":"get_customer_product_handler_products_customer__customer_product_id__get","parameters":[{"name":"customer_product_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Product Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/{company_id}/{product_id}":{"get":{"tags":["products"],"summary":"Get Product Details Handler","description":"Get product details for a given company and product ID.","operationId":"get_product_details_handler_products__company_id___product_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/search":{"get":{"tags":["products"],"summary":"Get Product Search Handler","description":"Find matching products from a search term for a company.","operationId":"get_product_search_handler_products_search_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"title","in":"query","required":true,"schema":{"type":"string","title":"Title"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Page Size"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/confidence_score_buckets":{"get":{"tags":["products"],"summary":"Get Confidence Score Buckets Handler","operationId":"get_confidence_score_buckets_handler_products_confidence_score_buckets_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"company_ids","in":"query","required":true,"schema":{"type":"string","title":"Company Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/collections/{collection_id}":{"get":{"tags":["products"],"summary":"Get Product Collection Handler","description":"Get product collection","operationId":"get_product_collection_handler_products_research_collections__collection_id__get","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["products"],"summary":"Patch Saved Product Collection Handler","operationId":"patch_saved_product_collection_handler_products_research_collections__collection_id__patch","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchSavedProductCollectionBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["products"],"summary":"Remove Products Product Collection Handler","operationId":"remove_products_product_collection_handler_products_research_collections__collection_id__put","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveProductsProductCollectionBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/products/research/timeseries_report":{"post":{"tags":["products"],"summary":"Get Product Research Product Timeseries Handler","operationId":"get_product_research_product_timeseries_handler_products_research_timeseries_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTimeseriesBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-explorer/research":{"post":{"tags":["product-explorer"],"summary":"Get Product Explorer Research Handler","operationId":"get_product_explorer_research_handler_product_explorer_research_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductExplorerResearchPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/root-nodes":{"get":{"tags":["product-type"],"summary":"Get Taxonomy Roots","operationId":"get_taxonomy_roots_product_type_taxonomy_root_nodes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/product-type/taxonomy/search":{"get":{"tags":["product-type"],"summary":"Get Taxonomy Search Handler","operationId":"get_taxonomy_search_handler_product_type_taxonomy_search_get","parameters":[{"name":"search_term","in":"query","required":true,"schema":{"type":"string","title":"Search Term"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/mcp/root-nodes":{"get":{"tags":["product-type"],"summary":"Get Mcp Taxonomy Roots","operationId":"get_mcp_taxonomy_roots_product_type_taxonomy_mcp_root_nodes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/product-type/taxonomy/mcp/{product_type_id}/children":{"get":{"tags":["product-type"],"summary":"Get Mcp Product Type Children","operationId":"get_mcp_product_type_children_product_type_taxonomy_mcp__product_type_id__children_get","parameters":[{"name":"product_type_id","in":"path","required":true,"schema":{"type":"string","title":"Product Type Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/{product_type_id}/children":{"get":{"tags":["product-type"],"summary":"Get Product Type Child Nodes","operationId":"get_product_type_child_nodes_product_type_taxonomy__product_type_id__children_get","parameters":[{"name":"product_type_id","in":"path","required":true,"schema":{"type":"string","title":"Product Type Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/{product_type_id}/ancestors":{"get":{"tags":["product-type"],"summary":"Get Product Type Ancestor Nodes","operationId":"get_product_type_ancestor_nodes_product_type_taxonomy__product_type_id__ancestors_get","parameters":[{"name":"product_type_id","in":"path","required":true,"schema":{"type":"string","title":"Product Type Id"}},{"name":"include_self","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Self"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/names":{"get":{"tags":["product-type"],"summary":"Get Node Names","operationId":"get_node_names_product_type_taxonomy_names_get","parameters":[{"name":"product_type_ids","in":"query","required":true,"schema":{"type":"string","title":"Product Type Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductTypeNameResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/taxonomy/custom-product-types":{"get":{"tags":["product-type"],"summary":"Get Custom Product Types","operationId":"get_custom_product_types_product_type_taxonomy_custom_product_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/product-type/{product_type_id}":{"get":{"tags":["product-type"],"summary":"Get Product Type Details","operationId":"get_product_type_details_product_type__product_type_id__get","parameters":[{"name":"product_type_id","in":"path","required":true,"schema":{"type":"string","title":"Product Type Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["product-type"],"summary":"Delete Product Type Handler","operationId":"delete_product_type_handler_product_type__product_type_id__delete","parameters":[{"name":"product_type_id","in":"path","required":true,"schema":{"type":"string","title":"Product Type Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["product-type"],"summary":"Update Product Type Handler","operationId":"update_product_type_handler_product_type__product_type_id__put","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductType"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/product_override/products":{"post":{"tags":["product-type"],"summary":"Get Products To Override","operationId":"get_products_to_override_product_type_product_override_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/product_override":{"post":{"tags":["product-type"],"summary":"Post Override Products Product Type Handler","operationId":"post_override_products_product_type_handler_product_type_product_override_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductProductTypeOverride"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["product-type"],"summary":"Delete Override Product Product Type Handler","operationId":"delete_override_product_product_type_handler_product_type_product_override_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductProductTypeOverride"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/search":{"post":{"tags":["product-type"],"summary":"Search Products Types","operationId":"search_products_types_product_type_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchProductTypes"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-type/":{"post":{"tags":["product-type"],"summary":"Create Product Type Handler","operationId":"create_product_type_handler_product_type__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductType"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/promo-codes/validate":{"post":{"tags":["promo-codes"],"summary":"Validate Promo Code Handler","description":"Validate a promo code\n\nChecks if the promo code is:\n- Valid and exists\n- Active\n- Not expired\n- Within usage limits\n- Applicable to the specified plan (if provided)","operationId":"validate_promo_code_handler_promo_codes_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatePromoCodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatePromoCodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment/research/distribution":{"post":{"tags":["sentiment"],"summary":"Get Product Research Prices Handler","operationId":"get_product_research_prices_handler_sentiment_research_distribution_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/invite-newsletter-user":{"post":{"tags":["user"],"summary":"Invite Newsletter User Handler","description":"Endpoint to invite a newsletter user to a Particl user since Clerk doesn't support using production api key locally","operationId":"invite_newsletter_user_handler_user_invite_newsletter_user_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrateNewsletterUserPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/current":{"get":{"tags":["user"],"summary":"Get User Handler","description":"Retrieve current user.","operationId":"get_user_handler_user_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}}}},"delete":{"tags":["user"],"summary":"Delete User Handler","description":"Deletes a user. Provide either user_id or email (and group_id).","operationId":"delete_user_handler_user_current_delete","parameters":[{"name":"group_id","in":"query","required":true,"schema":{"type":"string","title":"Group Id"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["user"],"summary":"Post User Handler","description":"Creates a user.","operationId":"post_user_handler_user_current_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewUserPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["user"],"summary":"Put User Handler","description":"Updates fields on a user.","operationId":"put_user_handler_user_current_put","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/delete-by-email":{"post":{"tags":["user"],"summary":"Delete User By Email Handler","description":"Deletes a user by email and group_id. Use this instead of DELETE with query params to avoid 422 from gateways that strip query strings on DELETE.","operationId":"delete_user_by_email_handler_user_delete_by_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteUserByEmailPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/transfer-invite/preview":{"get":{"tags":["user"],"summary":"Preview Transfer Invite Handler","operationId":"preview_transfer_invite_handler_user_transfer_invite_preview_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/transfer-invites/pending":{"get":{"tags":["user"],"summary":"Get Pending Transfer Invite Handler","operationId":"get_pending_transfer_invite_handler_user_transfer_invites_pending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/user/transfer-invite/accept":{"post":{"tags":["user"],"summary":"Accept Transfer Invite Handler","operationId":"accept_transfer_invite_handler_user_transfer_invite_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptTransferInvitePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/update_user":{"put":{"tags":["user"],"summary":"Update Other User Handler","description":"Updates another user's type with proper permission checks.","operationId":"update_other_user_handler_user_update_user_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOtherUserPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/apitoken/get_token":{"post":{"tags":["user"],"summary":"Post Token Handler","description":"Create a new API token.","operationId":"post_token_handler_user_apitoken_get_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/user/apitoken/get_mcp_token":{"post":{"tags":["user"],"summary":"Post Mcp Token Handler","description":"Create a new MCP-only API token. This key works only through the MCP server\nand cannot be used directly against the API.","operationId":"post_mcp_token_handler_user_apitoken_get_mcp_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/user/apitoken/revoke_token":{"delete":{"tags":["user"],"summary":"Delete Token Handler","description":"Revoke a user's API token.","operationId":"delete_token_handler_user_apitoken_revoke_token_delete","parameters":[{"name":"api_token","in":"query","required":true,"schema":{"type":"string","title":"Api Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/log":{"post":{"tags":["user"],"summary":"Post User Log Handler","description":"Log a user's activity and cookie.","operationId":"post_user_log_handler_user_log_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/user/subscription_report":{"get":{"tags":["user"],"summary":"Get Subscribed Reports","description":"Retrieve a list of reports the user is subscribed to.","operationId":"get_subscribed_reports_user_subscription_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSubcribedReportResponse"}}}}}}},"/user/subscription_report/{collection_id}":{"post":{"tags":["user"],"summary":"Post Change Subscription Status","description":"Subscribe a user to a report.","operationId":"post_change_subscription_status_user_subscription_report__collection_id__post","parameters":[{"name":"collection_id","in":"path","required":true,"schema":{"type":"string","title":"Collection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSubscribedReportPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/report_subscriptions":{"get":{"tags":["user"],"summary":"Get All User Report Subscriptions","operationId":"get_all_user_report_subscriptions_user_report_subscriptions_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["user"],"summary":"Post Report Subscription","operationId":"post_report_subscription_user_report_subscriptions_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportSubscriptionPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/report_subscriptions/{report_id}":{"delete":{"tags":["user"],"summary":"Delete Report Subscription","description":"Revoke a user's API token.","operationId":"delete_report_subscription_user_report_subscriptions__report_id__delete","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","title":"Report Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["user"],"summary":"Update Report Subscription","description":"Update an existing report subscription.","operationId":"update_report_subscription_user_report_subscriptions__report_id__put","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","title":"Report Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportSubscriptionPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/communication_settings":{"get":{"tags":["user"],"summary":"Get User Communication Settings","description":"Get all communication settings for the current user.","operationId":"get_user_communication_settings_user_communication_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CommunicationSettingResponse"},"type":"array","title":"Response Get User Communication Settings User Communication Settings Get"}}}}}},"post":{"tags":["user"],"summary":"Create User Communication Setting","description":"Create a new communication setting for the current user.","operationId":"create_user_communication_setting_user_communication_settings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunicationSettingPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/communication_settings/{setting_id}":{"put":{"tags":["user"],"summary":"Update User Communication Setting","description":"Update an existing communication setting for the current user.","operationId":"update_user_communication_setting_user_communication_settings__setting_id__put","parameters":[{"name":"setting_id","in":"path","required":true,"schema":{"type":"string","title":"Setting Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunicationSettingPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/event":{"post":{"tags":["user"],"summary":"Post User Event Handler","description":"Log a user's event.","operationId":"post_user_event_handler_user_event_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/offers":{"get":{"tags":["user"],"summary":"Get User Offers Handler","operationId":"get_user_offers_handler_user_offers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/trends/overview":{"post":{"tags":["trends"],"summary":"Get Overview Trends Handler","operationId":"get_overview_trends_handler_trends_overview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}":{"get":{"tags":["trends"],"summary":"Get Trend Handler","operationId":"get_trend_handler_trends__trend_id__get","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}},{"name":"timeline","in":"query","required":false,"schema":{"type":"string","default":"one_year","title":"Timeline"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/top_products":{"post":{"tags":["trends"],"summary":"Get Trend Top Products Handler","operationId":"get_trend_top_products_handler_trends__trend_id__top_products_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendDetailsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/product_counts":{"post":{"tags":["trends"],"summary":"Get Trend Product Counts Handler","operationId":"get_trend_product_counts_handler_trends__trend_id__product_counts_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendDetailsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/product_prices":{"post":{"tags":["trends"],"summary":"Get Trend Product Prices Handler","operationId":"get_trend_product_prices_handler_trends__trend_id__product_prices_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendDetailsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/market_share":{"post":{"tags":["trends"],"summary":"Get Trend Market Share Handler","operationId":"get_trend_market_share_handler_trends__trend_id__market_share_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendDetailsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/product_types":{"post":{"tags":["trends"],"summary":"Get Trend Product Types Handler","operationId":"get_trend_product_types_handler_trends__trend_id__product_types_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendDetailsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends/{trend_id}/ai_summary":{"post":{"tags":["trends"],"summary":"Get Trend Ai Summary Handler","operationId":"get_trend_ai_summary_handler_trends__trend_id__ai_summary_post","parameters":[{"name":"trend_id","in":"path","required":true,"schema":{"type":"string","title":"Trend Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/users/unsubscribe-communications":{"post":{"tags":["internal"],"summary":"Internal Unsubscribe Communications Handler","operationId":"internal_unsubscribe_communications_handler_internal_users_unsubscribe_communications_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalUnsubscribeCommunicationsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/users/notification-subscriptions-preview":{"post":{"tags":["internal"],"summary":"Internal Notification Subscriptions Preview Handler","operationId":"internal_notification_subscriptions_preview_handler_internal_users_notification_subscriptions_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalNotificationPreviewBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/pending_customers":{"get":{"tags":["internal"],"summary":"Get Pending Customers Handler","operationId":"get_pending_customers_handler_internal_pending_customers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/pending_customers/approval_status":{"post":{"tags":["internal"],"summary":"Approve Status Pending Customer Handler","operationId":"approve_status_pending_customer_handler_internal_pending_customers_approval_status_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerApprovalPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/{customer_id}/clear_rate_limit":{"post":{"tags":["internal"],"summary":"Clear Rate Limit Handler","operationId":"clear_rate_limit_handler_internal__customer_id__clear_rate_limit_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/{customer_id}/clear_customer_cache":{"post":{"tags":["internal"],"summary":"Clear Group Cache Handler","operationId":"clear_group_cache_handler_internal__customer_id__clear_customer_cache_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customer_views":{"get":{"tags":["internal"],"summary":"Get Customer Views Handler","operationId":"get_customer_views_handler_internal_customer_views_get","parameters":[{"name":"customer_id","in":"query","required":true,"schema":{"type":"string","title":"Customer Id"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"series","in":"query","required":false,"schema":{"enum":["views","logins"],"type":"string","default":"views","title":"Series"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/mcp_customer_views":{"get":{"tags":["internal"],"summary":"Get Mcp Customer Views Handler","operationId":"get_mcp_customer_views_handler_internal_mcp_customer_views_get","parameters":[{"name":"customer_id","in":"query","required":true,"schema":{"type":"string","title":"Customer Id"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_insights/{company_id}/diagnostics":{"get":{"tags":["internal"],"summary":"Get Diagnostics Handler","operationId":"get_diagnostics_handler_internal_data_insights__company_id__diagnostics_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_quality_flags_by_type":{"get":{"tags":["internal"],"summary":"Get Data Quality Flags By Type Handler","operationId":"get_data_quality_flags_by_type_handler_internal_data_quality_flags_by_type_get","parameters":[{"name":"flag_type","in":"query","required":true,"schema":{"type":"string","description":"data_quality.type value","title":"Flag Type"},"description":"data_quality.type value"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_quality_resolve_flag":{"post":{"tags":["internal"],"summary":"Data Quality Resolve Flag Handler","operationId":"data_quality_resolve_flag_handler_internal_data_quality_resolve_flag_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataQualityFlagPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_quality_hide_product":{"post":{"tags":["internal"],"summary":"Data Quality Hide Product Handler","operationId":"data_quality_hide_product_handler_internal_data_quality_hide_product_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataQualityFlagPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_insights/company_trend_metrics":{"get":{"tags":["internal"],"summary":"Get Company Trends Metrics Handler","operationId":"get_company_trends_metrics_handler_internal_data_insights_company_trend_metrics_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"yoy_sales_revenue_trend","title":"Sort By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_insights/{company_id}/variant_event_timeseries_metrics":{"get":{"tags":["internal"],"summary":"Get Variant Event Timeseries Handler","operationId":"get_variant_event_timeseries_handler_internal_data_insights__company_id__variant_event_timeseries_metrics_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_insights/{company_id}/details":{"get":{"tags":["internal"],"summary":"Get Company Data Insights Handler","operationId":"get_company_data_insights_handler_internal_data_insights__company_id__details_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_insights/{company_id}/requests_history":{"get":{"tags":["internal"],"summary":"Get Requests History Handler","operationId":"get_requests_history_handler_internal_data_insights__company_id__requests_history_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/test_script":{"post":{"tags":["internal"],"summary":"Run Test Script","operationId":"run_test_script_internal_test_script_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/email_logs":{"get":{"tags":["internal"],"summary":"Get Email Logs Handler","operationId":"get_email_logs_handler_internal_customers__customer_id__email_logs_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/users/{user_id}/merge":{"post":{"tags":["internal"],"summary":"Merge User Handler","operationId":"merge_user_handler_internal_customers__customer_id__users__user_id__merge_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MergePayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/cookie_logs_count":{"get":{"tags":["internal"],"summary":"Get Group Cookie Logs Count Handler","operationId":"get_group_cookie_logs_count_handler_internal_customers__customer_id__cookie_logs_count_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/login_counts":{"get":{"tags":["internal"],"summary":"Get Group Login Counts Handler","operationId":"get_group_login_counts_handler_internal_customers__customer_id__login_counts_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/login_counts_past_30_days":{"get":{"tags":["internal"],"summary":"Get Group Login Counts Past 30 Days Handler","operationId":"get_group_login_counts_past_30_days_handler_internal_customers__customer_id__login_counts_past_30_days_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/cookie_logs/{user_id}":{"get":{"tags":["internal"],"summary":"Get Cookie Logs Handler","operationId":"get_cookie_logs_handler_internal_customers__customer_id__cookie_logs__user_id__get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/onboarding_fields":{"get":{"tags":["internal"],"summary":"Get Customer Onboarding Fields Handler","operationId":"get_customer_onboarding_fields_handler_internal_customers__customer_id__onboarding_fields_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/timeline_events":{"post":{"tags":["internal"],"summary":"Get Customer Timeline Events Handler","operationId":"get_customer_timeline_events_handler_internal_customers__customer_id__timeline_events_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineEventPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/customers/{customer_id}/total_company_views":{"get":{"tags":["internal"],"summary":"Get Customer Total Company Views Handler","operationId":"get_customer_total_company_views_handler_internal_customers__customer_id__total_company_views_get","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/change_company_date":{"post":{"tags":["internal"],"summary":"Change Company Start Date Handler","operationId":"change_company_start_date_handler_internal_change_company_date_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeCompanyDateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/delete_customer":{"post":{"tags":["internal"],"summary":"Delete Customer Handler","operationId":"delete_customer_handler_internal_delete_customer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCustomerPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/create_special_account":{"post":{"tags":["internal"],"summary":"Create Special Account Handler","operationId":"create_special_account_handler_internal_create_special_account_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSpecialAccountPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data_center/pbsr_revenue_batch":{"post":{"tags":["internal"],"summary":"Get Pbsr Revenue Batch Handler","description":"Return revenue per company for event_date using product research (matches products page).","operationId":"get_pbsr_revenue_batch_handler_internal_data_center_pbsr_revenue_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PbsrRevenueBatchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/get_products_to_hide":{"post":{"tags":["internal"],"summary":"Get Products To Hide Handler","operationId":"get_products_to_hide_handler_internal_get_products_to_hide_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/get_hidden_products":{"post":{"tags":["internal"],"summary":"Get Hidden Products Handler","operationId":"get_hidden_products_handler_internal_get_hidden_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/hide_products":{"post":{"tags":["internal"],"summary":"Hide Products Handler","operationId":"hide_products_handler_internal_hide_products_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/unhide_products":{"post":{"tags":["internal"],"summary":"Unhide Products Handler","operationId":"unhide_products_handler_internal_unhide_products_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/mcp_usage":{"get":{"tags":["internal"],"summary":"Get Internal Mcp Usage Handler","operationId":"get_internal_mcp_usage_handler_internal_mcp_usage_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"exclude_group_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exclude Group Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/influencers":{"post":{"tags":["internal","outbound"],"summary":"Get Outbound Influencers Handler","operationId":"get_outbound_influencers_handler_internal_outbound_influencers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/influencers/{influencer_id}":{"put":{"tags":["internal","outbound"],"summary":"Update Outbound Influencer Handler","operationId":"update_outbound_influencer_handler_internal_outbound_influencers__influencer_id__put","parameters":[{"name":"influencer_id","in":"path","required":true,"schema":{"type":"string","title":"Influencer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/influencers/create":{"post":{"tags":["internal","outbound"],"summary":"Create Outbound Influencer Handler","operationId":"create_outbound_influencer_handler_internal_outbound_influencers_create_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/campaigns":{"post":{"tags":["internal","outbound"],"summary":"Get Outbound Campaigns Handler","operationId":"get_outbound_campaigns_handler_internal_outbound_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/campaigns/{campaign_id}":{"put":{"tags":["internal","outbound"],"summary":"Update Outbound Campaign Handler","operationId":"update_outbound_campaign_handler_internal_outbound_campaigns__campaign_id__put","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/campaigns/create":{"post":{"tags":["internal","outbound"],"summary":"Create Outbound Campaign Handler","operationId":"create_outbound_campaign_handler_internal_outbound_campaigns_create_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/outbound/agents":{"post":{"tags":["internal","outbound"],"summary":"Get Outbound Agents Handler","operationId":"get_outbound_agents_handler_internal_outbound_agents_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/influencer-data/entities":{"get":{"tags":["internal","influencer-data"],"summary":"Get Influencer Collection Entities Handler","operationId":"get_influencer_collection_entities_handler_internal_influencer_data_entities_get","parameters":[{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":250,"minimum":1,"default":50,"title":"Page Size"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search display name, email, handles, website, bio, topic, and niche.","title":"Search"},"description":"Search display name, email, handles, website, bio, topic, and niche."},{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},{"name":"min_metric_score","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Metric Score"}},{"name":"partnership_categories","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of partnership_category values","title":"Partnership Categories"},"description":"Comma-separated list of partnership_category values"},{"name":"min_followers","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Followers"}},{"name":"has_email","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(yes|no)$"},{"type":"null"}],"description":"'yes' filters to rows with primary_email set; 'no' inverts.","title":"Has Email"},"description":"'yes' filters to rows with primary_email set; 'no' inverts."},{"name":"discovery_vias","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of discovery_sources.via values","title":"Discovery Vias"},"description":"Comma-separated list of discovery_sources.via values"},{"name":"countries","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of ISO-3166-1 alpha-2 country codes","title":"Countries"},"description":"Comma-separated list of ISO-3166-1 alpha-2 country codes"},{"name":"sort_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(metric_score|partnership_category|creator_gender)$"},{"type":"null"}],"description":"Column to sort by. Allowlisted to avoid SQL injection.","title":"Sort By"},"description":"Column to sort by. Allowlisted to avoid SQL injection."},{"name":"sort_order","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(asc|desc)$"},{"type":"null"}],"description":"Sort direction. Defaults to 'desc' when sort_by is set.","title":"Sort Order"},"description":"Sort direction. Defaults to 'desc' when sort_by is set."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/influencer-data/manual-add":{"post":{"tags":["internal","influencer-data"],"summary":"Queue Manual Influencer Add Handler","operationId":"queue_manual_influencer_add_handler_internal_influencer_data_manual_add_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualInfluencerAddBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/{company_id}/clean":{"post":{"tags":["internal","data"],"summary":"Clean Company Handler","operationId":"clean_company_handler_internal_data__company_id__clean_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CleanCompanyBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/tasks":{"post":{"tags":["internal","data"],"summary":"Get Data Tasks Handler","operationId":"get_data_tasks_handler_internal_data_tasks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/product_duplicates":{"post":{"tags":["internal","data"],"summary":"Post Product Duplicates Handler","operationId":"post_product_duplicates_handler_internal_data_task_product_duplicates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LooseProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/bad_sales":{"post":{"tags":["internal","data"],"summary":"Get Products To Update Handler","operationId":"get_products_to_update_handler_internal_data_task_bad_sales_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LooseProductResearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/update":{"post":{"tags":["internal","data"],"summary":"Update Task Handler","operationId":"update_task_handler_internal_data_task__task_id__update_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task_bulk_update":{"post":{"tags":["internal","data"],"summary":"Update Bulk Tasks Handler","operationId":"update_bulk_tasks_handler_internal_data_task_bulk_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateTasksPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task_type_daily_completions":{"get":{"tags":["internal","data"],"summary":"Task Type Daily Completions Handler","operationId":"task_type_daily_completions_handler_internal_data_task_type_daily_completions_get","parameters":[{"name":"completion_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task_type_daily_completion/toggle":{"post":{"tags":["internal","data"],"summary":"Toggle Task Type Daily Completion Route","operationId":"toggle_task_type_daily_completion_route_internal_data_task_type_daily_completion_toggle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskTypeDailyCompletionPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/tasks/by_company":{"get":{"tags":["internal","data"],"summary":"List Tasks By Company Handler","description":"Completed data_task rows for a company within ``since_days`` (default 30), paginated; newest first.","operationId":"list_tasks_by_company_handler_internal_data_tasks_by_company_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"since_days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Since Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/by_company":{"get":{"tags":["internal","data"],"summary":"Get Task By Company Handler","description":"Get pbsr_zero_macro task for a company (for CMD+K Change PBSR). Returns 404 if none found.","operationId":"get_task_by_company_handler_internal_data_task_by_company_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"task_type","in":"query","required":true,"schema":{"type":"string","title":"Task Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/pbsr_macro/create":{"post":{"tags":["internal","data"],"summary":"Create Pbsr Macro Task Handler","description":"Create a pbsr_zero_macro task for a company on-demand. Returns existing task_id if one already exists.","operationId":"create_pbsr_macro_task_handler_internal_data_task_pbsr_macro_create_post","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/company_fix/create":{"post":{"tags":["internal","data"],"summary":"Create Company Fix Task Handler","description":"Create a fresh company_fix task for CMD+K Fix Company. Always inserts a new open task.","operationId":"create_company_fix_task_handler_internal_data_task_company_fix_create_post","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}":{"post":{"tags":["internal","data"],"summary":"Data Task Details Handler","description":"Get extra information to complete a task","operationId":"data_task_details_handler_internal_data_task__task_id__post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/bulk_update":{"post":{"tags":["internal","data"],"summary":"Update Products To Hide Handler","operationId":"update_products_to_hide_handler_internal_data_task__task_id__bulk_update_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/trigger_aggregation":{"post":{"tags":["internal","data"],"summary":"Trigger Aggregation Handler","description":"Trigger Preprocessing-Aggregation step function for an agg_zero task.\nOptional body.start_date / body.end_date (YYYY-MM-DD) run aggregation over that window.","operationId":"trigger_aggregation_handler_internal_data_task__task_id__trigger_aggregation_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/reprocessing_execution_url":{"get":{"tags":["internal","data"],"summary":"Reprocessing Execution Url Route","description":"Get AWS Step Functions console URL for a reprocessing job by parent_job_id.","operationId":"reprocessing_execution_url_route_internal_data_reprocessing_execution_url_get","parameters":[{"name":"parent_job_id","in":"query","required":true,"schema":{"type":"string","title":"Parent Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/parent_job/{parent_job_id}":{"get":{"tags":["internal","data"],"summary":"Parent Job Status Route","description":"Parent job status and child job_queue rows for Data Center.","operationId":"parent_job_status_route_internal_data_parent_job__parent_job_id__get","parameters":[{"name":"parent_job_id","in":"path","required":true,"schema":{"type":"string","title":"Parent Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/data_center_jobs":{"get":{"tags":["internal","data"],"summary":"Data Center Jobs Route","description":"Recent parent jobs kicked off from Data Center (last 3 days, incl. completed).","operationId":"data_center_jobs_route_internal_data_data_center_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":3,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/zero_sales_diagnostic":{"get":{"tags":["internal","data"],"summary":"Zero Sales Diagnostic Route","description":"Pipeline diagnostic for zero_sales task: 17 checks in pipeline order.","operationId":"zero_sales_diagnostic_route_internal_data_zero_sales_diagnostic_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":14,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/data_quality_flags":{"get":{"tags":["internal","data"],"summary":"Data Center Data Quality Flags Route","description":"Open data_quality queue rows for Data Center / internal tooling.","operationId":"data_center_data_quality_flags_route_internal_data_data_quality_flags_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/url_turnoff_daily":{"get":{"tags":["internal","data"],"summary":"Url Turnoff Daily Route","description":"Daily breakdown of URLs turned off over the past N days.","operationId":"url_turnoff_daily_route_internal_data_url_turnoff_daily_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/inactive_products_daily":{"get":{"tags":["internal","data"],"summary":"Inactive Products Daily Route","description":"Daily counts of products auto-set inactive (actively_tracking=0) plus current snapshot.","operationId":"inactive_products_daily_route_internal_data_inactive_products_daily_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/zero_sales_variant_counts":{"get":{"tags":["internal","data"],"summary":"Zero Sales Variant Counts Route","description":"Daily variant counts for zero_sales chart: raw inventory decrease vs processed sales.","operationId":"zero_sales_variant_counts_route_internal_data_zero_sales_variant_counts_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","title":"Start Date"}},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/zero_sales/turn_off_preview":{"get":{"tags":["internal","data"],"summary":"Zero Sales Turn Off Preview Route","description":"Read-only counts before destructive turn-off (subscriptions, collections).","operationId":"zero_sales_turn_off_preview_route_internal_data_zero_sales_turn_off_preview_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/zero_sales/pricing_only":{"post":{"tags":["internal","data"],"summary":"Zero Sales Pricing Only Route","description":"Set company to pricing-only + requests_method standard; append task note.","operationId":"zero_sales_pricing_only_route_internal_data_zero_sales_pricing_only_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroSalesActionPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/zero_sales/turn_off_company":{"post":{"tags":["internal","data"],"summary":"Zero Sales Turn Off Company Route","description":"Full turn-off: subscriptions, collections, dashboards, company reset, task note.","operationId":"zero_sales_turn_off_company_route_internal_data_zero_sales_turn_off_company_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroSalesTurnOffPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/trigger_reprocessing":{"post":{"tags":["internal","data"],"summary":"Trigger Reprocessing Handler","description":"Trigger reprocessing for a task over a date range.","operationId":"trigger_reprocessing_handler_internal_data_task__task_id__trigger_reprocessing_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/gap_fill":{"post":{"tags":["internal","data"],"summary":"Trigger Gap Fill Handler","operationId":"trigger_gap_fill_handler_internal_data_task__task_id__gap_fill_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GapFillPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/company/{company_id}/purge_product_research_cache":{"post":{"tags":["internal","data"],"summary":"Purge Company Product Research Cache Handler","operationId":"purge_company_product_research_cache_handler_internal_data_company__company_id__purge_product_research_cache_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/company/{company_id}/purge_marketing_cache":{"post":{"tags":["internal","data"],"summary":"Purge Company Marketing Cache Handler","operationId":"purge_company_marketing_cache_handler_internal_data_company__company_id__purge_marketing_cache_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/approve_processing_failure":{"post":{"tags":["internal","data"],"summary":"Approve Processing Failure Route","operationId":"approve_processing_failure_route_internal_data_task__task_id__approve_processing_failure_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessingFailureApprovalPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/complete_pbsr_zero_micro":{"post":{"tags":["internal","data"],"summary":"Complete Pbsr Zero Micro Route","description":"Complete a pbsr_zero_micro task with structured completion reason.","operationId":"complete_pbsr_zero_micro_route_internal_data_task__task_id__complete_pbsr_zero_micro_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PbsrZeroMicroCompletionPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/fixer/apply":{"post":{"tags":["internal","data"],"summary":"Fixer Apply Bulk Route","description":"Bulk apply fixer actions from Data Center UI (internal auth).","operationId":"fixer_apply_bulk_route_internal_data_fixer_apply_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixerApplyBulkPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/fixer/run_summary/{run_date}":{"get":{"tags":["internal","data"],"summary":"Fixer Run Summary Route","operationId":"fixer_run_summary_route_internal_data_fixer_run_summary__run_date__get","parameters":[{"name":"run_date","in":"path","required":true,"schema":{"type":"string","title":"Run Date"}},{"name":"fixer_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fixer Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/apply_and_reprocess":{"post":{"tags":["internal","data"],"summary":"Apply And Reprocess Handler","description":"Update PBSR revenue and optionally kick off reprocessing. Single combined flow.","operationId":"apply_and_reprocess_handler_internal_data_task__task_id__apply_and_reprocess_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/pbsr_macro_suggestion":{"get":{"tags":["internal","data"],"summary":"Pbsr Macro Suggestion Handler","description":"OG-sales-based PBSR Macro suggestion + eligibility flags for the task's company.","operationId":"pbsr_macro_suggestion_handler_internal_data_task__task_id__pbsr_macro_suggestion_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/update_pbsr_revenue":{"post":{"tags":["internal","data"],"summary":"Update Pbsr Revenue Handler","description":"Update PBSR revenue estimate for a company. Supports 2025 and 2026 estimates.","operationId":"update_pbsr_revenue_handler_internal_data_task__task_id__update_pbsr_revenue_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/task/{task_id}/kickoff_pbsr_reprocessing":{"post":{"tags":["internal","data"],"summary":"Kickoff Pbsr Reprocessing Handler","description":"Kick off full PBSR reprocessing for a pbsr_zero_macro task.","operationId":"kickoff_pbsr_reprocessing_handler_internal_data_task__task_id__kickoff_pbsr_reprocessing_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/stats":{"get":{"tags":["internal","data"],"summary":"Get Data Stats Handler","operationId":"get_data_stats_handler_internal_data_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_collection_stats":{"get":{"tags":["internal","data"],"summary":"Get Exec Collection Stats Handler","operationId":"get_exec_collection_stats_handler_internal_data_exec_collection_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/job_queue_by_status":{"get":{"tags":["internal","data"],"summary":"Job Queue By Status Handler","operationId":"job_queue_by_status_handler_internal_data_job_queue_by_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/db_load_exec":{"get":{"tags":["internal","data"],"summary":"Db Load Exec Handler","operationId":"db_load_exec_handler_internal_data_db_load_exec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/db_load_timeseries":{"get":{"tags":["internal","data"],"summary":"Db Load Timeseries Route","operationId":"db_load_timeseries_route_internal_data_db_load_timeseries_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/exec_jobs":{"get":{"tags":["internal","data"],"summary":"Exec Jobs Route","operationId":"exec_jobs_route_internal_data_exec_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/company_issues_overview":{"get":{"tags":["internal","data"],"summary":"Company Issues Overview Route","operationId":"company_issues_overview_route_internal_data_company_issues_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_data_center":{"get":{"tags":["internal","data"],"summary":"Exec Data Center Route","operationId":"exec_data_center_route_internal_data_exec_data_center_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_customer_requests":{"get":{"tags":["internal","data"],"summary":"Exec Customer Requests Route","operationId":"exec_customer_requests_route_internal_data_exec_customer_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_sitechecker":{"get":{"tags":["internal","data"],"summary":"Exec Sitechecker Route","operationId":"exec_sitechecker_route_internal_data_exec_sitechecker_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_low_to_high":{"get":{"tags":["internal","data"],"summary":"Exec Low To High Route","operationId":"exec_low_to_high_route_internal_data_exec_low_to_high_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/l2h_dashboard":{"get":{"tags":["internal","data"],"summary":"L2H Dashboard Route","operationId":"l2h_dashboard_route_internal_data_l2h_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_sitemaps":{"get":{"tags":["internal","data"],"summary":"Exec Sitemaps Route","operationId":"exec_sitemaps_route_internal_data_exec_sitemaps_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_zero_sales":{"get":{"tags":["internal","data"],"summary":"Exec Zero Sales Route","operationId":"exec_zero_sales_route_internal_data_exec_zero_sales_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_reviews":{"get":{"tags":["internal","data"],"summary":"Exec Reviews Route","operationId":"exec_reviews_route_internal_data_exec_reviews_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_aggregations":{"get":{"tags":["internal","data"],"summary":"Exec Aggregations Route","operationId":"exec_aggregations_route_internal_data_exec_aggregations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_aggregation_issues_list":{"get":{"tags":["internal","data"],"summary":"Exec Aggregation Issues List Route","operationId":"exec_aggregation_issues_list_route_internal_data_exec_aggregation_issues_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_checkly_firehose":{"get":{"tags":["internal","data"],"summary":"Exec Checkly Firehose Route","operationId":"exec_checkly_firehose_route_internal_data_exec_checkly_firehose_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/exec_deployments":{"get":{"tags":["internal","data"],"summary":"Exec Deployments Route","operationId":"exec_deployments_route_internal_data_exec_deployments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/job_queue_daily_flow":{"get":{"tags":["internal","data"],"summary":"Job Queue Daily Flow Handler","operationId":"job_queue_daily_flow_handler_internal_data_job_queue_daily_flow_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/job_types":{"get":{"tags":["internal","data"],"summary":"Job Types Handler","operationId":"job_types_handler_internal_data_job_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/data/job_completion_estimate":{"get":{"tags":["internal","data"],"summary":"Job Completion Estimate Handler","operationId":"job_completion_estimate_handler_internal_data_job_completion_estimate_get","parameters":[{"name":"job_type","in":"query","required":true,"schema":{"type":"string","title":"Job Type"}},{"name":"current_concurrency","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Concurrency"}},{"name":"new_concurrency","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"New Concurrency"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/job_management_preview":{"get":{"tags":["internal","data"],"summary":"Job Management Preview Handler","operationId":"job_management_preview_handler_internal_data_job_management_preview_get","parameters":[{"name":"job_type","in":"query","required":true,"schema":{"type":"string","title":"Job Type"}},{"name":"action","in":"query","required":true,"schema":{"type":"string","title":"Action"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"older_than_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Older Than Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/job_management":{"post":{"tags":["internal","data"],"summary":"Job Management Handler","operationId":"job_management_handler_internal_data_job_management_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobManagementPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/customer_request_failures":{"get":{"tags":["internal","data"],"summary":"Customer Request Failures Handler","operationId":"customer_request_failures_handler_internal_data_customer_request_failures_get","parameters":[{"name":"failure_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Type"}},{"name":"request_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Source"}},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id"}},{"name":"customer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/low_to_high/jobs":{"get":{"tags":["internal","data"],"summary":"Low To High Jobs Handler","operationId":"low_to_high_jobs_handler_internal_data_low_to_high_jobs_get","parameters":[{"name":"job_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Status"}},{"name":"job_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type"}},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page Number"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/low_to_high/job_action":{"post":{"tags":["internal","data"],"summary":"Low To High Job Action Route","operationId":"low_to_high_job_action_route_internal_data_low_to_high_job_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LowToHighJobActionPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/customer_request_daily_open":{"get":{"tags":["internal","data"],"summary":"Customer Request Daily Open Handler","operationId":"customer_request_daily_open_handler_internal_data_customer_request_daily_open_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":365,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/{company_id}/update":{"post":{"tags":["internal","data"],"summary":"Update Company Handler","operationId":"update_company_handler_internal_data__company_id__update_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/{company_id}/task_settings":{"post":{"tags":["internal","data"],"summary":"Update Company Data Task Settings Handler","operationId":"update_company_data_task_settings_handler_internal_data__company_id__task_settings_post","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDataTaskSettingsPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/variant_events":{"get":{"tags":["internal","data"],"summary":"Get Variant Events Handler","operationId":"get_variant_events_handler_internal_data_variant_events_get","parameters":[{"name":"company_id","in":"query","required":true,"schema":{"type":"string","title":"Company Id"}},{"name":"product_id","in":"query","required":true,"schema":{"type":"string","title":"Product Id"}},{"name":"event_date","in":"query","required":true,"schema":{"type":"string","title":"Event Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/company_note":{"post":{"tags":["internal","data"],"summary":"Create Custom Company Note Handler","operationId":"create_custom_company_note_handler_internal_data_company_note_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomCompanyNotePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/data/category_zero":{"get":{"tags":["internal","data"],"summary":"Get Category Zero Handler","operationId":"get_category_zero_handler_internal_data_category_zero_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/customers":{"post":{"tags":["internal","finance"],"summary":"Get Customers Handler","operationId":"get_customers_handler_internal_finance_customers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/customers/{customer_id}":{"put":{"tags":["internal","finance"],"summary":"Update Customer Handler","operationId":"update_customer_handler_internal_finance_customers__customer_id__put","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/customers_cards_stats":{"get":{"tags":["internal","finance"],"summary":"Get Customers Cards Stats Handler","operationId":"get_customers_cards_stats_handler_internal_finance_customers_cards_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/finance/exec_plg_stats":{"get":{"tags":["internal","finance"],"summary":"Get Exec Plg Stats Handler","operationId":"get_exec_plg_stats_handler_internal_finance_exec_plg_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/finance/customer-funnel":{"get":{"tags":["internal","finance"],"summary":"Get Customer Funnel Handler","operationId":"get_customer_funnel_handler_internal_finance_customer_funnel_get","parameters":[{"name":"start_date","in":"query","required":true,"schema":{"type":"string","title":"Start Date"}},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/customer-renewals":{"get":{"tags":["internal","finance"],"summary":"Get Customer Renewals Handler","operationId":"get_customer_renewals_handler_internal_finance_customer_renewals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/finance/customer-renewals/usage-report":{"get":{"tags":["internal","finance"],"summary":"Get Customer Renewals Usage Report Handler","operationId":"get_customer_renewals_usage_report_handler_internal_finance_customer_renewals_usage_report_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"default":60,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/customer-renewals/{customer_name}":{"patch":{"tags":["internal","finance"],"summary":"Update Customer Renewal Handler","operationId":"update_customer_renewal_handler_internal_finance_customer_renewals__customer_name__patch","parameters":[{"name":"customer_name","in":"path","required":true,"schema":{"type":"string","title":"Customer Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/products":{"get":{"tags":["internal","finance"],"summary":"Get Products Handler","operationId":"get_products_handler_internal_finance_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/finance/contracts":{"post":{"tags":["internal","finance"],"summary":"Get Contracts Handler","operationId":"get_contracts_handler_internal_finance_contracts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/contracts/{contract_id}":{"put":{"tags":["internal","finance"],"summary":"Update Contract Handler","operationId":"update_contract_handler_internal_finance_contracts__contract_id__put","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/accounts_receivable":{"post":{"tags":["internal","finance"],"summary":"Get Accounts Receivable Handler","operationId":"get_accounts_receivable_handler_internal_finance_accounts_receivable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/finance/accounts_receivable_cards_stats":{"get":{"tags":["internal","finance"],"summary":"Get Accounts Receivable Cards Stats Handler","operationId":"get_accounts_receivable_cards_stats_handler_internal_finance_accounts_receivable_cards_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/internal/finance/accounts_receivable_note/{customer_id}":{"post":{"tags":["internal","finance"],"summary":"Create Accounts Receivable Note Handler","operationId":"create_accounts_receivable_note_handler_internal_finance_accounts_receivable_note__customer_id__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/remove_competitor":{"post":{"tags":["internal"],"summary":"Internal Remove Competitor Handler","operationId":"internal_remove_competitor_handler_internal_remove_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalRemoveCompetitorBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/upload":{"post":{"tags":["newsletter"],"summary":"Upload Newsletter","description":"Upload input.txt file with newsletter HTML content.","operationId":"upload_newsletter_newsletter_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_newsletter_newsletter_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/process-assets":{"post":{"tags":["newsletter"],"summary":"Process Assets","description":"Process newsletter assets: extract images and upload to S3.","operationId":"process_assets_newsletter_process_assets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessAssetsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessAssetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/audiences":{"get":{"tags":["newsletter"],"summary":"Get Audiences","description":"Get available audiences and their recipient counts.","operationId":"get_audiences_newsletter_audiences_get","parameters":[{"name":"newsletter_type","in":"query","required":true,"schema":{"type":"string","title":"Newsletter Type"}},{"name":"subject","in":"query","required":false,"schema":{"type":"string","title":"Subject"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudiencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/preview":{"post":{"tags":["newsletter"],"summary":"Preview Newsletter","description":"Generate newsletter preview with updated image URLs.","operationId":"preview_newsletter_newsletter_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/send":{"post":{"tags":["newsletter"],"summary":"Send Newsletter","description":"Send newsletter to recipients. For production mode, this runs in the background.","operationId":"send_newsletter_newsletter_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNewsletterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/send-stream":{"post":{"tags":["newsletter"],"summary":"Send Newsletter Stream","description":"Send newsletter with real-time progress updates via Server-Sent Events.","operationId":"send_newsletter_stream_newsletter_send_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNewsletterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/preview-custom-audience":{"post":{"tags":["newsletter"],"summary":"Preview Custom Audience","description":"Preview custom audience query results.","operationId":"preview_custom_audience_newsletter_preview_custom_audience_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewCustomAudienceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewCustomAudienceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/audience-query":{"get":{"tags":["newsletter"],"summary":"Get Audience Query","description":"Get the raw SQL query for a given audience.","operationId":"get_audience_query_newsletter_audience_query_get","parameters":[{"name":"audience","in":"query","required":true,"schema":{"type":"string","title":"Audience"}},{"name":"subject","in":"query","required":true,"schema":{"type":"string","title":"Subject"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/parse-reference-plain":{"post":{"tags":["newsletter"],"summary":"Parse Reference Plain","description":"Parse plain text reference data and return structured ParsedReferenceData.","operationId":"parse_reference_plain_newsletter_builder_parse_reference_plain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseReferencePlainRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParsedReferenceData"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/generate-text":{"post":{"tags":["newsletter"],"summary":"Generate Newsletter Text","description":"Generate newsletter body paragraphs using ChatGPT from reference data.","operationId":"generate_newsletter_text_newsletter_builder_generate_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParsedReferenceData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/generate-text-batch":{"post":{"tags":["newsletter"],"summary":"Generate Text Batch","description":"Generate newsletter body text for multiple folds from one text block.\nInput: text with blocks separated by a line containing one or more underscores (_).\nOutput: generated paragraphs for each fold, joined by _____.\nUses same prompting as generate-text.","operationId":"generate_text_batch_newsletter_builder_generate_text_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateTextBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateTextBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/refine-text":{"post":{"tags":["newsletter"],"summary":"Refine Newsletter Text","description":"Refine newsletter body text via GPT: remove redundancy, make analytical, observational, conversational, punchy.","operationId":"refine_newsletter_text_newsletter_builder_refine_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefineTextRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/refine-all":{"post":{"tags":["newsletter"],"summary":"Refine All Newsletter","description":"Refine all newsletter folds together via GPT. Identifies grammar/typos and refines tone.","operationId":"refine_all_newsletter_newsletter_builder_refine_all_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefineAllRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefineAllResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-review-issue":{"post":{"tags":["newsletter"],"summary":"Review Er Issue","description":"Review all ER trend folds together for cross-section redundancy and issue flow.","operationId":"review_er_issue_newsletter_builder_er_review_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErReviewIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErReviewIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/suggest-trends":{"post":{"tags":["newsletter"],"summary":"Suggest Trends","description":"Pick top 6 trends for newsletter: 3 companies, 1 product type, 1 keyword, 1 material.","operationId":"suggest_trends_newsletter_builder_suggest_trends_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestTrendsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestTrendsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/upload-images":{"post":{"tags":["newsletter"],"summary":"Upload Builder Images","description":"Upload images for newsletter builder and return S3 URLs.","operationId":"upload_builder_images_newsletter_builder_upload_images_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_builder_images_newsletter_builder_upload_images_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/generate":{"post":{"tags":["newsletter"],"summary":"Generate Newsletter Html Endpoint","description":"Generate HTML from newsletter builder data.","operationId":"generate_newsletter_html_endpoint_newsletter_builder_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterBuilderData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterBuilderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/save":{"post":{"tags":["newsletter"],"summary":"Save Newsletter","description":"Save newsletter draft.","operationId":"save_newsletter_newsletter_builder_save_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveNewsletterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterBuilderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/load/{newsletter_id}":{"get":{"tags":["newsletter"],"summary":"Load Newsletter","description":"Load saved newsletter draft.","operationId":"load_newsletter_newsletter_builder_load__newsletter_id__get","parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","title":"Newsletter Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoadNewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/process-for-sending":{"post":{"tags":["newsletter"],"summary":"Process Builder For Sending","description":"Process newsletter HTML from builder for sending.\nExtracts images, uploads to S3, and returns timestamp for use in sender flow.","operationId":"process_builder_for_sending_newsletter_builder_process_for_sending_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_process_builder_for_sending_newsletter_builder_process_for_sending_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessAssetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-candidates":{"post":{"tags":["newsletter"],"summary":"Er Candidates","description":"Return ER wizard candidate trends (>900% three-month, positive one-year).","operationId":"er_candidates_newsletter_builder_er_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERCandidatesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERCandidatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-more-candidates":{"post":{"tags":["newsletter"],"summary":"Er More Candidates","description":"Fetch the next page of ER candidate trends for a single tag_type.","operationId":"er_more_candidates_newsletter_builder_er_more_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERMoreCandidatesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERMoreCandidatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-mark-trend":{"post":{"tags":["newsletter"],"summary":"Er Mark Trend","description":"Manually mark an ER candidate trend (defer / never), or clear a mark (undo).","operationId":"er_mark_trend_newsletter_builder_er_mark_trend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERMarkTrendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERMarkTrendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-top-products":{"post":{"tags":["newsletter"],"summary":"Er Top Products","description":"Return top products for a trend (company query for company trends, trend top_products otherwise).","operationId":"er_top_products_newsletter_builder_er_top_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERTopProductsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERTopProductsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-resolve-product":{"post":{"tags":["newsletter"],"summary":"Er Resolve Product","description":"Resolve product by company_id + product_id, or from a Particl / storefront link.","operationId":"er_resolve_product_newsletter_builder_er_resolve_product_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERResolveProductRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERResolveProductResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-assemble":{"post":{"tags":["newsletter"],"summary":"Er Assemble","description":"Assemble ER folds for the user-selected trends: perplexity + generate text.","operationId":"er_assemble_newsletter_builder_er_assemble_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERAssembleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ERAssembleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/er-fold-feedback":{"post":{"tags":["newsletter"],"summary":"Er Fold Feedback","description":"Append ER wizard feedback rows for eval / self-improve loops.","operationId":"er_fold_feedback_newsletter_builder_er_fold_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErFoldFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErFoldFeedbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/why-it-matters":{"post":{"tags":["newsletter"],"summary":"Why It Matters","description":"Fetch structured ER fold research via Perplexity (category, approach, drivers, hero proof, takeaway).","operationId":"why_it_matters_newsletter_builder_why_it_matters_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhyItMattersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhyItMattersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/about-page":{"post":{"tags":["newsletter"],"summary":"About Page","description":"Fetch the brand's About-page URL (or a company-story summary if no about page exists) via Perplexity.","operationId":"about_page_newsletter_builder_about_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AboutPageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AboutPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter/builder/process-and-send":{"post":{"tags":["newsletter"],"summary":"Process Builder Newsletter","description":"Process newsletter builder data: generate HTML, upload assets, return timestamp for sending.","operationId":"process_builder_newsletter_newsletter_builder_process_and_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterBuilderData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessBuilderNewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter-tools/send-preview":{"post":{"tags":["newsletter-tools"],"summary":"Send Preview","operationId":"send_preview_newsletter_tools_send_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/newsletter-tools/upload-asset":{"post":{"tags":["newsletter-tools"],"summary":"Upload Asset","description":"Accepts a data URL (base64-encoded image) and uploads it to S3 so the\nnewsletter editor can swap inline images for hosted URLs before sending —\nResend / inbox renderers won't reliably display large data: URIs.","operationId":"upload_asset_newsletter_tools_upload_asset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadAssetRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadAssetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AboutPageRequest":{"properties":{"name":{"type":"string","title":"Name"},"companyDomain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companydomain"}},"type":"object","required":["name"],"title":"AboutPageRequest"},"AboutPageResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["success"],"title":"AboutPageResponse"},"AcceptTransferInvitePayload":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"AcceptTransferInvitePayload"},"AddContactToResendPayload":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"AddContactToResendPayload"},"AddOrRemoveCompetitorBody":{"properties":{"company_id":{"type":"string","title":"Company Id"}},"type":"object","required":["company_id"],"title":"AddOrRemoveCompetitorBody"},"AiDemoRequest":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Company Ids"},"interaction":{"type":"string","enum":["first_insight","compare_pricing","recent_launches","top_products"],"title":"Interaction"}},"type":"object","required":["company_ids","interaction"],"title":"AiDemoRequest"},"AllDashboardsResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/EnhancedCustomDashboard"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"AllDashboardsResponse"},"AssetMetrics":{"properties":{"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets","description":"Total number of assets"},"assets_by_type":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Assets By Type","description":"Count of assets by promotion type"},"engagement_metrics":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Engagement Metrics","description":"Average engagement metrics by type"},"posting_hours":{"anyOf":[{"additionalProperties":{"items":{"type":"integer"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Posting Hours","description":"Distribution of posts by hour (0-23)"},"estimated_reach":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Estimated Reach","description":"Estimated reach by asset type"},"avg_likes":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Avg Likes","description":"Average likes by asset type"},"engagement_rate":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Engagement Rate","description":"Engagement rate by asset type"},"most_liked_post":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Most Liked Post","description":"Most liked post by asset type"}},"type":"object","title":"AssetMetrics","description":"Comprehensive metrics for marketing assets"},"AssetTrackingRequestBody":{"properties":{"asset_type":{"type":"string","enum":["instagram_post","facebook_ads","homepage_screenshot"],"title":"Asset Type"},"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"message":{"type":"string","title":"Message"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"}},"type":"object","required":["asset_type","company_ids","message"],"title":"AssetTrackingRequestBody"},"AssetsListBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","default":"2026-09-10"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","default":"2026-10-10"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":18}},"promotion_types":{"items":{"type":"string","enum":["homepage_screenshot","homepage_screenshot_mobile","instagram_post","email","tiktok_post","facebook_ads","sms"]},"type":"array","title":"Promotion Types","default":[]}},"type":"object","title":"AssetsListBody"},"AudienceInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["id","name","count"],"title":"AudienceInfo","description":"Information about a newsletter audience."},"AudienceQueryResponse":{"properties":{"query":{"type":"string","title":"Query"},"audience":{"type":"string","title":"Audience"},"subject":{"type":"string","title":"Subject"}},"type":"object","required":["query","audience","subject"],"title":"AudienceQueryResponse","description":"Response with raw SQL query for an audience."},"AudiencesResponse":{"properties":{"audiences":{"items":{"$ref":"#/components/schemas/AudienceInfo"},"type":"array","title":"Audiences"}},"type":"object","required":["audiences"],"title":"AudiencesResponse","description":"Response with available audiences."},"BaseGroup":{"properties":{"id":{"type":"string","title":"Id"},"customer_id":{"type":"string","title":"Customer Id"},"name":{"type":"string","title":"Name"},"plan_features":{"additionalProperties":true,"type":"object","title":"Plan Features","default":{}},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"stripe_customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Customer Id"},"stripe_subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Subscription Id"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"status":{"type":"string","title":"Status"},"company_ids_representing_group":{"items":{},"type":"array","title":"Company Ids Representing Group","default":[]},"views_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Views Limit"},"historical_access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Historical Access Date"},"credit_limit":{"type":"integer","title":"Credit Limit","default":0},"credits_used":{"type":"integer","title":"Credits Used","default":0},"credits_remaining":{"type":"integer","title":"Credits Remaining","default":0},"integrations":{"additionalProperties":true,"type":"object","title":"Integrations","default":{}},"competitors":{"items":{},"type":"array","title":"Competitors","default":[]},"pending_competitors":{"items":{},"type":"array","title":"Pending Competitors","default":[]},"user_count":{"type":"integer","title":"User Count","default":1},"onboarded":{"type":"boolean","title":"Onboarded","default":true},"users":{"items":{},"type":"array","title":"Users","default":[]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"current_competitor_count":{"type":"integer","title":"Current Competitor Count","default":0},"current_signature_competitor_count":{"type":"integer","title":"Current Signature Competitor Count","default":0},"company_id_representing_customer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id Representing Customer"},"special_offer":{"type":"boolean","title":"Special Offer","default":false},"free_trial_used":{"type":"boolean","title":"Free Trial Used","default":false},"retention_discount_offer":{"type":"boolean","title":"Retention Discount Offer","default":false},"excommunicado":{"type":"boolean","title":"Excommunicado","default":false}},"type":"object","required":["id","customer_id","name","status"],"title":"BaseGroup"},"Body_process_builder_for_sending_newsletter_builder_process_for_sending_post":{"properties":{"html_content":{"type":"string","title":"Html Content"},"newsletter_type":{"type":"string","title":"Newsletter Type"},"date":{"type":"string","title":"Date"},"has_header":{"type":"boolean","title":"Has Header","default":true}},"type":"object","required":["html_content","newsletter_type","date"],"title":"Body_process_builder_for_sending_newsletter_builder_process_for_sending_post"},"Body_upload_builder_images_newsletter_builder_upload_images_post":{"properties":{"files":{"items":{"type":"string","format":"binary"},"type":"array","title":"Files"}},"type":"object","required":["files"],"title":"Body_upload_builder_images_newsletter_builder_upload_images_post"},"Body_upload_newsletter_newsletter_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_newsletter_newsletter_upload_post"},"BrandResult":{"properties":{"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"}},"type":"object","title":"BrandResult"},"BrandsResearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/BrandResult"},"type":"array","title":"Results"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["results","total_count"],"title":"BrandsResearchResponse"},"BulkUpdateTasksPayload":{"properties":{"task_ids":{"items":{"type":"string"},"type":"array","title":"Task Ids"},"field":{"additionalProperties":true,"type":"object","title":"Field"}},"type":"object","required":["task_ids","field"],"title":"BulkUpdateTasksPayload"},"CancelSubscriptionBody":{"properties":{"cancellation_reason":{"type":"string","title":"Cancellation Reason"},"cancellation_comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancellation Comment"},"skip_retention_offer":{"type":"boolean","title":"Skip Retention Offer","default":false}},"type":"object","required":["cancellation_reason"],"title":"CancelSubscriptionBody"},"ChangeCompanyDateBody":{"properties":{"company_id":{"type":"string","title":"Company Id"},"start_date":{"type":"string","title":"Start Date"},"date_type":{"type":"string","enum":["start_date","archived_start_date","stable_start_date"],"title":"Date Type"}},"type":"object","required":["company_id","start_date","date_type"],"title":"ChangeCompanyDateBody"},"CleanCompanyBody":{"properties":{"task_type":{"type":"string","enum":["reaggregate","classify","start_dates"],"title":"Task Type"}},"type":"object","required":["task_type"],"title":"CleanCompanyBody"},"ColorResearch":{"properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"}},"type":"object","title":"ColorResearch"},"ColorResearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ColorResearch"},"type":"array","title":"Results"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["results","total_count"],"title":"ColorResearchResponse"},"CommonProductResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false}},"type":"object","title":"CommonProductResearchBody"},"CommunicationSettingPayload":{"properties":{"setting_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Setting Id"},"communication_channel":{"type":"string","title":"Communication Channel"},"communication_type":{"type":"string","title":"Communication Type"},"setting_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Setting Metadata"},"subscribed":{"type":"boolean","title":"Subscribed","default":true}},"type":"object","required":["communication_channel","communication_type"],"title":"CommunicationSettingPayload"},"CommunicationSettingResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"customer_id":{"type":"string","title":"Customer Id"},"setting_id":{"type":"string","title":"Setting Id"},"communication_channel":{"type":"string","title":"Communication Channel"},"communication_type":{"type":"string","title":"Communication Type"},"setting_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Setting Metadata"},"subscribed":{"type":"boolean","title":"Subscribed"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["user_id","customer_id","setting_id","communication_channel","communication_type","subscribed","created_at","updated_at"],"title":"CommunicationSettingResponse"},"CompaniesSetPayload":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Company Ids"}},"type":"object","required":["company_ids"],"title":"CompaniesSetPayload"},"CompanyAssetTrackingResult":{"properties":{"company_id":{"type":"string","title":"Company Id"},"company_name":{"type":"string","title":"Company Name"},"status":{"type":"string","enum":["applied","needs_manual","failed"],"title":"Status"},"links_used":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Links Used"},"actions":{"items":{"type":"string"},"type":"array","title":"Actions"},"blocker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocker"},"link_sources":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Link Sources"}},"type":"object","required":["company_id","company_name","status","links_used","actions"],"title":"CompanyAssetTrackingResult"},"CompanyCollection":{"properties":{"group_id":{"type":"string","title":"Group Id"},"collection_id":{"type":"string","title":"Collection Id"},"name":{"type":"string","title":"Name"},"created_by":{"additionalProperties":true,"type":"object","title":"Created By"},"companies":{"items":{},"type":"array","title":"Companies"}},"type":"object","required":["group_id","collection_id","name","created_by","companies"],"title":"CompanyCollection"},"CompanyCountsResponse":{"properties":{"product_count":{"type":"integer","title":"Product Count"},"variant_count":{"type":"integer","title":"Variant Count"}},"type":"object","required":["product_count","variant_count"],"title":"CompanyCountsResponse"},"CompanyDataQualityPaginatedRequest":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"page_number":{"type":"integer","title":"Page Number","default":0},"page_size":{"type":"integer","title":"Page Size","default":20}},"type":"object","required":["company_ids"],"title":"CompanyDataQualityPaginatedRequest"},"CompanyDataQualityRequest":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"}},"type":"object","required":["company_ids"],"title":"CompanyDataQualityRequest"},"CompanyDataQualityTimeseriesRequest":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["company_ids","start_date","end_date"],"title":"CompanyDataQualityTimeseriesRequest"},"CompanyDataTaskSettingsPayload":{"properties":{"low_sales":{"type":"boolean","title":"Low Sales"}},"type":"object","required":["low_sales"],"title":"CompanyDataTaskSettingsPayload"},"CompanyDetailsResponse":{"properties":{"company_id":{"type":"string","title":"Company Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"data_available":{"$ref":"#/components/schemas/DataAvailable"},"company_type":{"type":"string","enum":["online","brick_and_mortar"],"title":"Company Type"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"bad_collection":{"additionalProperties":true,"type":"object","title":"Bad Collection","default":{}},"company_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Price"},"is_signature":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Signature","default":false},"vertical":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vertical"},"location":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Location","default":{}},"social":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Social","default":{}},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"instagram_followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Instagram Followers"},"instagram_followers_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Followers Updated At"},"company_notes":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompanyNote"},"type":"array"},{"type":"null"}],"title":"Company Notes","default":[]},"is_previewable":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Is Previewable"},"recent_pricing_only_change":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Recent Pricing Only Change","default":false},"inventory_cap_change":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Inventory Cap Change","default":false},"competitors":{"anyOf":[{"items":{"$ref":"#/components/schemas/SimpleCompanyDetail"},"type":"array"},{"type":"null"}],"title":"Competitors","default":[]},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"}},"type":"object","required":["company_id","name","domain","data_available","company_type"],"title":"CompanyDetailsResponse"},"CompanyIdProductId":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"}},"type":"object","required":["company_id","product_id"],"title":"CompanyIdProductId"},"CompanyIdRepresentingCustomerBody":{"properties":{"company_id":{"type":"string","title":"Company Id"}},"type":"object","required":["company_id"],"title":"CompanyIdRepresentingCustomerBody"},"CompanyNote":{"properties":{"message_type":{"anyOf":[{"type":"string"},{"type":"string","enum":["reprocess","holiday_promotion"]}],"title":"Message Type"},"note_type":{"type":"string","title":"Note Type"},"event_date":{"type":"string","title":"Event Date"},"content":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content"}},"type":"object","required":["message_type","note_type","event_date"],"title":"CompanyNote"},"CompanyPreviewResponse":{"properties":{"company":{"additionalProperties":true,"type":"object","title":"Company"},"products":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Products"},"timeseries":{"items":{"$ref":"#/components/schemas/CompanyPreviewTimeseriesObject"},"type":"array","title":"Timeseries"}},"type":"object","required":["company","products","timeseries"],"title":"CompanyPreviewResponse"},"CompanyPreviewTimeseriesObject":{"properties":{"date":{"type":"string","title":"Date"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"}},"type":"object","required":["date"],"title":"CompanyPreviewTimeseriesObject"},"CreateBillingPortalSession":{"properties":{"return_url":{"type":"string","title":"Return Url","default":"https://app.particl.com/dashboard/settings/billing"},"management_view":{"anyOf":[{"type":"string","enum":["subscription_update","subscription_cancel"]},{"type":"null"}],"title":"Management View"}},"type":"object","title":"CreateBillingPortalSession"},"CreateCheckoutSession":{"properties":{"special_offer":{"type":"boolean","title":"Special Offer","default":false},"plan_id":{"$ref":"#/components/schemas/PlanType","default":"tier-1-monthly"}},"type":"object","title":"CreateCheckoutSession"},"CreateCompanyCollectionPayload":{"properties":{"collection_name":{"type":"string","title":"Collection Name"},"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"}},"type":"object","required":["collection_name","company_ids"],"title":"CreateCompanyCollectionPayload"},"CreateEducationAccountRequestPayload":{"properties":{"first_name":{"type":"string","title":"First Name"},"last_name":{"type":"string","title":"Last Name"},"email":{"type":"string","title":"Email"},"linkedin":{"type":"string","title":"Linkedin"},"public_access":{"type":"boolean","title":"Public Access"},"school_name":{"type":"string","title":"School Name"},"school_role":{"type":"string","title":"School Role"},"school_website":{"type":"string","title":"School Website"},"how_did_you_hear":{"type":"string","title":"How Did You Hear"},"use_case":{"type":"string","title":"Use Case"},"budget":{"type":"string","title":"Budget"}},"type":"object","required":["first_name","last_name","email","linkedin","public_access","school_name","school_role","school_website","how_did_you_hear","use_case","budget"],"title":"CreateEducationAccountRequestPayload"},"CreateProductType":{"properties":{"name":{"type":"string","title":"Name"},"parent_product_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Product Type Id"}},"type":"object","required":["name"],"title":"CreateProductType"},"CreateSpecialAccountPayload":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"account_type":{"type":"string","enum":["external-contract","influencer","education"],"title":"Account Type"},"user_type":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}],"title":"User Type","default":"owner"},"churn_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"Churn Date"},"plan_features":{"$ref":"#/components/schemas/PlanFeatures"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"convert":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Convert","default":false}},"type":"object","required":["account_type","churn_date","plan_features"],"title":"CreateSpecialAccountPayload"},"CustomCompanyNotePayload":{"properties":{"company_id":{"type":"string","title":"Company Id"},"custom_note":{"type":"string","title":"Custom Note"},"event_date":{"type":"string","title":"Event Date","default":"2026-10-12 17:09:20"}},"type":"object","required":["company_id","custom_note"],"title":"CustomCompanyNotePayload"},"CustomDashboard-Input":{"properties":{"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":""},"dashboard_metadata":{"$ref":"#/components/schemas/DashboardMetadata-Input"},"contents":{"$ref":"#/components/schemas/DashboardContents-Input"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"dashboard_id":{"type":"string","title":"Dashboard Id"},"created_by":{"additionalProperties":true,"type":"object","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["title","dashboard_metadata","contents","dashboard_id","created_by","created_at","last_updated"],"title":"CustomDashboard"},"CustomDashboard-Output":{"properties":{"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":""},"dashboard_metadata":{"$ref":"#/components/schemas/DashboardMetadata-Output"},"contents":{"$ref":"#/components/schemas/DashboardContents-Output"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"dashboard_id":{"type":"string","title":"Dashboard Id"},"created_by":{"additionalProperties":true,"type":"object","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"last_updated":{"type":"string","title":"Last Updated"}},"type":"object","required":["title","dashboard_metadata","contents","dashboard_id","created_by","created_at","last_updated"],"title":"CustomDashboard"},"CustomDashboardBase":{"properties":{"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":""},"dashboard_metadata":{"$ref":"#/components/schemas/DashboardMetadata-Input"},"contents":{"$ref":"#/components/schemas/DashboardContents-Input"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"}},"type":"object","required":["title","dashboard_metadata","contents"],"title":"CustomDashboardBase"},"CustomerApprovalPayload":{"properties":{"customer_id":{"type":"string","title":"Customer Id"},"approval_status":{"type":"string","enum":["approved","rejected","pending","pending_more_info"],"title":"Approval Status"}},"type":"object","required":["customer_id","approval_status"],"title":"CustomerApprovalPayload"},"CustomerFavoriteCompetitor":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"}},"type":"object","required":["company_ids"],"title":"CustomerFavoriteCompetitor"},"CustomerOnboardingFields":{"properties":{"name":{"type":"string","title":"Name"},"onboarding_fields":{"additionalProperties":true,"type":"object","title":"Onboarding Fields"}},"type":"object","required":["name","onboarding_fields"],"title":"CustomerOnboardingFields"},"CustomerProductSearchResponse":{"properties":{"products":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Products"}},"type":"object","required":["products"],"title":"CustomerProductSearchResponse"},"CustomerViewPayload":{"properties":{"params":{"$ref":"#/components/schemas/HashKeyParams"},"is_free_path":{"type":"boolean","title":"Is Free Path"},"user_agent_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"User Agent Info"}},"type":"object","required":["params","is_free_path"],"title":"CustomerViewPayload"},"DashboardContents-Input":{"properties":{"layout":{"items":{"$ref":"#/components/schemas/DashboardContentsLayout"},"type":"array","title":"Layout"},"elements":{"items":{"$ref":"#/components/schemas/DashboardContentsElement-Input"},"type":"array","title":"Elements"}},"type":"object","required":["layout","elements"],"title":"DashboardContents"},"DashboardContents-Output":{"properties":{"layout":{"items":{"$ref":"#/components/schemas/DashboardContentsLayout"},"type":"array","title":"Layout"},"elements":{"items":{"$ref":"#/components/schemas/DashboardContentsElement-Output"},"type":"array","title":"Elements"}},"type":"object","required":["layout","elements"],"title":"DashboardContents"},"DashboardContentsElement-Input":{"properties":{"chartTitle":{"type":"string","title":"Charttitle"},"chartType":{"type":"string","title":"Charttype"},"datasource":{"type":"string","title":"Datasource"},"filters":{"items":{"$ref":"#/components/schemas/DynamicFilter"},"type":"array","title":"Filters"},"chartConfigOptions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Chartconfigoptions"}},"additionalProperties":true,"type":"object","required":["chartTitle","chartType","datasource","filters"],"title":"DashboardContentsElement"},"DashboardContentsElement-Output":{"properties":{"chartTitle":{"type":"string","title":"Charttitle"},"chartType":{"type":"string","title":"Charttype"},"datasource":{"type":"string","title":"Datasource"},"filters":{"items":{"$ref":"#/components/schemas/DynamicFilter"},"type":"array","title":"Filters"},"chartConfigOptions":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Chartconfigoptions"}},"additionalProperties":true,"type":"object","required":["chartTitle","chartType","datasource","filters"],"title":"DashboardContentsElement"},"DashboardContentsLayout":{"properties":{"w":{"type":"integer","title":"W"},"h":{"type":"integer","title":"H"},"x":{"type":"integer","title":"X"},"y":{"type":"integer","title":"Y"},"i":{"type":"string","title":"I"},"minW":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minw"},"minH":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minh"},"maxW":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxw"},"maxH":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Maxh"}},"additionalProperties":true,"type":"object","required":["w","h","x","y","i"],"title":"DashboardContentsLayout"},"DashboardMetadata-Input":{"properties":{"companies":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Companies"},"global_filters":{"items":{"$ref":"#/components/schemas/DynamicFilter"},"type":"array","title":"Global Filters"},"static_date_range":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Static Date Range"}},"additionalProperties":true,"type":"object","required":["companies","global_filters"],"title":"DashboardMetadata"},"DashboardMetadata-Output":{"properties":{"companies":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Companies"},"global_filters":{"items":{"$ref":"#/components/schemas/DynamicFilter"},"type":"array","title":"Global Filters"},"static_date_range":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Static Date Range"}},"additionalProperties":true,"type":"object","required":["companies","global_filters"],"title":"DashboardMetadata"},"DataAvailable":{"properties":{"pricing":{"$ref":"#/components/schemas/DataAvailableEntity"},"sales":{"$ref":"#/components/schemas/DataAvailableEntity"},"location":{"$ref":"#/components/schemas/DataAvailableEntity"},"ratings":{"$ref":"#/components/schemas/DataAvailableEntity"},"ai_classification":{"$ref":"#/components/schemas/DataAvailableEntity"}},"type":"object","required":["pricing","sales","location","ratings","ai_classification"],"title":"DataAvailable"},"DataAvailableEntity":{"properties":{"available":{"type":"boolean","title":"Available"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"archived_start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archived Start Date"}},"type":"object","title":"DataAvailableEntity"},"DataPayload":{"properties":{"pagination":{"anyOf":[{"$ref":"#/components/schemas/PaginationBase"},{"type":"null"}],"default":{"page_number":0,"page_size":100}},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"sort_model":{"anyOf":[{"$ref":"#/components/schemas/SortModel"},{"items":{"$ref":"#/components/schemas/SortModel"},"type":"array"}],"title":"Sort Model"}},"type":"object","title":"DataPayload"},"DataQualityFlagPayload":{"properties":{"flag_id":{"type":"string","title":"Flag Id"}},"type":"object","required":["flag_id"],"title":"DataQualityFlagPayload"},"DataStatus":{"type":"integer","enum":[0,1,2],"title":"DataStatus"},"DateRange":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["start_date","end_date"],"title":"DateRange"},"DeleteCustomerPayload":{"properties":{"customer_id":{"type":"string","title":"Customer Id"}},"type":"object","required":["customer_id"],"title":"DeleteCustomerPayload"},"DeleteUserByEmailPayload":{"properties":{"email":{"type":"string","title":"Email"},"group_id":{"type":"string","title":"Group Id"}},"type":"object","required":["email","group_id"],"title":"DeleteUserByEmailPayload"},"DiscountType":{"type":"string","enum":["percentage","fixed"],"title":"DiscountType"},"DowngradeCompetitorsBody":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"signature_company_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Signature Company Ids"},"signature_only":{"type":"boolean","title":"Signature Only","default":false}},"type":"object","required":["company_ids"],"title":"DowngradeCompetitorsBody"},"DownloadReportRespsonse":{"properties":{"presigned_url":{"type":"string","title":"Presigned Url"}},"type":"object","required":["presigned_url"],"title":"DownloadReportRespsonse"},"DynamicFilter":{"properties":{"field":{"$ref":"#/components/schemas/FilterField"},"value":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"items":{"type":"string"},"type":"array"}],"title":"Value"},"operator":{"$ref":"#/components/schemas/FilterOperator"}},"type":"object","required":["field","value","operator"],"title":"DynamicFilter"},"ERAssembleRequest":{"properties":{"trends":{"items":{"$ref":"#/components/schemas/ERSelectedTrend"},"type":"array","title":"Trends"},"timeline":{"type":"string","title":"Timeline","default":"one_year"}},"type":"object","required":["trends"],"title":"ERAssembleRequest"},"ERAssembleResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"folds":{"items":{"$ref":"#/components/schemas/ERAssembledFold"},"type":"array","title":"Folds"}},"type":"object","required":["success","folds"],"title":"ERAssembleResponse"},"ERAssembledFold":{"properties":{"trendNumber":{"type":"integer","title":"Trendnumber"},"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"pillLabel":{"type":"string","title":"Pilllabel"},"headingText":{"type":"string","title":"Headingtext"},"name":{"type":"string","title":"Name"},"percentGrowthLabel":{"type":"string","title":"Percentgrowthlabel"},"timeFrame":{"type":"string","title":"Timeframe"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"ctaHref":{"type":"string","title":"Ctahref"},"primaryLinkHref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primarylinkhref"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producturl"},"productImageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productimageurl"},"productName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productname"},"whyItMatters":{"type":"string","title":"Whyitmatters"},"bodyParagraphs":{"items":{"type":"string"},"type":"array","title":"Bodyparagraphs"},"takeawayParagraphs":{"items":{"type":"string"},"type":"array","title":"Takeawayparagraphs"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["trendNumber","trendType","pillLabel","headingText","name","percentGrowthLabel","timeFrame","trendPageUrl","ctaHref","whyItMatters","bodyParagraphs","takeawayParagraphs"],"title":"ERAssembledFold"},"ERCandidate":{"properties":{"trendId":{"type":"string","title":"Trendid"},"tagType":{"type":"string","enum":["company","keyword","product_type","material"],"title":"Tagtype"},"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"name":{"type":"string","title":"Name"},"companyId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyid"},"productTypeId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producttypeid"},"growthThreeMonth":{"type":"number","title":"Growththreemonth"},"growthOneYear":{"type":"number","title":"Growthoneyear"},"growthThreeMonthLabel":{"type":"string","title":"Growththreemonthlabel"},"growthOneYearLabel":{"type":"string","title":"Growthoneyearlabel"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"companyOverviewUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyoverviewurl"},"companyDomain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companydomain"},"companyPublicProfileUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companypublicprofileurl"},"trendEvents":{"items":{"$ref":"#/components/schemas/ERTrendPoint"},"type":"array","title":"Trendevents","default":[]}},"type":"object","required":["trendId","tagType","trendType","name","growthThreeMonth","growthOneYear","growthThreeMonthLabel","growthOneYearLabel","trendPageUrl"],"title":"ERCandidate","description":"A candidate trend offered to the user for selection in the ER wizard."},"ERCandidatesRequest":{"properties":{"app_base_url":{"type":"string","title":"App Base Url","default":"https://app.particl.com"},"three_month_min":{"type":"number","title":"Three Month Min","default":9.0},"one_year_min":{"type":"number","title":"One Year Min","default":5.0},"company_count":{"type":"integer","title":"Company Count","default":6},"keyword_count":{"type":"integer","title":"Keyword Count","default":3},"product_type_count":{"type":"integer","title":"Product Type Count","default":3},"material_count":{"type":"integer","title":"Material Count","default":3},"refresh":{"type":"boolean","title":"Refresh","default":false},"refresh_tag_types":{"anyOf":[{"items":{"type":"string","enum":["company","keyword","product_type","material"]},"type":"array"},{"type":"null"}],"title":"Refresh Tag Types"},"exclude_trend_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Trend Ids"}},"type":"object","title":"ERCandidatesRequest","description":"Request for ER candidate trends (>900% 3-mo, positive 1-yr)."},"ERCandidatesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"candidates":{"items":{"$ref":"#/components/schemas/ERCandidate"},"type":"array","title":"Candidates"},"counts":{"additionalProperties":true,"type":"object","title":"Counts"}},"type":"object","required":["success","candidates","counts"],"title":"ERCandidatesResponse"},"ERMarkTrendRequest":{"properties":{"name":{"type":"string","title":"Name"},"tagType":{"type":"string","enum":["company","keyword","product_type","material"],"title":"Tagtype"},"mark":{"type":"string","enum":["defer","never","clear"],"title":"Mark"},"trendId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trendid"}},"type":"object","required":["name","tagType","mark"],"title":"ERMarkTrendRequest","description":"Apply a manual ER wizard mark to a candidate trend.\n\n`defer` / `never` write to `newsletter_used_trends` immediately; `clear`\nremoves an existing manual mark (undo). `used` is intentionally not a value\nhere: used trends are recorded only when the issue is sent in production."},"ERMarkTrendResponse":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"ERMarkTrendResponse"},"ERMoreCandidatesRequest":{"properties":{"tagType":{"type":"string","enum":["company","keyword","product_type","material"],"title":"Tagtype"},"offset":{"type":"integer","title":"Offset","default":0},"limit":{"type":"integer","title":"Limit","default":6},"one_year_min":{"type":"number","title":"One Year Min","default":5.0},"app_base_url":{"type":"string","title":"App Base Url","default":"https://app.particl.com"}},"type":"object","required":["tagType"],"title":"ERMoreCandidatesRequest"},"ERMoreCandidatesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"candidates":{"items":{"$ref":"#/components/schemas/ERCandidate"},"type":"array","title":"Candidates"}},"type":"object","required":["success","candidates"],"title":"ERMoreCandidatesResponse"},"ERProductOption":{"properties":{"companyId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyid"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productid"},"title":{"type":"string","title":"Title","default":""},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imageurl"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue"},"particlAppUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Particlappurl"},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyname"},"companyPublicProfileUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companypublicprofileurl"},"isHidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ishidden"},"salesVolume30d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salesvolume30D"},"warnings":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Warnings"}},"type":"object","title":"ERProductOption"},"ERResolveProductRequest":{"properties":{"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producturl"},"companyId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyid"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productid"}},"type":"object","title":"ERResolveProductRequest"},"ERResolveProductResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"product":{"anyOf":[{"$ref":"#/components/schemas/ERProductOption"},{"type":"null"}]}},"type":"object","required":["success"],"title":"ERResolveProductResponse"},"ERSelectedTrend":{"properties":{"trendId":{"type":"string","title":"Trendid"},"tagType":{"type":"string","enum":["company","keyword","product_type","material"],"title":"Tagtype"},"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"name":{"type":"string","title":"Name"},"companyId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyid"},"companyDomain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companydomain"},"growthOneYearLabel":{"type":"string","title":"Growthoneyearlabel"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producturl"},"productName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productname"},"productImageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productimageurl"},"whyItMatters":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whyitmatters"},"aboutPageInfo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aboutpageinfo"}},"type":"object","required":["trendId","tagType","trendType","name","growthOneYearLabel","trendPageUrl"],"title":"ERSelectedTrend"},"ERTopProductsRequest":{"properties":{"trendId":{"type":"string","title":"Trendid"},"tagType":{"type":"string","enum":["company","keyword","product_type","material"],"title":"Tagtype"},"companyId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyid"},"limit":{"type":"integer","title":"Limit","default":5}},"type":"object","required":["trendId","tagType"],"title":"ERTopProductsRequest"},"ERTopProductsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"products":{"items":{"$ref":"#/components/schemas/ERProductOption"},"type":"array","title":"Products"}},"type":"object","required":["success","products"],"title":"ERTopProductsResponse"},"ERTrendPoint":{"properties":{"date":{"type":"string","title":"Date"},"value":{"type":"number","title":"Value"}},"type":"object","required":["date","value"],"title":"ERTrendPoint","description":"A single weekly trend data point, for rendering sparklines on candidate cards."},"EnhancedCompanyDetail":{"properties":{"company_id":{"type":"string","title":"Company Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"data_available":{"$ref":"#/components/schemas/DataAvailable"},"company_type":{"type":"string","enum":["online","brick_and_mortar"],"title":"Company Type"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"bad_collection":{"additionalProperties":true,"type":"object","title":"Bad Collection","default":{}},"company_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Price"},"is_signature":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Signature"}},"type":"object","required":["company_id","name","domain","data_available","company_type"],"title":"EnhancedCompanyDetail"},"EnhancedCustomDashboard":{"properties":{"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":""},"dashboard_metadata":{"$ref":"#/components/schemas/DashboardMetadata-Output"},"contents":{"$ref":"#/components/schemas/DashboardContents-Output"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"},"dashboard_id":{"type":"string","title":"Dashboard Id"},"created_by":{"additionalProperties":true,"type":"object","title":"Created By"},"created_at":{"type":"string","title":"Created At"},"last_updated":{"type":"string","title":"Last Updated"},"companies":{"items":{"$ref":"#/components/schemas/SimpleCompanyDetail"},"type":"array","title":"Companies"},"view_count":{"type":"integer","title":"View Count"}},"type":"object","required":["title","dashboard_metadata","contents","dashboard_id","created_by","created_at","last_updated","companies","view_count"],"title":"EnhancedCustomDashboard"},"ErFoldFeedbackEntry":{"properties":{"issue_date":{"type":"string","title":"Issue Date"},"fold":{"type":"integer","title":"Fold"},"event":{"type":"string","enum":["assemble","pre_review","post_review","editor_handoff","issue_handoff","production_send","feedback_submit"],"title":"Event"},"prompts_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompts Version"},"trend_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"inputs":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Inputs"},"generated_after_assemble":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Generated After Assemble"},"after_user_edit":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"After User Edit"},"after_issue_review":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"After Issue Review"},"final_body":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Final Body"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["issue_date","fold","event"],"title":"ErFoldFeedbackEntry","description":"One ER wizard feedback row for self-improve loops."},"ErFoldFeedbackRequest":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ErFoldFeedbackEntry"},"type":"array","title":"Rows"}},"type":"object","required":["rows"],"title":"ErFoldFeedbackRequest"},"ErFoldFeedbackResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"written":{"type":"integer","title":"Written"}},"type":"object","required":["success","written"],"title":"ErFoldFeedbackResponse"},"ErFoldTextForReview":{"properties":{"trendNumber":{"type":"integer","title":"Trendnumber"},"name":{"type":"string","title":"Name"},"pillLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pilllabel"},"trendType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trendtype"},"percentGrowthLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Percentgrowthlabel"},"timeFrame":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"productName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productname"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producturl"},"whyItMatters":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whyitmatters"},"maxWords":{"type":"integer","title":"Maxwords","default":90},"bodyParagraphs":{"items":{"type":"string"},"type":"array","title":"Bodyparagraphs"},"takeawayParagraphs":{"items":{"type":"string"},"type":"array","title":"Takeawayparagraphs","default":[]}},"type":"object","required":["trendNumber","name","bodyParagraphs"],"title":"ErFoldTextForReview","description":"ER fold text sent for cross-section issue review."},"ErReviewIssueRequest":{"properties":{"folds":{"items":{"$ref":"#/components/schemas/ErFoldTextForReview"},"type":"array","title":"Folds"}},"type":"object","required":["folds"],"title":"ErReviewIssueRequest","description":"Request to review all ER folds in one issue together."},"ErReviewIssueResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"folds":{"items":{"$ref":"#/components/schemas/ErFoldTextForReview"},"type":"array","title":"Folds"},"issues":{"items":{"type":"string"},"type":"array","title":"Issues","default":[]}},"type":"object","required":["success","folds"],"title":"ErReviewIssueResponse","description":"Response from ER issue review."},"EventsListBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","default":"2026-09-10"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","default":"2026-10-10"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"pagination":{"$ref":"#/components/schemas/PaginationBase"}},"type":"object","required":["pagination"],"title":"EventsListBody"},"FilterField":{"type":"string","enum":["title","product_type","product_type_name","promotion_asset_type","gender","color","size","brand","material","price","sales_revenue","sales_volume","avg_discount","companies","keyword","variant_title","raw_color","raw_size","product_tag","launch_date","company_id","product_id","variant_id","avg_rating","review_count","similar_product_id","nps_score","state","location_id","gtm_company_id","gtm_company_name","gtm_person_name","gtm_person_id","gtm_agent_id","gtm_event_type","gtm_deal_stage","gtm_business_type","gtm_channel","gtm_lead_source","gtm_plan_type","gtm_task_status","gtm_set_date","gtm_demo_date","gtm_close_date","gtm_win_date","gtm_task_task_type","gtm_setter_id","gtm_vertical","gtm_subvertical","gtm_headcount","primary_location","gtm_job_title","gtm_role_id","reason_lost","gtm_social_media_platform","gtm_campaign_name","gtm_influencer_name","gtm_influencer_dropshipper","data_task_company_name","data_task_task_type","data_task_status","data_task_assigned_to","data_task_company_id","data_task_error_type","data_task_pbsr_revenue_direction","data_task_created_on","data_task_view_count_90d","finance_customer_status","finance_customer_account_type","finance_customer_customer_id","finance_customer_name","finance_customer_created_date","finance_customer_churn_date","finance_customer_vertical","finance_customer_head_count","finance_customer_lead_source","finance_customer_sales_owner","finance_customer_cx_managed","finance_customer_total_spent","finance_customer_current_subscription_amount","finance_contract_billing_frequency","finance_contract_status","finance_contract_type","finance_customer_columns","ops_accounts_receivable_previous_outstanding_amount","ops_accounts_receivable_total_due","ops_accounts_receivable_total_paid","ops_accounts_receivable_current_outstanding_amount","ops_customer_onboarding_status","ops_customer_is_onboarded","product_explorer_estimated_sales_revenue","product_explorer_estimated_sales_volume","product_explorer_product_type","product_categorization_product_type","product_type_overridden","product_has_sales","trend","growth_status","volatility","forecast","speed","timeline","trend_name","vertical"],"title":"FilterField"},"FilterOperator":{"type":"string","enum":["is_exactly","is_descendant_of","contains","does_not_contain","greater_than","less_than","contains_exactly","is_not","relative_days_ago"],"title":"FilterOperator"},"FinancePayload":{"properties":{"pagination":{"anyOf":[{"$ref":"#/components/schemas/PaginationBase"},{"type":"null"}],"default":{"page_number":0,"page_size":100}},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"sort_model":{"anyOf":[{"$ref":"#/components/schemas/SortModel"},{"items":{"$ref":"#/components/schemas/SortModel"},"type":"array"}],"title":"Sort Model"},"date_range":{"$ref":"#/components/schemas/DateRange"},"selected_month":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Month"}},"type":"object","title":"FinancePayload"},"FixerApplyActionPayload":{"properties":{"task_id":{"type":"string","title":"Task Id"},"action":{"type":"string","title":"Action"},"fixer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fixer Key"},"company_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"deviation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deviation Reason"},"script_winner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Winner"},"product_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Product Urls"},"confidence_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confidence Score"},"confidence_n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confidence N"},"evidence_snapshot":{"anyOf":[{"items":{},"type":"array"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence Snapshot"},"run_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Date"}},"additionalProperties":true,"type":"object","required":["task_id","action"],"title":"FixerApplyActionPayload"},"FixerApplyBulkPayload":{"properties":{"actions":{"items":{"$ref":"#/components/schemas/FixerApplyActionPayload"},"type":"array","title":"Actions"},"auto_applied":{"type":"boolean","title":"Auto Applied","default":false},"applied_by":{"type":"string","title":"Applied By","default":"system"}},"type":"object","required":["actions"],"title":"FixerApplyBulkPayload"},"FoldBodyForRefine":{"properties":{"bodyParagraph1":{"type":"string","title":"Bodyparagraph1"},"bodyParagraph2":{"type":"string","title":"Bodyparagraph2"},"bodyParagraph3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bodyparagraph3"}},"type":"object","required":["bodyParagraph1","bodyParagraph2"],"title":"FoldBodyForRefine","description":"Body text for one fold."},"FullcartCatalogProductReference":{"properties":{"company_id":{"type":"string","minLength":1,"title":"Company Id"},"product_id":{"type":"string","minLength":1,"title":"Product Id"}},"type":"object","required":["company_id","product_id"],"title":"FullcartCatalogProductReference"},"FullcartMissingCatalogProduct":{"properties":{"company_id":{"type":"string","minLength":1,"title":"Company Id"},"product_id":{"type":"string","minLength":1,"title":"Product Id"},"reason":{"type":"string","enum":["no_visible_variants","query_failed"],"title":"Reason"}},"type":"object","required":["company_id","product_id","reason"],"title":"FullcartMissingCatalogProduct"},"FullcartProductVariantSnapshots":{"properties":{"company_id":{"type":"string","minLength":1,"title":"Company Id"},"product_id":{"type":"string","minLength":1,"title":"Product Id"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"variants":{"items":{"$ref":"#/components/schemas/FullcartVariantSnapshot"},"type":"array","title":"Variants"}},"type":"object","required":["company_id","product_id","variants"],"title":"FullcartProductVariantSnapshots"},"FullcartVariantSnapshot":{"properties":{"variant_id":{"type":"string","title":"Variant Id"},"variant_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Title"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Barcode"},"raw_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Color"},"predicted_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicted Color"},"predicted_color_specific":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicted Color Specific"},"raw_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Size"},"predicted_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predicted Size"},"normalized_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Size"},"attributes":{"anyOf":[{},{"type":"null"}],"title":"Attributes"},"current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Price"},"full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Full Price"},"price_status":{"type":"string","enum":["available","ambiguous","unavailable"],"title":"Price Status"},"price_observed_at":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Price Observed At"},"price_refreshed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Price Refreshed At"},"price_is_gap_filled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Price Is Gap Filled"},"available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Available"}},"type":"object","required":["variant_id","price_status"],"title":"FullcartVariantSnapshot"},"FullcartVariantSnapshotsMeta":{"properties":{"requested_product_count":{"type":"integer","title":"Requested Product Count"},"returned_product_count":{"type":"integer","title":"Returned Product Count"},"returned_variant_count":{"type":"integer","title":"Returned Variant Count"}},"type":"object","required":["requested_product_count","returned_product_count","returned_variant_count"],"title":"FullcartVariantSnapshotsMeta"},"FullcartVariantSnapshotsRequest":{"properties":{"products":{"items":{"$ref":"#/components/schemas/FullcartCatalogProductReference"},"type":"array","maxItems":25,"minItems":1,"title":"Products"}},"type":"object","required":["products"],"title":"FullcartVariantSnapshotsRequest"},"FullcartVariantSnapshotsResponse":{"properties":{"products":{"items":{"$ref":"#/components/schemas/FullcartProductVariantSnapshots"},"type":"array","title":"Products"},"missing":{"items":{"$ref":"#/components/schemas/FullcartMissingCatalogProduct"},"type":"array","title":"Missing"},"meta":{"$ref":"#/components/schemas/FullcartVariantSnapshotsMeta"}},"type":"object","required":["products","missing","meta"],"title":"FullcartVariantSnapshotsResponse"},"GapFillPayload":{"properties":{"destination_start_date":{"type":"string","title":"Destination Start Date"},"destination_end_date":{"type":"string","title":"Destination End Date"},"source_start_date":{"type":"string","title":"Source Start Date"}},"type":"object","required":["destination_start_date","destination_end_date","source_start_date"],"title":"GapFillPayload"},"GenerateTextBatchRequest":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"GenerateTextBatchRequest","description":"Request to generate newsletter text for multiple folds from plain text blocks."},"GenerateTextBatchResponse":{"properties":{"output":{"type":"string","title":"Output"}},"type":"object","required":["output"],"title":"GenerateTextBatchResponse","description":"Response with generated text for all folds, separated by _____."},"GroupEdit":{"properties":{"group_id":{"type":"string","title":"Group Id"},"competitor_dataset_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Competitor Dataset Limit"},"location_dataset_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Location Dataset Limit"},"seat_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seat Limit"},"plan_features":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Plan Features"}},"type":"object","required":["group_id"],"title":"GroupEdit"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HashKeyParams":{"properties":{"path":{"type":"string","title":"Path"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"company_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Ids"},"filters":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Filters"},"filter_operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filter Operator"},"numeric_filter_operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numeric Filter Operator"},"pagination":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pagination"},"sort_model":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sort Model"},"row_field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Row Field"},"column_field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Column Field"},"agg_field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agg Field"},"agg_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agg Strategy"},"data_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Status"},"confidence_threshold":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confidence Threshold"},"aggregation_type_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aggregation Type Override"}},"type":"object","required":["path"],"title":"HashKeyParams"},"InternalNotificationPreviewBody":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"InternalNotificationPreviewBody"},"InternalRemoveCompetitorBody":{"properties":{"company_id":{"type":"string","title":"Company Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","required":["company_id"],"title":"InternalRemoveCompetitorBody"},"InternalUnsubscribeCommunicationsBody":{"properties":{"email":{"type":"string","title":"Email"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"action":{"type":"string","enum":["unsubscribe","subscribe"],"title":"Action","default":"unsubscribe"}},"type":"object","required":["email","channels"],"title":"InternalUnsubscribeCommunicationsBody"},"JobManagementPayload":{"properties":{"job_type":{"type":"string","title":"Job Type"},"action":{"type":"string","title":"Action"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"older_than_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Older Than Date"},"value":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Value"},"batch_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Batch Size"},"concurrency":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Concurrency"}},"type":"object","required":["job_type","action"],"title":"JobManagementPayload"},"ListReportsResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/Report"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"ListReportsResponse"},"LoadNewsletterResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"newsletter_data":{"$ref":"#/components/schemas/NewsletterBuilderData"},"newsletter_id":{"type":"string","title":"Newsletter Id"}},"type":"object","required":["success","newsletter_data","newsletter_id"],"title":"LoadNewsletterResponse","description":"Response when loading saved newsletter."},"LooseProductResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false}},"type":"object","title":"LooseProductResearchBody"},"LowToHighJobActionPayload":{"properties":{"job_ids":{"items":{"type":"string"},"type":"array","title":"Job Ids"},"action":{"type":"string","title":"Action"},"replacement_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replacement Domain"}},"type":"object","required":["job_ids","action"],"title":"LowToHighJobActionPayload"},"ManualInfluencerAddBody":{"properties":{"platform":{"type":"string","enum":["instagram","tiktok"],"title":"Platform"},"handle":{"type":"string","title":"Handle"}},"type":"object","required":["platform","handle"],"title":"ManualInfluencerAddBody"},"MarketDetailsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"total_products":{"type":"integer","title":"Total Products"},"total_companies":{"type":"integer","title":"Total Companies"},"products":{"items":{},"type":"array","title":"Products"}},"type":"object","required":["success","total_products","total_companies","products"],"title":"MarketDetailsResponse"},"MarketPricingResponse":{"properties":{"summary":{"$ref":"#/components/schemas/PricingSummary"},"price_buckets":{"items":{"$ref":"#/components/schemas/PriceBuckets"},"type":"array","title":"Price Buckets"}},"type":"object","required":["summary","price_buckets"],"title":"MarketPricingResponse"},"MarketProductTagSearchPayload":{"properties":{"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters"},"tag_type":{"type":"string","enum":["product_type","material","keyword","gender"],"title":"Tag Type"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},"type":"object","required":["filters","tag_type"],"title":"MarketProductTagSearchPayload"},"MarketResearchPayload":{"properties":{"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"country_codes":{"anyOf":[{"items":{"type":"string","pattern":"^[A-Z]{2}$"},"type":"array"},{"type":"null"}],"title":"Country Codes"},"page":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Page","default":0},"page_size":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Page Size","default":25},"confidence_threshold":{"anyOf":[{"type":"number","maximum":10.0,"minimum":0.0},{"type":"null"}],"title":"Confidence Threshold","default":6.0}},"type":"object","required":["filters"],"title":"MarketResearchPayload"},"MarketResearchTrendPayload":{"properties":{"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"country_codes":{"anyOf":[{"items":{"type":"string","pattern":"^[A-Z]{2}$"},"type":"array"},{"type":"null"}],"title":"Country Codes"},"page":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Page","default":0},"page_size":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Page Size","default":25},"confidence_threshold":{"anyOf":[{"type":"number","maximum":10.0,"minimum":0.0},{"type":"null"}],"title":"Confidence Threshold","default":6.0},"show_company_competitors":{"type":"boolean","title":"Show Company Competitors","default":false}},"type":"object","required":["filters"],"title":"MarketResearchTrendPayload"},"MarketSalesDataResponse":{"properties":{"monthly_timeseries":{"items":{},"type":"array","title":"Monthly Timeseries"},"quarterly_timeseries":{"items":{},"type":"array","title":"Quarterly Timeseries"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"}},"type":"object","required":["monthly_timeseries","quarterly_timeseries","sales_revenue","sales_volume"],"title":"MarketSalesDataResponse"},"MarketTopCompaniesResponse":{"properties":{"top_companies":{"items":{"$ref":"#/components/schemas/MarketTopCompany"},"type":"array","title":"Top Companies"},"overall_total_sales_revenue":{"type":"number","title":"Overall Total Sales Revenue"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["top_companies","overall_total_sales_revenue","total_count"],"title":"MarketTopCompaniesResponse"},"MarketTopCompany":{"properties":{"company_id":{"type":"string","title":"Company Id"},"company_score":{"type":"number","title":"Company Score"},"domain":{"type":"string","title":"Domain"},"name":{"type":"string","title":"Name"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"}},"type":"object","required":["company_id","company_score","domain","name","sales_revenue","sales_volume"],"title":"MarketTopCompany"},"MarketTopProduct":{"properties":{"company_id":{"type":"string","title":"Company Id"},"current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Price"},"min_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Current Price"},"max_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Current Price"},"full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Full Price"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"product_id":{"type":"string","title":"Product Id"},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"product_url":{"type":"string","title":"Product Url"},"product_title":{"type":"string","title":"Product Title"},"product_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Product Score"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue"},"units_moved":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Moved"}},"type":"object","required":["company_id","current_price","min_current_price","max_current_price","full_price","image_url","product_id","product_type","product_url","product_title","product_score","revenue","units_moved"],"title":"MarketTopProduct"},"MarketTopProductsResponse":{"properties":{"top_products":{"items":{"$ref":"#/components/schemas/MarketTopProduct"},"type":"array","title":"Top Products"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["top_products","total_count"],"title":"MarketTopProductsResponse"},"MarketingEventBatchPayload":{"properties":{"events":{"items":{"$ref":"#/components/schemas/MarketingEventPayload"},"type":"array","maxItems":10,"minItems":1,"title":"Events"}},"type":"object","required":["events"],"title":"MarketingEventBatchPayload"},"MarketingEventPayload":{"properties":{"event_id":{"type":"string","maxLength":36,"minLength":36,"title":"Event Id"},"visitor_cookie":{"type":"string","maxLength":36,"minLength":36,"title":"Visitor Cookie"},"event_type":{"type":"string","maxLength":32,"minLength":1,"title":"Event Type"},"path":{"type":"string","maxLength":512,"minLength":1,"title":"Path"},"search":{"anyOf":[{"type":"string","maxLength":511},{"type":"null"}],"title":"Search"},"url":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Url"},"page_type":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Page Type"},"content_slug":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Content Slug"},"page_title":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Page Title"},"locale":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Locale"},"cta_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Cta Id"},"cta_location":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Cta Location"},"destination_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Destination Url"},"referrer":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Referrer"},"utm_source":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Utm Content"},"user_agent":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"User Agent"}},"type":"object","required":["event_id","visitor_cookie","event_type","path"],"title":"MarketingEventPayload"},"McpResolveKeyRequest":{"properties":{"mcp_key":{"type":"string","title":"Mcp Key"}},"type":"object","required":["mcp_key"],"title":"McpResolveKeyRequest"},"McpServiceToolCallLogRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"duration_ms":{"type":"number","title":"Duration Ms"},"status":{"type":"string","title":"Status"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"record_count":{"type":"integer","title":"Record Count","default":0},"credit_cost":{"type":"integer","title":"Credit Cost","default":0},"request_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Params"},"client_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Info"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","required":["tool_name","duration_ms","status"],"title":"McpServiceToolCallLogRequest"},"McpToolCallLogRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"duration_ms":{"type":"number","title":"Duration Ms"},"status":{"type":"string","title":"Status"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"record_count":{"type":"integer","title":"Record Count","default":0},"credit_cost":{"type":"integer","title":"Credit Cost","default":0},"request_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Params"},"client_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Info"}},"type":"object","required":["tool_name","duration_ms","status"],"title":"McpToolCallLogRequest"},"McpToolSummary":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"total_calls":{"type":"integer","title":"Total Calls"},"total_credits":{"type":"integer","title":"Total Credits"},"total_records":{"type":"integer","title":"Total Records"}},"type":"object","required":["tool_name","total_calls","total_credits","total_records"],"title":"McpToolSummary"},"McpUsageListResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/McpUsageRecord"},"type":"array","title":"Results"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["results","meta"],"title":"McpUsageListResponse"},"McpUsageRecord":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"tool_name":{"type":"string","title":"Tool Name"},"record_count":{"type":"integer","title":"Record Count"},"credit_cost":{"type":"integer","title":"Credit Cost"},"request_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Params"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","user_id","tool_name","record_count","credit_cost","created_at"],"title":"McpUsageRecord"},"McpUsageRequest":{"properties":{"tool_name":{"type":"string","title":"Tool Name"},"record_count":{"type":"integer","title":"Record Count"},"credit_cost":{"type":"integer","title":"Credit Cost"},"request_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Params"}},"type":"object","required":["tool_name","record_count","credit_cost"],"title":"McpUsageRequest"},"McpUsageSummaryResponse":{"properties":{"total_credits_used":{"type":"integer","title":"Total Credits Used"},"total_calls":{"type":"integer","title":"Total Calls"},"by_tool":{"items":{"$ref":"#/components/schemas/McpToolSummary"},"type":"array","title":"By Tool"},"by_user":{"items":{"$ref":"#/components/schemas/McpUserSummary"},"type":"array","title":"By User"}},"type":"object","required":["total_credits_used","total_calls","by_tool","by_user"],"title":"McpUsageSummaryResponse"},"McpUsageTimeseriesPoint":{"properties":{"date":{"type":"string","title":"Date"},"total_credits":{"type":"integer","title":"Total Credits"},"total_calls":{"type":"integer","title":"Total Calls"}},"type":"object","required":["date","total_credits","total_calls"],"title":"McpUsageTimeseriesPoint"},"McpUsageTimeseriesResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/McpUsageTimeseriesPoint"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"McpUsageTimeseriesResponse"},"McpUserSummary":{"properties":{"user_id":{"type":"string","title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"total_calls":{"type":"integer","title":"Total Calls"},"total_credits":{"type":"integer","title":"Total Credits"}},"type":"object","required":["user_id","total_calls","total_credits"],"title":"McpUserSummary"},"MergePayload":{"properties":{"new_customer_id":{"type":"string","title":"New Customer Id"}},"type":"object","required":["new_customer_id"],"title":"MergePayload"},"MigrateNewsletterUserPayload":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"MigrateNewsletterUserPayload"},"MissingProduct":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"product_title":{"type":"string","title":"Product Title"},"product_url":{"type":"string","title":"Product Url"},"fully_qualified_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fully Qualified Path"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"product_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Image"},"product_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type Id"}},"type":"object","required":["company_id","product_id","product_title","product_url"],"title":"MissingProduct"},"MissingProductResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/MissingProduct"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"MissingProductResponse"},"NewUserPayload":{"properties":{"email":{"type":"string","title":"Email"},"group_id":{"type":"string","title":"Group Id"},"type":{"type":"string","enum":["admin","owner","member","basic"],"title":"Type"},"is_resend":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Resend","default":false},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firstname"},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastname"}},"type":"object","required":["email","group_id","type"],"title":"NewUserPayload"},"NewsletterBuilderData":{"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date"},"headerImage":{"type":"string","title":"Headerimage"},"trends":{"items":{"$ref":"#/components/schemas/TrendData"},"type":"array","maxItems":6,"minItems":1,"title":"Trends"}},"type":"object","required":["date","headerImage","trends"],"title":"NewsletterBuilderData","description":"Complete newsletter builder data structure."},"NewsletterBuilderResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"newsletter_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Newsletter Id"},"html_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Html Content"},"message":{"type":"string","title":"Message"},"source_zip_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Zip Url"}},"type":"object","required":["success","message"],"title":"NewsletterBuilderResponse","description":"Response from newsletter builder operations."},"OffboardCustomer":{"properties":{"group_id":{"type":"string","title":"Group Id"},"new_status":{"type":"string","title":"New Status"}},"type":"object","required":["group_id","new_status"],"title":"OffboardCustomer"},"OrderBy":{"properties":{"field":{"type":"string","enum":["sales_revenue","sales_volume","avg_current_price","launch_date","rate_sold","date","avg_discount","count","avg_rating","review_count","sell_through_rate","bayesian_avg","product_title"],"title":"Field","default":"sales_revenue"},"direction":{"type":"string","enum":["asc","desc"],"title":"Direction","default":"desc"}},"type":"object","title":"OrderBy"},"OutboundPayload":{"properties":{"pagination":{"anyOf":[{"$ref":"#/components/schemas/PaginationBase"},{"type":"null"}],"default":{"page_number":0,"page_size":100}},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"sort_model":{"$ref":"#/components/schemas/SortModel"},"date_range":{"$ref":"#/components/schemas/DateRange"}},"type":"object","title":"OutboundPayload"},"PaginationBase":{"properties":{"page_number":{"type":"integer","minimum":0.0,"title":"Page Number","default":0},"page_size":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Page Size","default":100}},"type":"object","title":"PaginationBase"},"PaginationMeta":{"properties":{"page_number":{"type":"integer","minimum":0.0,"title":"Page Number","default":0},"page_size":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Page Size","default":100},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["total_count"],"title":"PaginationMeta"},"ParentCompanyDetail":{"properties":{"parent_company_id":{"type":"string","title":"Parent Company Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"companies":{"items":{"$ref":"#/components/schemas/EnhancedCompanyDetail"},"type":"array","title":"Companies"}},"type":"object","required":["parent_company_id","name","domain","companies"],"title":"ParentCompanyDetail"},"ParseReferencePlainRequest":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"ParseReferencePlainRequest","description":"Request body for parsing plain text reference data."},"ParsedReferenceData":{"properties":{"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"name":{"type":"string","title":"Name"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"homepageSearchUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homepagesearchurl"},"percentGrowth":{"type":"string","title":"Percentgrowth"},"timeFrame":{"type":"string","title":"Timeframe"},"aboutPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aboutpageurl"},"productPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productpageurl"},"productName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productname"},"wordCount":{"type":"integer","title":"Wordcount"},"whyItMatters":{"type":"string","title":"Whyitmatters"}},"type":"object","required":["trendType","name","trendPageUrl","percentGrowth","timeFrame","wordCount","whyItMatters"],"title":"ParsedReferenceData","description":"Parsed reference data from RTF or plain text."},"PatchSavedProductCollectionBody":{"properties":{"collection_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Name"}},"type":"object","title":"PatchSavedProductCollectionBody"},"PbsrRevenueBatchBody":{"properties":{"company_ids":{"items":{"type":"string"},"type":"array","title":"Company Ids"},"event_date":{"type":"string","title":"Event Date"}},"type":"object","required":["company_ids","event_date"],"title":"PbsrRevenueBatchBody","description":"Batch fetch revenue for PBSR task generation - matches company products page."},"PbsrZeroMicroCompletionPayload":{"properties":{"reason":{"type":"string","title":"Reason"},"custom_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Reason"},"completion_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Note"}},"type":"object","required":["reason"],"title":"PbsrZeroMicroCompletionPayload","description":"Machine ``reason`` codes from Data Center PBSR micro completion dropdown."},"PivotProduct":{"properties":{"product_type":{"type":"string","title":"Product Type","default":"Uncategorized"},"gender":{"type":"string","title":"Gender","default":"Uncategorized"},"keyword":{"type":"string","title":"Keyword","default":"Uncategorized"},"material":{"type":"string","title":"Material","default":"Uncategorized"},"color":{"type":"string","title":"Color","default":"Uncategorized"},"fully_qualified_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fully Qualified Path"}},"additionalProperties":true,"type":"object","title":"PivotProduct"},"PlanFeatures":{"properties":{"competitor_limit":{"type":"integer","title":"Competitor Limit"},"signature_competitor_limit":{"type":"integer","title":"Signature Competitor Limit"},"signature_competitor_access":{"type":"boolean","title":"Signature Competitor Access"},"historical_months_limit":{"type":"integer","title":"Historical Months Limit"},"market_and_trend_analysis":{"type":"boolean","title":"Market And Trend Analysis"},"copilot":{"type":"boolean","title":"Copilot"},"custom_dashboards":{"type":"boolean","title":"Custom Dashboards"},"seats":{"type":"integer","title":"Seats"},"views_limit":{"type":"integer","title":"Views Limit"},"monthly_export_credits":{"type":"integer","title":"Monthly Export Credits","default":0}},"type":"object","required":["competitor_limit","signature_competitor_limit","signature_competitor_access","historical_months_limit","market_and_trend_analysis","copilot","custom_dashboards","seats","views_limit"],"title":"PlanFeatures"},"PlanType":{"type":"string","enum":["free-trial","tier-1-monthly","tier-1-yearly","tier-2-monthly","tier-2-yearly","tier-3-monthly","tier-3-yearly","tier-3-one-time","custom-plan"],"title":"PlanType"},"PostProductCollectionBody":{"properties":{"collection_name":{"type":"string","title":"Collection Name"},"products":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Products"}},"type":"object","required":["collection_name"],"title":"PostProductCollectionBody"},"PresetBody":{"properties":{"filters":{"items":{"$ref":"#/components/schemas/DynamicFilter"},"type":"array","title":"Filters"},"sort_field":{"type":"string","title":"Sort Field"},"sort_direction":{"type":"string","enum":["asc","desc"],"title":"Sort Direction"},"boolean_mode":{"type":"string","enum":["any","all"],"title":"Boolean Mode"},"preset_name":{"type":"string","title":"Preset Name"},"page_location_id":{"type":"string","enum":["PRODUCT_RESEARCH","COMPETITOR_RESEARCH","VARIANT_DETAILS"],"title":"Page Location Id"},"preset_metadata":{"additionalProperties":true,"type":"object","title":"Preset Metadata"}},"type":"object","required":["filters","sort_field","sort_direction","boolean_mode","preset_name","page_location_id","preset_metadata"],"title":"PresetBody"},"PreviewCustomAudienceRequest":{"properties":{"custom_query":{"type":"string","title":"Custom Query"},"subject":{"type":"string","title":"Subject"}},"type":"object","required":["custom_query","subject"],"title":"PreviewCustomAudienceRequest","description":"Request to preview custom audience query."},"PreviewCustomAudienceResponse":{"properties":{"count":{"type":"integer","title":"Count"},"sample_emails":{"items":{"type":"string"},"type":"array","title":"Sample Emails"},"query":{"type":"string","title":"Query"}},"type":"object","required":["count","sample_emails","query"],"title":"PreviewCustomAudienceResponse","description":"Response from custom audience preview."},"PreviewRequest":{"properties":{"newsletter_type":{"type":"string","enum":["dtc","exploding-retail","marketing","product-updates","one-off-email"],"title":"Newsletter Type"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date"},"timestamp":{"type":"string","title":"Timestamp"},"has_header":{"type":"boolean","title":"Has Header","default":true}},"type":"object","required":["newsletter_type","date","timestamp"],"title":"PreviewRequest","description":"Request to generate newsletter preview."},"PreviewResponse":{"properties":{"subject":{"type":"string","title":"Subject"},"html_content":{"type":"string","title":"Html Content"},"image_urls":{"items":{"type":"string"},"type":"array","title":"Image Urls"},"image_count":{"type":"integer","title":"Image Count"}},"type":"object","required":["subject","html_content","image_urls","image_count"],"title":"PreviewResponse","description":"Response with newsletter preview."},"PriceBucket":{"properties":{"price_bucket_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Bucket Id"},"price_range_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Range Min"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"total_sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Volume"},"total_sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Revenue"}},"type":"object","title":"PriceBucket"},"PriceBuckets":{"properties":{"price_bucket_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Bucket Id"},"price_range_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price Range Min"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"total_sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Volume"},"total_sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Revenue"}},"type":"object","required":["price_bucket_id","price_range_min","product_count","total_sales_volume","total_sales_revenue"],"title":"PriceBuckets"},"PricesResearchResponse":{"properties":{"price_buckets":{"items":{"$ref":"#/components/schemas/PriceBucket"},"type":"array","title":"Price Buckets"}},"type":"object","required":["price_buckets"],"title":"PricesResearchResponse"},"PricingSummary":{"properties":{"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"mean_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Price"},"median_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median Price"}},"type":"object","required":["min_price","max_price","mean_price","median_price"],"title":"PricingSummary"},"ProcessAssetsRequest":{"properties":{"newsletter_type":{"type":"string","enum":["dtc","exploding-retail","marketing","product-updates","one-off-email"],"title":"Newsletter Type"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date"},"html_content":{"type":"string","title":"Html Content"},"has_header":{"type":"boolean","title":"Has Header","default":true}},"type":"object","required":["newsletter_type","date","html_content"],"title":"ProcessAssetsRequest","description":"Request to process newsletter assets."},"ProcessAssetsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"image_count":{"type":"integer","title":"Image Count"},"status":{"type":"string","title":"Status"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message","default":"Assets processed successfully"}},"type":"object","required":["success","image_count","status","timestamp"],"title":"ProcessAssetsResponse","description":"Response from asset processing."},"ProcessBuilderNewsletterResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"timestamp":{"type":"string","title":"Timestamp"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","timestamp","message"],"title":"ProcessBuilderNewsletterResponse","description":"Response from processing builder newsletter for sending."},"ProcessingFailureApprovalPayload":{"properties":{"reason":{"type":"string","title":"Reason"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"selected_processing_option":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Processing Option"}},"type":"object","required":["reason"],"title":"ProcessingFailureApprovalPayload"},"ProductBenchmarkCompany":{"properties":{"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"company_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"avg_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Price"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},"type":"object","title":"ProductBenchmarkCompany"},"ProductBenchmarkCompanyResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ProductBenchmarkCompany"},"type":"array","title":"Results"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["results","total_count"],"title":"ProductBenchmarkCompanyResponse"},"ProductDataQualityConfidenceBatchRequest":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_ids":{"items":{"type":"string"},"type":"array","title":"Product Ids"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["company_id","product_ids","start_date","end_date"],"title":"ProductDataQualityConfidenceBatchRequest"},"ProductExplorerResearchPayload":{"properties":{"pagination":{"anyOf":[{"$ref":"#/components/schemas/PaginationBase"},{"type":"null"}],"default":{"page_number":0,"page_size":100}},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"sort_model":{"anyOf":[{"$ref":"#/components/schemas/SortModel"},{"items":{"$ref":"#/components/schemas/SortModel"},"type":"array"}],"title":"Sort Model"},"search_terms":{"items":{"type":"string"},"type":"array","title":"Search Terms","default":[]},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["start_date","end_date"],"title":"ProductExplorerResearchPayload"},"ProductGroupingEventResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"event_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Ids"}},"type":"object","title":"ProductGroupingEventResearchBody"},"ProductGroupingResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","title":"ProductGroupingResearchBody"},"ProductProductTypeOverride":{"properties":{"products":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Products"},"product_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type Id"}},"type":"object","required":["products"],"title":"ProductProductTypeOverride"},"ProductResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/StrictPaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"customer_product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Product Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"event_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Date"},"include_product_images":{"type":"boolean","title":"Include Product Images","default":false}},"type":"object","title":"ProductResearchBody"},"ProductResearchCompany":{"properties":{"company_id":{"type":"string","title":"Company Id"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"avg_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Price"},"avg_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Discount"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},"type":"object","required":["company_id"],"title":"ProductResearchCompany"},"ProductResearchCompanyResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/ProductResearchCompany"},"type":"array","title":"Results"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["results","total_count"],"title":"ProductResearchCompanyResponse"},"ProductResearchPivotBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"row_field":{"anyOf":[{"type":"string","enum":["company_id","color","raw_color","size","raw_size","product_type","material","gender","keyword","price_bucket","brand"]},{"type":"null"}],"title":"Row Field"},"column_field":{"anyOf":[{"type":"string","enum":["company_id","color","raw_color","size","raw_size","product_type","material","gender","keyword","price_bucket","brand"]},{"type":"null"}],"title":"Column Field"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},"type":"object","title":"ProductResearchPivotBody"},"ProductResearchPivotResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/PivotProduct"},"type":"array","title":"Results"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["results","total_count"],"title":"ProductResearchPivotResponse"},"ProductResearchPricesBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"bucket_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bucket Count","default":12},"percentile_cutoff":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentile Cutoff","default":0.05}},"type":"object","title":"ProductResearchPricesBody"},"ProductResearchProduct":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"product_title":{"type":"string","title":"Product Title"},"product_url":{"type":"string","title":"Product Url"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"avg_full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Full Price"},"avg_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Discount"},"min_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Current Price"},"max_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Current Price"},"current_total_inventory":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Total Inventory"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_revenue_upper_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue Upper Bound"},"sales_revenue_lower_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue Lower Bound"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"sales_volume_upper_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume Upper Bound"},"sales_volume_lower_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume Lower Bound"},"product_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Product Score"},"product_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Image"},"product_images":{"items":{"type":"string"},"type":"array","title":"Product Images"},"launch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Date"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"},"review_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Review Count"},"avg_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Rating"},"nps_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Nps Score"},"key_phrases":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Key Phrases"},"sizes":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Sizes"},"colors":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Colors"},"brands":{"anyOf":[{"items":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Brands"},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"product_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type Id"},"selected_variant_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Selected Variant Count"},"total_variant_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Variant Count"},"bayesian_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bayesian Avg"}},"type":"object","required":["company_id","product_id","product_title","product_url"],"title":"ProductResearchProduct"},"ProductResearchProductTypeGrouping":{"properties":{"product_type":{"type":"string","title":"Product Type"},"product_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type Id"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"discounted_product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Discounted Product Count"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"avg_full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Full Price"},"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"avg_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Rating"},"avg_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Discount"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"review_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Review Count"},"fully_qualified_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fully Qualified Path"},"company_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Ids"}},"type":"object","required":["product_type"],"title":"ProductResearchProductTypeGrouping"},"ProductResearchProductTypesGroupingResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"results":{"items":{"$ref":"#/components/schemas/ProductResearchProductTypeGrouping"},"type":"array","title":"Results"}},"type":"object","required":["total_count","results"],"title":"ProductResearchProductTypesGroupingResponse"},"ProductResearchResponse":{"properties":{"total_variant_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Variant Count"},"products":{"items":{"$ref":"#/components/schemas/ProductResearchProduct"},"type":"array","title":"Products"},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"type":"object","required":["products","meta"],"title":"ProductResearchResponse"},"ProductResearchTagGrouping":{"properties":{"tag":{"type":"string","title":"Tag"},"count":{"type":"integer","title":"Count"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"min_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Price"},"max_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Price"},"avg_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Discount"}},"type":"object","required":["tag","count"],"title":"ProductResearchTagGrouping"},"ProductResearchTagGroupingResponse":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"results":{"items":{"$ref":"#/components/schemas/ProductResearchTagGrouping"},"type":"array","title":"Results"}},"type":"object","required":["total_count","results"],"title":"ProductResearchTagGroupingResponse"},"ProductResearchTimeseries":{"properties":{"date":{"type":"string","title":"Date"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_revenue_upper_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue Upper Bound"},"sales_revenue_lower_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue Lower Bound"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"sales_volume_upper_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume Upper Bound"},"sales_volume_lower_bound":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume Lower Bound"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"total_inventory":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Inventory"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"avg_full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Full Price"},"restock_quantity":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Restock Quantity"}},"type":"object","required":["date"],"title":"ProductResearchTimeseries"},"ProductResearchTimeseriesResponse":{"properties":{"timeseries":{"items":{"$ref":"#/components/schemas/ProductResearchTimeseries"},"type":"array","title":"Timeseries"},"total_sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Revenue"},"total_sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Sales Volume"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"aggregation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aggregation Type"}},"type":"object","required":["timeseries"],"title":"ProductResearchTimeseriesResponse"},"ProductResearchVariant":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"variant_id":{"type":"string","title":"Variant Id"},"variant_title":{"type":"string","title":"Variant Title"},"avg_current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Current Price"},"avg_full_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Full Price"},"avg_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Discount"},"sales_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Revenue"},"sales_volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sales Volume"},"rate_sold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rate Sold"},"sell_through_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Through Rate"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"raw_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Color"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size"},"raw_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Size"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"}},"type":"object","required":["company_id","product_id","variant_id","variant_title"],"title":"ProductResearchVariant"},"ProductResponse":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"type":"string","title":"Url"},"velocity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Velocity"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"launch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Date"},"images":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Images"},"status":{"anyOf":[{"type":"string","const":"hidden"},{"type":"null"}],"title":"Status"},"sizes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sizes"},"colors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colors"},"product_types":{"anyOf":[{"items":{"items":{"type":"string"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Product Types"},"materials":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Materials"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"avg_rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Rating"},"review_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Review Count"},"key_phrases":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Key Phrases"},"nps_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Nps Score"},"product_notes":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Product Notes"},"variant_notes":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Variant Notes"},"is_particl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Particl"},"actively_tracking":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Actively Tracking"},"actively_tracking_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actively Tracking Updated At"}},"type":"object","required":["company_id","product_id","url"],"title":"ProductResponse"},"ProductSearch":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"relevance":{"type":"number","title":"Relevance"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"}},"type":"object","required":["company_id","product_id","relevance"],"title":"ProductSearch"},"ProductSearchMeta":{"properties":{"pageCount":{"type":"integer","title":"Pagecount"},"recordCount":{"type":"integer","title":"Recordcount"}},"type":"object","required":["pageCount","recordCount"],"title":"ProductSearchMeta"},"ProductSearchResponse":{"properties":{"meta":{"$ref":"#/components/schemas/ProductSearchMeta"},"products":{"items":{"$ref":"#/components/schemas/ProductSearch"},"type":"array","title":"Products"}},"type":"object","required":["meta","products"],"title":"ProductSearchResponse"},"ProductTableResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/StrictPaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"customer_product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Product Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"event_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Date"},"include_product_images":{"type":"boolean","title":"Include Product Images","default":false},"event_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Ids"},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true}},"type":"object","title":"ProductTableResearchBody"},"ProductTagGroupingResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","title":"ProductTagGroupingResearchBody"},"ProductTimeseriesBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"type":"string","enum":["flat","weekly","monthly"],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"columns":{"items":{"type":"string"},"type":"array","title":"Columns"},"report_type":{"type":"string","enum":["company","product","variant"],"title":"Report Type","default":"product"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"retrieve_row_count":{"type":"boolean","title":"Retrieve Row Count","default":false}},"type":"object","required":["aggregation_type_override","columns"],"title":"ProductTimeseriesBody"},"ProductTypeGroupingResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"event_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Ids"},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true}},"type":"object","title":"ProductTypeGroupingResearchBody"},"ProductTypeName":{"properties":{"name":{"type":"string","title":"Name"},"product_type_id":{"type":"string","title":"Product Type Id"},"fully_qualified_path":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fully Qualified Path"}},"type":"object","required":["name","product_type_id"],"title":"ProductTypeName"},"ProductTypeNameResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ProductTypeName"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"ProductTypeNameResponse"},"ProductVariantsResearchResponse":{"properties":{"variants":{"items":{"$ref":"#/components/schemas/ProductResearchVariant"},"type":"array","title":"Variants"},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"type":"object","required":["variants","meta"],"title":"ProductVariantsResearchResponse"},"ProductsStatsBody":{"properties":{"competitor_product_ids":{"items":{"$ref":"#/components/schemas/CompanyIdProductId"},"type":"array","title":"Competitor Product Ids","default":[]},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","title":"ProductsStatsBody"},"ProductsStatsResponse":{"properties":{"company_id":{"type":"string","title":"Company Id"},"product_id":{"type":"string","title":"Product Id"},"elasticity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Elasticity"},"likelihood_to_promote":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Likelihood To Promote"}},"type":"object","required":["company_id","product_id"],"title":"ProductsStatsResponse"},"PutProductCollectionBody":{"properties":{"products":{"items":{},"type":"array","title":"Products"}},"type":"object","required":["products"],"title":"PutProductCollectionBody"},"RefineAllRequest":{"properties":{"folds":{"items":{"$ref":"#/components/schemas/FoldBodyForRefine"},"type":"array","title":"Folds"}},"type":"object","required":["folds"],"title":"RefineAllRequest","description":"Request to refine all newsletter folds together via GPT."},"RefineAllResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"folds":{"items":{"$ref":"#/components/schemas/FoldBodyForRefine"},"type":"array","title":"Folds"},"issues":{"items":{"type":"string"},"type":"array","title":"Issues","default":[]}},"type":"object","required":["success","folds"],"title":"RefineAllResponse","description":"Response from refine-all."},"RefineTextRequest":{"properties":{"bodyParagraph1":{"type":"string","title":"Bodyparagraph1"},"bodyParagraph2":{"type":"string","title":"Bodyparagraph2"},"bodyParagraph3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bodyparagraph3"}},"type":"object","required":["bodyParagraph1","bodyParagraph2"],"title":"RefineTextRequest","description":"Request to refine newsletter body text via GPT."},"RemoveProductsProductCollectionBody":{"properties":{"products":{"items":{},"type":"array","title":"Products"}},"type":"object","required":["products"],"title":"RemoveProductsProductCollectionBody"},"Report":{"properties":{"created_on":{"type":"string","title":"Created On"},"report_id":{"type":"string","title":"Report Id"},"report_meta":{"additionalProperties":true,"type":"object","title":"Report Meta"},"report_credit_cost":{"type":"integer","title":"Report Credit Cost"},"report_type":{"type":"string","enum":["pricing_report","new_product_report","custom"],"title":"Report Type"},"status":{"type":"string","enum":["in_progress","failed","success","queued"],"title":"Status"},"user_email":{"type":"string","title":"User Email"}},"type":"object","required":["created_on","report_id","report_meta","report_credit_cost","report_type","status","user_email"],"title":"Report"},"ReportSubscriptionPayload":{"properties":{"report_name":{"type":"string","title":"Report Name"},"cadence_type":{"type":"string","title":"Cadence Type"},"day_of_week":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Day Of Week"},"day_of_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Day Of Month"},"hour_of_day":{"type":"integer","title":"Hour Of Day"},"time_zone_offset":{"type":"string","title":"Time Zone Offset"},"report_params":{"additionalProperties":true,"type":"object","title":"Report Params"},"num_look_back_days":{"type":"integer","title":"Num Look Back Days","default":14}},"type":"object","required":["report_name","cadence_type","hour_of_day","time_zone_offset","report_params"],"title":"ReportSubscriptionPayload"},"RequestAssetTrackingResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/CompanyAssetTrackingResult"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"RequestAssetTrackingResponse"},"SaveNewsletterRequest":{"properties":{"newsletter_data":{"$ref":"#/components/schemas/NewsletterBuilderData"},"newsletter_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Newsletter Id"}},"type":"object","required":["newsletter_data"],"title":"SaveNewsletterRequest","description":"Request to save newsletter draft."},"SearchProductTypes":{"properties":{"search_term":{"type":"string","title":"Search Term"}},"type":"object","required":["search_term"],"title":"SearchProductTypes"},"SendGatedReportEmailPayload":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"canonical_report_slug":{"type":"string","title":"Canonical Report Slug"},"landing_page_url":{"type":"string","title":"Landing Page Url"}},"type":"object","required":["email","canonical_report_slug","landing_page_url"],"title":"SendGatedReportEmailPayload"},"SendNewsletterRequest":{"properties":{"newsletter_type":{"type":"string","enum":["dtc","exploding-retail","marketing","product-updates","one-off-email"],"title":"Newsletter Type"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date"},"timestamp":{"type":"string","title":"Timestamp"},"mode":{"type":"string","enum":["test","production"],"title":"Mode"},"test_email":{"anyOf":[{"type":"string","enum":["ben","kenney","smiley"]},{"type":"null"}],"title":"Test Email"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"custom_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Query"},"log_to_database":{"type":"boolean","title":"Log To Database","default":true},"has_header":{"type":"boolean","title":"Has Header","default":true},"trends":{"anyOf":[{"items":{"$ref":"#/components/schemas/SendTrendForUsed"},"type":"array"},{"type":"null"}],"title":"Trends"}},"type":"object","required":["newsletter_type","date","timestamp","mode"],"title":"SendNewsletterRequest","description":"Request to send newsletter."},"SendNewsletterResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"recipients_count":{"type":"integer","title":"Recipients Count"},"message":{"type":"string","title":"Message","default":"Newsletter sent successfully"}},"type":"object","required":["success","recipients_count"],"title":"SendNewsletterResponse","description":"Response from sending newsletter."},"SendPreviewRequest":{"properties":{"to":{"type":"string","format":"email","title":"To"},"subject":{"type":"string","title":"Subject"},"html":{"type":"string","title":"Html"}},"type":"object","required":["to","subject","html"],"title":"SendPreviewRequest"},"SendPreviewResponse":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"SendPreviewResponse"},"SendSlackMessagePayload":{"properties":{"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"},"key_value_list":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Key Value List"},"channel":{"type":"string","title":"Channel"}},"type":"object","required":["title","message","channel"],"title":"SendSlackMessagePayload"},"SendTrendForUsed":{"properties":{"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"name":{"type":"string","title":"Name"}},"type":"object","required":["trendType","name"],"title":"SendTrendForUsed","description":"A trend to record as used when newsletter is sent."},"SentimentResearchBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/PaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"remove_zeros":{"type":"boolean","title":"Remove Zeros","default":true},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","title":"SentimentResearchBody"},"ShareUrlBody":{"properties":{"to_email":{"type":"string","title":"To Email"},"is_new_user":{"type":"boolean","title":"Is New User"},"url":{"type":"string","title":"Url"},"custom_contents":{"type":"string","title":"Custom Contents"}},"type":"object","required":["to_email","is_new_user","url","custom_contents"],"title":"ShareUrlBody"},"SimilarProductsBody":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]},"filter_operator":{"type":"string","enum":["AND","OR"],"title":"Filter Operator","default":"AND"},"numeric_filter_operator":{"type":"string","enum":["AND","OR"],"title":"Numeric Filter Operator","default":"AND"},"confidence_threshold":{"type":"number","maximum":10.0,"minimum":0.0,"title":"Confidence Threshold","default":6.0},"order_by":{"$ref":"#/components/schemas/OrderBy","default":{"field":"sales_revenue","direction":"desc"}},"pagination":{"$ref":"#/components/schemas/StrictPaginationBase","default":{"page_number":0,"page_size":25}},"data_statuses":{"items":{"$ref":"#/components/schemas/DataStatus"},"type":"array","title":"Data Statuses","default":[2,1]},"aggregation_type_override":{"anyOf":[{"type":"string","enum":["daily","weekly","monthly"]},{"type":"null"}],"title":"Aggregation Type Override"},"exclude_pricing_only_sales":{"type":"boolean","title":"Exclude Pricing Only Sales","default":false},"customer_product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Product Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"event_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Date"},"include_product_images":{"type":"boolean","title":"Include Product Images","default":false},"hide_single_color_products":{"type":"boolean","title":"Hide Single Color Products","default":false}},"type":"object","title":"SimilarProductsBody"},"SimpleCompanyDetail":{"properties":{"company_id":{"type":"string","title":"Company Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"}},"type":"object","required":["company_id","name","domain"],"title":"SimpleCompanyDetail"},"SortModel":{"properties":{"field":{"type":"string","title":"Field"},"sort":{"type":"string","enum":["asc","desc"],"title":"Sort"}},"type":"object","required":["field","sort"],"title":"SortModel"},"StrictPaginationBase":{"properties":{"page_number":{"type":"integer","minimum":0.0,"title":"Page Number","default":0},"page_size":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Page Size","default":100}},"type":"object","title":"StrictPaginationBase"},"SuggestTrendsRequest":{"properties":{"timeline":{"type":"string","title":"Timeline","default":"one_year"},"app_base_url":{"type":"string","title":"App Base Url","default":"https://app.particl.com"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}},"type":"object","title":"SuggestTrendsRequest","description":"Request for suggest-trends endpoint."},"SuggestTrendsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"trends":{"items":{"$ref":"#/components/schemas/SuggestedTrend"},"type":"array","title":"Trends"}},"type":"object","required":["success","trends"],"title":"SuggestTrendsResponse","description":"Response from suggest-trends endpoint."},"SuggestedTrend":{"properties":{"trendType":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Trendtype"},"name":{"type":"string","title":"Name"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"trendSearchUrl":{"type":"string","title":"Trendsearchurl"},"percentGrowth":{"type":"string","title":"Percentgrowth"},"timeFrame":{"type":"string","title":"Timeframe"},"whyItMatters":{"type":"string","title":"Whyitmatters"},"wordCount":{"type":"integer","title":"Wordcount","default":120},"aboutPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aboutpageurl"},"productPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productpageurl"},"chartImageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chartimageurl"}},"type":"object","required":["trendType","name","trendPageUrl","trendSearchUrl","percentGrowth","timeFrame","whyItMatters"],"title":"SuggestedTrend","description":"A single suggested trend for newsletter fold."},"TaskPayload":{"properties":{"pagination":{"anyOf":[{"$ref":"#/components/schemas/PaginationBase"},{"type":"null"}],"default":{"page_number":0,"page_size":100}},"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters","default":[]}},"type":"object","title":"TaskPayload"},"TaskTypeDailyCompletionPayload":{"properties":{"task_type":{"type":"string","title":"Task Type"},"completion_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Date"}},"type":"object","required":["task_type"],"title":"TaskTypeDailyCompletionPayload"},"TimelineEventPayload":{"properties":{"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","default":["all"]},"pagination_meta":{"anyOf":[{"$ref":"#/components/schemas/PaginationMeta"},{"type":"null"}]}},"type":"object","title":"TimelineEventPayload"},"TopBrand":{"properties":{"company_id":{"type":"string","title":"Company Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"avg_price":{"type":"number","title":"Avg Price"},"product_count":{"type":"integer","title":"Product Count"},"monthly_trend":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Monthly Trend"},"previous_monthly_trend":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Monthly Trend"},"revenue_bucket":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":"object","title":"Revenue Bucket"},"current_rank":{"type":"integer","title":"Current Rank"},"previous_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Rank"}},"type":"object","required":["company_id","name","domain","avg_price","product_count","revenue_bucket","current_rank"],"title":"TopBrand"},"TopBrandResponse":{"properties":{"meta":{"$ref":"#/components/schemas/PaginationMeta"},"companies":{"items":{"$ref":"#/components/schemas/TopBrand"},"type":"array","title":"Companies"}},"type":"object","required":["meta","companies"],"title":"TopBrandResponse"},"TrendData":{"properties":{"category":{"type":"string","enum":["COMPANY","KEYWORD","PRODUCT_TYPE","INGREDIENT"],"title":"Category"},"trendNumber":{"type":"integer","maximum":6.0,"minimum":1.0,"title":"Trendnumber"},"name":{"type":"string","title":"Name"},"trendPageUrl":{"type":"string","title":"Trendpageurl"},"homepageSearchUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homepagesearchurl"},"percentGrowth":{"type":"string","title":"Percentgrowth"},"timeFrame":{"type":"string","title":"Timeframe"},"aboutPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aboutpageurl"},"productPageUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productpageurl"},"largeImage":{"type":"string","title":"Largeimage"},"smallImage":{"type":"string","title":"Smallimage"},"bodyParagraph1":{"type":"string","title":"Bodyparagraph1"},"bodyParagraph2":{"type":"string","title":"Bodyparagraph2"},"bodyParagraph3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bodyparagraph3"},"ctaUrl":{"type":"string","title":"Ctaurl"},"wordCount":{"type":"integer","title":"Wordcount"},"whyItMatters":{"type":"string","title":"Whyitmatters"}},"type":"object","required":["category","trendNumber","name","trendPageUrl","percentGrowth","timeFrame","largeImage","smallImage","bodyParagraph1","bodyParagraph2","ctaUrl","wordCount","whyItMatters"],"title":"TrendData","description":"Data for a single trend/fold in the newsletter."},"TrendDetailsBody":{"properties":{"dynamic_filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Dynamic Filters"},"timeline":{"type":"string","title":"Timeline","default":"one_year"}},"type":"object","required":["dynamic_filters"],"title":"TrendDetailsBody"},"TrendDynamicFilters":{"properties":{"filters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filters"},"pageNumber":{"type":"integer","title":"Pagenumber","default":1},"sortModel":{"anyOf":[{"items":{"$ref":"#/components/schemas/TrendSortItem"},"type":"array"},{"type":"null"}],"title":"Sortmodel"}},"type":"object","required":["filters"],"title":"TrendDynamicFilters"},"TrendParams":{"properties":{"dynamic_filters":{"$ref":"#/components/schemas/TrendDynamicFilters"},"timeline":{"type":"string","title":"Timeline","default":"one_year"}},"type":"object","required":["dynamic_filters"],"title":"TrendParams"},"TrendSortItem":{"properties":{"field":{"type":"string","title":"Field"},"sort":{"type":"string","enum":["asc","desc"],"title":"Sort"}},"type":"object","required":["field","sort"],"title":"TrendSortItem"},"UpdateCommunicationSettingPayload":{"properties":{"user_id":{"type":"string","title":"User Id"},"subscribed":{"type":"boolean","title":"Subscribed"}},"type":"object","required":["user_id","subscribed"],"title":"UpdateCommunicationSettingPayload"},"UpdateCompanyCollectionPayload":{"properties":{"collection_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Name"},"company_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Ids"},"action_type":{"type":"string","enum":["ADD","REMOVE","RENAME"],"title":"Action Type"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","required":["action_type"],"title":"UpdateCompanyCollectionPayload"},"UpdateCompanyPayload":{"properties":{"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"bad_collection_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bad Collection Key"},"bad_collection_flags":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Bad Collection Flags"},"inventory_script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Script"},"requests_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requests Method"},"inventory_start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Start Date"}},"type":"object","title":"UpdateCompanyPayload"},"UpdateOtherUserPayload":{"properties":{"type":{"anyOf":[{"type":"string","enum":["admin","owner","member","basic"]},{"type":"null"}],"title":"Type"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["user_id"],"title":"UpdateOtherUserPayload"},"UpdateProductType":{"properties":{"name":{"type":"string","title":"Name"},"product_type_id":{"type":"string","title":"Product Type Id"}},"type":"object","required":["name","product_type_id"],"title":"UpdateProductType"},"UpdateSubscription":{"properties":{"plan_id":{"$ref":"#/components/schemas/PlanType"},"promo_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code"}},"type":"object","required":["plan_id"],"title":"UpdateSubscription","description":"Schema for updating an existing subscription to a new plan."},"UpdateUserPayload":{"properties":{"confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Confirmed"},"type":{"anyOf":[{"type":"string","enum":["admin","owner","member","basic"]},{"type":"null"}],"title":"Type"}},"type":"object","title":"UpdateUserPayload"},"UploadAssetRequest":{"properties":{"data_url":{"type":"string","title":"Data Url","description":"data:image/<type>;base64,<payload>"}},"type":"object","required":["data_url"],"title":"UploadAssetRequest"},"UploadAssetResponse":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"UploadAssetResponse"},"UploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"content":{"type":"string","title":"Content"},"message":{"type":"string","title":"Message","default":"File uploaded successfully"}},"type":"object","required":["success","content"],"title":"UploadResponse","description":"Response from file upload."},"UpvoteCompanyBody":{"properties":{"domain":{"type":"string","title":"Domain"}},"type":"object","required":["domain"],"title":"UpvoteCompanyBody"},"UserResponse":{"properties":{"api_keys":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Api Keys"},"confirmed":{"type":"boolean","title":"Confirmed","default":false},"sessions":{"additionalProperties":true,"type":"object","title":"Sessions","default":{}},"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"group_id":{"type":"string","title":"Group Id"},"customer_id":{"type":"string","title":"Customer Id","default":""},"group":{"anyOf":[{"$ref":"#/components/schemas/BaseGroup"},{"type":"null"}]},"type":{"type":"string","enum":["admin","owner","member","basic"],"title":"Type"}},"type":"object","required":["id","user_id","email","group_id","type"],"title":"UserResponse"},"UserSubcribedReportResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/UserSubscribedReport"},"type":"array","title":"Results"}},"type":"object","required":["results"],"title":"UserSubcribedReportResponse"},"UserSubscribedReport":{"properties":{"customer_id":{"type":"string","title":"Customer Id"},"collection_id":{"type":"string","title":"Collection Id"},"name":{"type":"string","title":"Name"},"is_subscribed":{"type":"integer","title":"Is Subscribed"}},"type":"object","required":["customer_id","collection_id","name","is_subscribed"],"title":"UserSubscribedReport"},"UserSubscribedReportPayload":{"properties":{"report_type":{"type":"string","title":"Report Type"},"is_subscribed":{"type":"boolean","title":"Is Subscribed"}},"type":"object","required":["report_type","is_subscribed"],"title":"UserSubscribedReportPayload"},"ValidatePromoCodeRequest":{"properties":{"code":{"type":"string","title":"Code","description":"Promo code to validate"},"plan_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Type","description":"Plan type to check applicability against"}},"type":"object","required":["code"],"title":"ValidatePromoCodeRequest"},"ValidatePromoCodeResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"message":{"type":"string","title":"Message"},"promo_code_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code Id"},"discount_type":{"anyOf":[{"$ref":"#/components/schemas/DiscountType"},{"type":"null"}]},"discount_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discount Value"}},"type":"object","required":["valid","message"],"title":"ValidatePromoCodeResponse"},"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"},"WhyItMattersRequest":{"properties":{"name":{"type":"string","title":"Name"},"companyDomain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companydomain"},"trendType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trendtype"},"productName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Productname"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Producturl"},"percentGrowth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Percentgrowth"},"timeFrame":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"}},"type":"object","required":["name"],"title":"WhyItMattersRequest"},"WhyItMattersResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["success"],"title":"WhyItMattersResponse"},"ZeroSalesActionPayload":{"properties":{"company_id":{"type":"string","title":"Company Id"},"task_id":{"type":"string","title":"Task Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["company_id","task_id"],"title":"ZeroSalesActionPayload"},"ZeroSalesTurnOffPayload":{"properties":{"company_id":{"type":"string","title":"Company Id"},"task_id":{"type":"string","title":"Task Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"hide":{"type":"boolean","title":"Hide","default":false}},"type":"object","required":["company_id","task_id"],"title":"ZeroSalesTurnOffPayload"}}}}