# Constructor Documentation Documentation > Documentation for Constructor Documentation ## Guides - [What's new in our docs](https://docs.constructor.com/docs/home-whats-new-in-our-docs.md): Your go-to destination for new articles and updates in Constructor's documentation. - [The Proof Scheduleยฎ](https://docs.constructor.com/docs/make-us-prove-it-the-proof-schedule.md) - [Beacon](https://docs.constructor.com/docs/make-us-prove-it-beacon.md) - [Load our beacon](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon.md) - [Direct site placement](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon-direct-site-placement.md) - [Google Tag Manager](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon-google-tag-manager.md) - [Tealium iQ](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon-tealium-iq.md) - [Adobe Launch](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon-adobe-launch.md) - [SFRA Salesforce cartridge](https://docs.constructor.com/docs/make-us-prove-it-beacon-load-our-beacon-sfra-salesforce-cartridge.md) - [Beacon FAQ](https://docs.constructor.com/docs/make-us-prove-it-beacon-beacon-faq.md): Frequently asked questions about beacons in the context of a proof schedule. - [Product catalog](https://docs.constructor.com/docs/make-us-prove-it-product-catalog.md): This section explains the items, variations, and groups data that can be sent to Constructor to help our team build out a Proof Schedule. - [Catalog data concepts](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-catalog-data-concepts.md) - [Using the preferred format](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-using-the-preferred-format.md) - [Using alternative formats](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-using-alternative-formats.md) - [File transfer options](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-file-transfer-options.md) - [Defining group hierarchy](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-defining-group-hierarchy.md) - [Catalog FAQ](https://docs.constructor.com/docs/make-us-prove-it-product-catalog-catalog-faq.md): Frequently asked questions about product catalogs in the context of a Proof Scheduleยฎ. - [AI-powered product discovery](https://docs.constructor.com/docs/products-ai-powered-product-discovery.md) - [KPI optimization](https://docs.constructor.com/docs/products-ai-powered-product-discovery-kpi-optimization.md) - [Results ranking at Constructor](https://docs.constructor.com/docs/products-ai-powered-product-discovery-results-ranking-at-constructor.md) - [Learn about Search](https://docs.constructor.com/docs/products-search-learn-about-search.md) - [Learn about Image Search](https://docs.constructor.com/docs/products-search-learn-about-image-search.md) - [Learn about Related Search](https://docs.constructor.com/docs/products-search-learn-about-related-search.md) - [Implement Related Search](https://docs.constructor.com/docs/products-search-learn-about-related-search-implement-related-search.md) - [Learn about Related Categories](https://docs.constructor.com/docs/products-search-learn-about-related-categories.md) - [Implement Related Categories](https://docs.constructor.com/docs/products-search-learn-about-related-categories-implement-related-categories.md) - [Learn about Browse](https://docs.constructor.com/docs/products-browse-learn-about-browse.md) - [Get the most out of Browse](https://docs.constructor.com/docs/products-browse-get-the-most-out-of-browse.md) - [Learn about Autocomplete](https://docs.constructor.com/docs/products-autocomplete-learn-about-autocomplete.md) - [Recommendations](https://docs.constructor.com/docs/products-recommendations.md): Welcome to the Recommendations Product Guide - [Learn about Recommendations](https://docs.constructor.com/docs/products-recommendations-learn-about-recommendations.md) - [Get the most out of Recommendations](https://docs.constructor.com/docs/products-recommendations-get-the-most-out-of-recommendations.md) - [Recommendations examples](https://docs.constructor.com/docs/products-recommendations-recommendations-examples.md): Best examples of Constructor Recommendations - [Recommendations Searchandising](https://docs.constructor.com/docs/products-recommendations-recommendations-searchandising.md) - [Offsite Discovery Recommendations](https://docs.constructor.com/docs/products-recommendations-offsite-discovery-recommendations.md): Delight shoppers with personalized product recommendations on any digital, off-site media property including email, SMS, push, social, paid advertising and more. - [Learn about Sponsored Listings](https://docs.constructor.com/docs/products-retail-media-learn-about-sponsored-listings.md) - [Implement Sponsored Listings](https://docs.constructor.com/docs/products-retail-media-learn-about-sponsored-listings-implement-sponsored-listings.md) - [Invoicing for Sponsored Listings](https://docs.constructor.com/docs/products-retail-media-learn-about-sponsored-listings-invoicing-for-sponsored-listings.md) - [Learn about the Mediation Layer](https://docs.constructor.com/docs/products-retail-media-learn-about-the-mediation-layer.md): Learn how Constructor's Sponsored Listings works alongside your existing retail media - [Implement the Mediation Layer](https://docs.constructor.com/docs/products-retail-media-learn-about-the-mediation-layer-implement-the-mediation-layer.md) - [Learn about Display Ads](https://docs.constructor.com/docs/products-retail-media-learn-about-display-ads.md) - [Implement Display Ads](https://docs.constructor.com/docs/products-retail-media-learn-about-display-ads-implement-display-ads.md) - [Learn about AI Shopping Agent](https://docs.constructor.com/docs/products-ai-shopping-agents-learn-about-ai-shopping-agent.md) - [Implement AI Shopping Agent](https://docs.constructor.com/docs/products-ai-shopping-agents-learn-about-ai-shopping-agent-implement-ai-shopping-agent.md) - [Learn about Product Insights Agent](https://docs.constructor.com/docs/products-ai-shopping-agents-learn-about-product-insights-agent.md) - [Implement Product Insights Agent](https://docs.constructor.com/docs/products-ai-shopping-agents-learn-about-product-insights-agent-implement-product-insights-agent.md) - [Cross-Channel & Offsite Discovery](https://docs.constructor.com/docs/products-cross-channel-offsite-discovery.md) - [Learn about Email Recommendations](https://docs.constructor.com/docs/products-cross-channel-offsite-discovery-learn-about-email-recommendations.md) - [Implement Email Recommendations](https://docs.constructor.com/docs/products-cross-channel-offsite-discovery-learn-about-email-recommendations-implement-email-recommendations.md) - [Learn about Merchant Intelligence](https://docs.constructor.com/docs/products-merchant-intelligence-learn-about-merchant-intelligence.md) - [Get the most out of Merchant Intelligence](https://docs.constructor.com/docs/products-merchant-intelligence-get-the-most-out-of-merchant-intelligence.md) - [Collections](https://docs.constructor.com/docs/products-collections.md): Welcome to the Collections Product Guide - [Learn about Collections](https://docs.constructor.com/docs/products-collections-learn-about-collections.md) - [Get the most out of Collections](https://docs.constructor.com/docs/products-collections-get-the-most-out-of-collections.md) - [Managing Collections via dashboard](https://docs.constructor.com/docs/products-collections-managing-collections-via-dashboard.md) - [Implement Quizzes](https://docs.constructor.com/docs/products-quizzes-implement-quizzes.md) - [Learn about Attribute Enrichment](https://docs.constructor.com/docs/products-attribute-enrichment-learn-about-attribute-enrichment.md) - [Learn about badges](https://docs.constructor.com/docs/products-attribute-enrichment-learn-about-badges.md) - [Implement badges](https://docs.constructor.com/docs/products-attribute-enrichment-learn-about-badges-implement-badges.md) - [Get started](https://docs.constructor.com/docs/integrating-with-constructor-get-started.md) - [Single sign-on (SSO)](https://docs.constructor.com/docs/integrating-with-constructor-single-sign-on-sso.md): Review the process for enabling single sign-on (SSO) for your company - [Migrate from Bloomreach](https://docs.constructor.com/docs/integrating-with-constructor-migrate-to-constructor-migrate-from-bloomreach.md): Review the steps necessary to migrate from Bloomreach to Constructor - [Data-driven event tracking](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-data-driven-event-tracking.md) - [Installation and configuration](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-data-attributes-validator-extension-dave-installation-and-configuration.md) - [Validating tracking elements](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-data-attributes-validator-extension-dave-validating-tracking-elements.md) - [Troubleshooting tracking issues](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-data-attributes-validator-extension-dave-troubleshooting-tracking-issues.md) - [Identification parameters](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-identification-parameters.md) - [Omnichannel personalization](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-omnichannel-personalization.md) - [Success event and purchase tracking](https://docs.constructor.com/docs/integrating-with-constructor-behavioral-tracking-success-event-and-purchase-tracking.md) - [Product catalog](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog.md) - [Items & variations](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-items-variations.md) - [Metadata & facets](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-metadata-facets.md) - [Catalog upload operations](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-upload-operations.md): Learn about the different catalog uploads you can perform with Constructor - [Catalog file upload: step-by-step guide](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-catalog-file-upload-step-by-step-guide.md) - [JSON / JSONL feed format - items](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-json-jsonl-feed-format-items.md) - [JSON / JSONL feed format - variations](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-json-jsonl-feed-format-variations.md) - [JSON / JSONL feed format - item groups (categories)](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-json-jsonl-feed-format-item-groups-categories.md) - [CSV feed format - items (products)](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-csv-feed-format-items-products.md) - [CSV feed format - variations](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-csv-feed-format-variations.md) - [CSV feed format - item groups (categories)](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-csv-feed-format-item-groups-categories.md) - [CSV feed upload via HTTP](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-csv-feed-upload-via-http.md) - [CSV facet format alternative](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-csv-facet-format-alternative.md) - [FTPS connection and transfer details](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-ftps-connection-and-transfer-details.md) - [JSON data upload via REST API step-by-step guide](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-json-data-via-rest-api-json-data-upload-via-rest-api-step-by-step-guide.md) - [Getting started](https://docs.constructor.com/docs/integrating-with-constructor-retrieving-results-getting-started.md) - [Integration approaches](https://docs.constructor.com/docs/integrating-with-constructor-retrieving-results-integration-approaches.md) - [Backend integrations](https://docs.constructor.com/docs/integrating-with-constructor-backend-integrations.md) - [Required parameters](https://docs.constructor.com/docs/integrating-with-constructor-backend-integrations-required-parameters.md) - [Client libraries / SDKs](https://docs.constructor.com/docs/integrating-with-constructor-open-source-libraries-client-libraries-sdks.md) - [Client library usage justification](https://docs.constructor.com/docs/integrating-with-constructor-open-source-libraries-client-libraries-sdks-client-library-usage-justification.md) - [UI libraries](https://docs.constructor.com/docs/integrating-with-constructor-open-source-libraries-ui-libraries.md) - [Example integrations](https://docs.constructor.com/docs/integrating-with-constructor-open-source-libraries-example-integrations.md) - [Platform connectors](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors.md) - [Akeneo connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-akeneo-connector.md) - [BigCommerce connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-bigcommerce-connector.md) - [Commercetools connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-commercetools-connector.md) - [Shopify Connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-shopify-connector.md) - [Salesforce Connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-salesforce-connector.md) - [VTEX connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-vtex-connector.md) - [Omni Connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-omni-connector.md) - [Kafka Connector](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-catalog-connectors-kafka-connector.md) - [Salesforce Cartridge](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge.md) - [Installing the Constructor Connect Cartridge for B2C Commerce](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge-installing-the-constructor-connect-cartridge-for-b-2-c-commerce.md) - [Site Genesis: Catalog integration](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge-site-genesis-catalog-integration.md) - [SFRA: Catalog integration](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge-sfra-catalog-integration.md) - [SFRA: Frontend integration](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge-sfra-frontend-integration.md) - [Migrating from the Site Genesis cartridge to SFRA cartridge](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-salesforce-cartridge-migrating-from-the-site-genesis-cartridge-to-sfra-cartridge.md) - [BigCommerce Stencil](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-frontend-connectors-bigcommerce-stencil.md) - [Vue Storefront](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-frontend-connectors-vue-storefront.md) - [Shopify UI](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-frontend-connectors-shopify-ui.md) - [Elastic Path](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-partner-connectors-elastic-path.md) - [fabric](https://docs.constructor.com/docs/integrating-with-constructor-platform-connectors-partner-connectors-fabric.md) - [Connect CLI](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli.md) - [Get started with Connect CLI](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-get-started-with-connect-cli.md) - [Configuration file](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-configuration-file.md) - [Development flow](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-development-flow.md) - [Template types](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-types.md) - [Mapping template](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-types-mapping-template.md) - [Transformation templates](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-types-transformation-templates.md) - [Helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions.md) - [Global helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions-global-helper-functions.md) - [Akeneo helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions-akeneo-helper-functions.md) - [BigCommerce helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions-bigcommerce-helper-functions.md) - [Commercetools helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions-commercetools-helper-functions.md) - [Shopify helper functions](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-helper-functions-shopify-helper-functions.md) - [Template examples](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-examples.md) - [BigCommerce examples](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-examples-bigcommerce-examples.md) - [Commercetools examples](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-examples-commercetools-examples.md) - [Shopify examples](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-template-examples-shopify-examples.md) - [Triggering connectors](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-triggering-connectors.md) - [CLI release notes](https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-cli-release-notes.md) - [Amplience](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-content-integrations-amplience.md) - [Contentful](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-content-integrations-contentful.md) - [Contentstack](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-content-integrations-contentstack.md) - [Shopify Content](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-content-integrations-shopify-content.md) - [Other content integrations](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-content-integrations-other-content-integrations.md) - [Fuego.io](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-mobile-integrations-fuego-io.md) - [Reactiv](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-mobile-integrations-reactiv.md) - [Tapcart](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-mobile-integrations-tapcart.md) - [Braze](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-offsite-discovery-integrations-braze.md) - [Movable Ink](https://docs.constructor.com/docs/integrating-with-constructor-partner-integrations-offsite-discovery-integrations-movable-ink.md) - [Store / region level availability (BOPIS)](https://docs.constructor.com/docs/integrating-with-constructor-e-commerce-specific-use-cases-store-region-level-availability-bopis.md) - [Dynamic attributes by customer type (B2B)](https://docs.constructor.com/docs/integrating-with-constructor-e-commerce-specific-use-cases-dynamic-attributes-by-customer-type-b-2-b.md) - [Fitment](https://docs.constructor.com/docs/integrating-with-constructor-e-commerce-specific-use-cases-fitment.md) - [Product launch](https://docs.constructor.com/docs/integrating-with-constructor-e-commerce-specific-use-cases-product-launch.md) - [Customer support guide](https://docs.constructor.com/docs/integrating-with-constructor-customer-support-guide.md) - [Dashboard home](https://docs.constructor.com/docs/using-the-constructor-dashboard-dashboard-home.md) - [Merchant Intelligence Agent](https://docs.constructor.com/docs/using-the-constructor-dashboard-merchant-intelligence-agent.md) - [LLM filtering and burying models](https://docs.constructor.com/docs/using-the-constructor-dashboard-interact-ranking-factors-llm-filtering-and-burying-models.md) - [Badges](https://docs.constructor.com/docs/using-the-constructor-dashboard-interact-ranking-factors-badges.md) - [View item recall and ranking details in Interact](https://docs.constructor.com/docs/using-the-constructor-dashboard-interact-view-item-recall-and-ranking-details-in-interact.md) - [Create custom user profiles](https://docs.constructor.com/docs/using-the-constructor-dashboard-interact-create-custom-user-profiles.md): Create custom user profiles to help you view the impact of personalization in search queries and browse experiences. - [Manage which attributes appear on item tiles](https://docs.constructor.com/docs/using-the-constructor-dashboard-interact-manage-which-attributes-appear-on-item-tiles.md): Learn how to show and hide certain item attributes on tiles in Interact - [Searchandising](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising.md) - [Create a searchandising campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-campaigns-create-a-searchandising-campaign.md) - [Edit a searchandising campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-campaigns-edit-a-searchandising-campaign.md) - [Create boost and bury rules](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-create-boost-and-bury-rules.md): Learn how to create a boost rule that improves the ranking of specific items in results - [Create a variation slicing rule](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-create-a-variation-slicing-rule.md) - [Create a slotting rule](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-create-a-slotting-rule.md) - [Slot items by attribute in a range](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-slot-items-by-attribute-in-a-range.md) - [Slot item variations](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-slot-item-variations.md): Learn how to create a slotting rule that pins a specific item variation in a slotted position. - [Slot future items](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-slot-future-items.md): Learn how to slot items that are not yet live in the catalog - [Create a content rule](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-create-a-content-rule.md) - [Create rules for a filtered shopping experience](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-configure-rules-create-rules-for-a-filtered-shopping-experience.md) - [Manage searchandising rules](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-manage-searchandising-rules.md): Learn how to review and make changes to existing searchandising rules - [Copy individual rules across indexes](https://docs.constructor.com/docs/using-the-constructor-dashboard-searchandising-copy-individual-rules-across-indexes.md): Learn how you can quickly copy rules across multiple indexes. - [Create a collection](https://docs.constructor.com/docs/using-the-constructor-dashboard-collections-create-a-collection.md) - [Schedule a collection](https://docs.constructor.com/docs/using-the-constructor-dashboard-collections-schedule-a-collection.md) - [Schedule item sets](https://docs.constructor.com/docs/using-the-constructor-dashboard-collections-schedule-item-sets.md) - [Manage a collection](https://docs.constructor.com/docs/using-the-constructor-dashboard-collections-manage-a-collection.md) - [Add future items to a collection](https://docs.constructor.com/docs/using-the-constructor-dashboard-collections-add-future-items-to-a-collection.md) - [Indexes](https://docs.constructor.com/docs/using-the-constructor-dashboard-indexes.md) - [Manage searchability and displayability](https://docs.constructor.com/docs/using-the-constructor-dashboard-indexes-manage-searchability-and-displayability.md) - [Variation sort order](https://docs.constructor.com/docs/using-the-constructor-dashboard-indexes-variation-sort-order.md) - [Configure sort options](https://docs.constructor.com/docs/using-the-constructor-dashboard-indexes-configure-sort-options.md) - [Synonyms](https://docs.constructor.com/docs/using-the-constructor-dashboard-synonyms.md) - [Redirects](https://docs.constructor.com/docs/using-the-constructor-dashboard-redirects.md) - [Facets](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets.md) - [Configure global facets](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets-configure-global-facets.md): Learn how to configure global facets and metadata in your Constructor dashboard. - [Configure hierarchical facets](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets-configure-hierarchical-facets.md) - [Configure facet rules](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets-configure-facet-rules.md) - [Create facet rules for a specific results page](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets-configure-facet-rules-create-facet-rules-for-a-specific-results-page.md): Learn how to change or hide facet groups and options on query, category, and collection pages - [Create a facet campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-facets-configure-facet-rules-create-a-facet-campaign.md) - [Sponsored Listings](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-sponsored-listings.md) - [Create an automated campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-sponsored-listings-create-an-automated-campaign.md) - [Create a manual campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-sponsored-listings-create-a-manual-campaign.md) - [Manage campaigns](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-sponsored-listings-manage-campaigns.md) - [View sponsored campaign performance](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-sponsored-listings-view-sponsored-campaign-performance.md) - [Configure a display ad placement](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-display-ads-configure-a-display-ad-placement.md) - [Create a display ad campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-display-ads-create-a-display-ad-campaign.md) - [Invite users to the advertiser dashboard](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-advertiser-dashboard-invite-users-to-the-advertiser-dashboard.md) - [Create a campaign](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-advertiser-dashboard-create-a-campaign.md) - [Manage campaigns](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-advertiser-dashboard-manage-campaigns.md) - [View campaign analytics](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-advertiser-dashboard-view-campaign-analytics.md) - [Configure Retail Media settings](https://docs.constructor.com/docs/using-the-constructor-dashboard-retail-media-configure-retail-media-settings.md) - [Recommendations](https://docs.constructor.com/docs/using-the-constructor-dashboard-recommendations.md) - [Create a recommendations pod](https://docs.constructor.com/docs/using-the-constructor-dashboard-recommendations-create-a-recommendations-pod.md): Learn how to create a recommendation pod and define its strategy - [Review enriched attributes](https://docs.constructor.com/docs/using-the-constructor-dashboard-attribute-enrichment-review-enriched-attributes.md): Learn how to review and dismiss automatically generated attributes - [Create a facet-based quiz](https://docs.constructor.com/docs/using-the-constructor-dashboard-quizzes-create-a-facet-based-quiz.md): Learn how to create a quiz that automatically populates answer options using facets - [User permissions](https://docs.constructor.com/docs/using-the-constructor-dashboard-user-permissions.md): Learn about granting permissions and access within Constructor - [Create a new user](https://docs.constructor.com/docs/using-the-constructor-dashboard-user-permissions-create-a-new-user.md) - [Create a new role](https://docs.constructor.com/docs/using-the-constructor-dashboard-user-permissions-create-a-new-role.md): Learn how to assign users various permissions and access using a user role - [Manage users, roles, and permissions](https://docs.constructor.com/docs/using-the-constructor-dashboard-user-permissions-manage-users-roles-and-permissions.md): Learn how to manage and make changes to user roles and permissions - [Catalog uploads](https://docs.constructor.com/docs/using-the-constructor-dashboard-monitoring-integration-status-catalog-uploads.md) - [Performance](https://docs.constructor.com/docs/using-the-constructor-dashboard-monitoring-integration-status-performance.md) - [FTP credentials](https://docs.constructor.com/docs/using-the-constructor-dashboard-monitoring-integration-status-ftp-credentials.md) - [Generate and manage API tokens](https://docs.constructor.com/docs/using-the-constructor-dashboard-monitoring-integration-status-generate-and-manage-api-tokens.md) - [Metrics glossary](https://docs.constructor.com/docs/analytics-metrics-glossary.md): Learn the definition of metrics across Constructor products - [Audience Hub](https://docs.constructor.com/docs/analytics-audience-hub.md) - [Opportunities](https://docs.constructor.com/docs/analytics-opportunities.md) - [Search](https://docs.constructor.com/docs/analytics-search.md) - [Browse](https://docs.constructor.com/docs/analytics-browse.md) - [Recommendations](https://docs.constructor.com/docs/analytics-recommendations.md) - [Attribute Enrichment](https://docs.constructor.com/docs/analytics-attribute-enrichment.md) - [Rule performance](https://docs.constructor.com/docs/analytics-rule-performance.md) - [Merchandised Page Performance report](https://docs.constructor.com/docs/analytics-rule-performance-merchandised-page-performance-report.md) - [A/B testing](https://docs.constructor.com/docs/analytics-a-b-testing.md) - [Glossary](https://docs.constructor.com/docs/faq-glossary.md): Learn the definition of commonly used terms in Constructor documentation - [IDFV and IDFA](https://docs.constructor.com/docs/faq-data-collection-and-compliance-idfv-and-idfa.md) - [What steps does Constructor take to comply with the CCPA?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-what-steps-does-constructor-take-to-comply-with-the-ccpa.md) - [What steps does Constructor take to comply with the GDPR?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-what-steps-does-constructor-take-to-comply-with-the-gdpr.md) - [How do Constructor's products utilize AI in relation to the EU AI Act?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-how-do-constructors-products-utilize-ai-in-relation-to-the-eu-ai-act.md) - [Does Constructor use third-party cookies to track visitors?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-does-constructor-use-third-party-cookies-to-track-visitors.md) - [What behavioral data does Constructor collect, and how is it used?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-what-behavioral-data-does-constructor-collect-and-how-is-it-used.md) - [What data does Constructor store in the browser?](https://docs.constructor.com/docs/faq-data-collection-and-compliance-what-data-does-constructor-store-in-the-browser.md) - [Are there any password requirements for user accounts?](https://docs.constructor.com/docs/faq-general-are-there-any-password-requirements-for-user-accounts.md) - [How are Autosuggest search suggestions determined?](https://docs.constructor.com/docs/faq-general-how-are-autosuggest-search-suggestions-determined.md) - [When creating a boost or bury rule, how is this applied to each individual variation of an item?](https://docs.constructor.com/docs/faq-general-when-creating-a-boost-or-bury-rule-how-is-this-applied-to-each-individual-variation-of-an-item.md) - [Does Constructor adapt to customers in different regions?](https://docs.constructor.com/docs/faq-general-does-constructor-adapt-to-customers-in-different-regions.md) - [Is it possible to set up Autosuggest terms for non-product queries?](https://docs.constructor.com/docs/faq-general-is-it-possible-to-set-up-autosuggest-terms-for-non-product-queries.md) - [How can I quickly remove an item that should not be active in the catalog?](https://docs.constructor.com/docs/faq-general-how-can-i-quickly-remove-an-item-that-should-not-be-active-in-the-catalog.md) - [How long does it take for new items in the catalog to generate recommendations in a Recommendation Pod?](https://docs.constructor.com/docs/faq-general-how-long-does-it-take-for-new-items-in-the-catalog-to-generate-recommendations-in-a-recommendation-pod.md) - [How are user and session identities handled by Constructor?](https://docs.constructor.com/docs/faq-general-how-are-user-and-session-identities-handled-by-constructor.md) - [Does Constructor support multiple development environments?](https://docs.constructor.com/docs/faq-general-does-constructor-support-multiple-development-environments.md) - [How long does it take for searchandising, slotting, and ranking changes to take affect?](https://docs.constructor.com/docs/faq-general-how-long-does-it-take-for-searchandising-slotting-and-ranking-changes-to-take-affect.md) - [What is Constructor's policy on load testing?](https://docs.constructor.com/docs/faq-general-what-is-constructors-policy-on-load-testing.md) - [What are Constructor's throttling thresholds and usage limits?](https://docs.constructor.com/docs/faq-general-what-are-constructors-throttling-thresholds-and-usage-limits.md) - [What privileges does an "admin" user have?](https://docs.constructor.com/docs/faq-dashboard-what-privileges-does-an-admin-user-have.md) - [What privileges does a "non-admin" user have?](https://docs.constructor.com/docs/faq-dashboard-what-privileges-does-a-non-admin-user-have.md) - [Can I slot items in a Collection?](https://docs.constructor.com/docs/faq-dashboard-can-i-slot-items-in-a-collection.md) - [How are the reformulated queries ordered in the Search Insights Report?](https://docs.constructor.com/docs/faq-dashboard-how-are-the-reformulated-queries-ordered-in-the-search-insights-report.md) - [How do I configure facet names, values, position, show / hide status, etc.?](https://docs.constructor.com/docs/faq-dashboard-how-do-i-configure-facet-names-values-position-show-hide-status-etc.md) - [How do I add users to my account?](https://docs.constructor.com/docs/faq-dashboard-how-do-i-add-users-to-my-account.md) - [Why don't my images show up in the dashboard?](https://docs.constructor.com/docs/faq-dashboard-why-dont-my-images-show-up-in-the-dashboard.md) - [How are FTP feeds processed?](https://docs.constructor.com/docs/faq-product-catalog-how-are-ftp-feeds-processed.md) - [How do I create a gzipped tar archive?](https://docs.constructor.com/docs/faq-product-catalog-how-do-i-create-a-gzipped-tar-archive.md) - [How and when are results personalized?](https://docs.constructor.com/docs/faq-product-results-how-and-when-are-results-personalized.md) - [Why do result counts change when filters are applied?](https://docs.constructor.com/docs/faq-product-results-why-do-result-counts-change-when-filters-are-applied.md) - [Do autocomplete results always match search results?](https://docs.constructor.com/docs/faq-product-results-do-autocomplete-results-always-match-search-results.md) - [Is there a limit to the number of results that can be requested?](https://docs.constructor.com/docs/faq-product-results-is-there-a-limit-to-the-number-of-results-that-can-be-requested.md) - [When would an attribute need to be added as both a facet and metadata?](https://docs.constructor.com/docs/faq-facets-when-would-an-attribute-need-to-be-added-as-both-a-facet-and-metadata.md) - [We want to make an attribute searchable for shoppers but donโ€™t want it to show up on a search or browse page. Is it a facet or metadata?](https://docs.constructor.com/docs/faq-facets-we-want-to-make-an-attribute-searchable-for-shoppers-but-dont-want-it-to-show-up-on-a-search-or-browse-page-is-it-a-facet-or-metadata.md) - [Should facets & metadata be defined on both items and variations?](https://docs.constructor.com/docs/faq-facets-should-facets-metadata-be-defined-on-both-items-and-variations.md) - [Are the API key and token considered secret?](https://docs.constructor.com/docs/faq-api-are-the-api-key-and-token-considered-secret.md) - [What is a "section" as referenced in the API?](https://docs.constructor.com/docs/faq-api-what-is-a-section-as-referenced-in-the-api.md) - [MCP server](https://docs.constructor.com/docs/ai-tooling-mcp-server.md) ## API Reference - [Readme](https://docs.constructor.com/reference/main-readme.md) - [Authentication](https://docs.constructor.com/reference/main-authentication.md) - [Variations mapping](https://docs.constructor.com/reference/constructor-concepts-variations-mapping.md) - [Variations slicing](https://docs.constructor.com/reference/constructor-concepts-variations-slicing.md) - [Pre-filter expressions](https://docs.constructor.com/reference/constructor-concepts-pre-filter-expressions.md) - [Filter expressions](https://docs.constructor.com/reference/constructor-concepts-filter-expressions.md) - [Results response structure](https://docs.constructor.com/reference/constructor-concepts-results-response-structure.md) - [Filter names & values](https://docs.constructor.com/reference/constructor-concepts-filter-names-values.md) - [Autocomplete results](https://docs.constructor.com/reference/autocomplete-autocomplete-results.md) - [Retrieve by prefix](https://docs.constructor.com/reference/v1-autocomplete-get-autocomplete-results.md): Retrieve AI optimized autocomplete results for products and search suggestions (and/or optionally other sections). Prefix length is limited to 200 characters. - [Search results](https://docs.constructor.com/reference/search-search-results.md) - [Retrieve by query](https://docs.constructor.com/reference/v1-search-get-search-results.md): Retrieve AI optimized search results for products (or optionally other sections) by search query. - [Natural language search results](https://docs.constructor.com/reference/search-natural-language-search-results.md) - [Retrieve by query](https://docs.constructor.com/reference/v1-search-get-natural-language-search-results.md): Retrieve AI optimized search results for products (or optionally other sections) using a spoken search query. The spoken query should first be converted to text on the client side. The API then further "de-naturalizes" the query by filtering out excess words and identifies any specified filters. - [Image Search results](https://docs.constructor.com/reference/image-search-image-search-results.md) - [Retrieve by image](https://docs.constructor.com/reference/v2-image-search-retrieve-search-results.md): Retrieve AI optimized search results for products (or optionally other sections) by image with optional multi-item detection (segmentation) support. - [Retrieve by image (Deprecated)](https://docs.constructor.com/reference/v1-image-search-get-search-results.md): Retrieve AI optimized search results for products (or optionally other sections) by image - [Browse results](https://docs.constructor.com/reference/browse-browse-results.md) - [Retrieve by filter name/value](https://docs.constructor.com/reference/v1-browse-get-browse-results.md): Retrieve AI optimized browse results for products (or optionally other sections) by facet name and value. - [Retrieve by item ID](https://docs.constructor.com/reference/v1-browse-get-browse-items-results.md): Retrieve browse results for products (or optionally other sections) by item ID(s). - [Retrieve by collection ID](https://docs.constructor.com/reference/v1-browse-get-browse-results-by-collection-id.md): Retrieve AI optimized browse results for products (or optionally other sections) by collection ID. - [Retrieve by group ID](https://docs.constructor.com/reference/v1-browse-get-browse-results-by-group-id.md): Retrieve AI optimized browse results for products (or optionally other sections) by item group ID. - [Browse groups](https://docs.constructor.com/reference/browse-browse-groups.md) - [Retrieve groups](https://docs.constructor.com/reference/v1-browse-get-browse-groups.md): Retrieve groups for end users. - [Browse facets](https://docs.constructor.com/reference/browse-browse-facets.md) - [Retrieve countable facets](https://docs.constructor.com/reference/v1-browse-get-browse-facets.md): Retrieve countable facets for end users. - [Retrieve facet options (values) by facet name](https://docs.constructor.com/reference/v1-browse-get-browse-facet-options.md): Retrieve facet options for end users. - [Retrieve facets with their options (values)](https://docs.constructor.com/reference/v1-browse-get-browse-facets-with-options.md): Retrieve facets with options for end users. - [Retrieve collections](https://docs.constructor.com/reference/v1-browse-get-browse-collections.md): Retrieve collections for end users. To get specific collection items use the `/browse/collection_id/` endpoint. - [Recommendation results](https://docs.constructor.com/reference/recommendations-recommendation-results.md) - [Retrieve by pod](https://docs.constructor.com/reference/v1-recommendations-get-pod-results.md): Retrieve AI optimized recommendation results for products (or optionally other sections) by pod identifier. To learn more about pods, go [here](/docs/products-recommendations-learn-about-recommendations#pods). - [Offsite Discovery results](https://docs.constructor.com/reference/offsite-discovery-recommendations-offsite-discovery-results.md) - [Retrieve recommendations by pod](https://docs.constructor.com/reference/v1-offsite-discovery-recommendations-by-pod-get.md): Retrieve AI-optimized recommendation results for products by pod identifier. - [Retrieve recommendations by collection](https://docs.constructor.com/reference/v1-offsite-discovery-browse-results-by-collection-get.md): Retrieve AI-optimized products from a specified collection - [Retrieve recommendation result item image](https://docs.constructor.com/reference/v1-offsite-discovery-recommendation-item-image-url-get.md): Redirects to a recommended item image or returns JSON based on its pod ID and position in a recommendation result set (`pod_id` and `position` as path parameters). Parameter values should correspond to a previously generated set of recommendations. - [Retrieve recommendation result item URL](https://docs.constructor.com/reference/v1-offsite-discovery-recommendation-item-url-get.md): Redirects to a recommended item PDP URL or returns JSON based on its pod ID and position in a recommendation result set (`pod_id` and `position` as path parameters). Parameter values should correspond to a previously generated set of recommendations. - [Retrieve collection item image](https://docs.constructor.com/reference/v1-offsite-discovery-browse-results-by-collection-item-image-url-get.md): Redirects to a collection item image or returns JSON based on its collection ID and position in a collection result set (`collection_id` and `position` as path parameters). - [Retrieve collection item URL](https://docs.constructor.com/reference/v1-offsite-discovery-browse-results-by-collection-item-url-get.md): Redirects to a collection item PDP URL or returns JSON based on its collection ID and position in a collection result set (`collection_id` and `position` as path parameters). - [Next question](https://docs.constructor.com/reference/v1-quizzes-get-next-question.md): Retrieve the next question given a list of answers. If no answers are specified, it will return the first question. Use a `version_id` to retrieve the next question for a specific version of the quiz. - [Get results](https://docs.constructor.com/reference/v1-quizzes-get-quiz-results.md): Retrieve AI optimized quiz results for products (or optionally other sections). - [Get results page config](https://docs.constructor.com/reference/v1-quizzes-get-quiz-results-config.md): Retrieve results page configuration - [Update Engagement](https://docs.constructor.com/reference/v1-engagements-update.md): **๐Ÿ” This endpoint requires [HTTP Bearer authentication](https://docs.constructor.com/reference/main-authentication#bearer-authentication).** **Beta:** This endpoint is in beta and may change. Updates the suspension status of an advertiser engagement. When suspended, the engagement's ads will stop serving. When unsuspended, the engagement's ads will resume serving. - [Retrieve Advertiser Spend](https://docs.constructor.com/reference/v1-advertiser-spend-retrieve-advertiser-spend.md): **๐Ÿ” This endpoint requires [HTTP Bearer authentication](https://docs.constructor.com/reference/main-authentication#bearer-authentication).** **Beta:** This endpoint is in beta and may change. Returns the spend for every advertiser (engagement) that has accrued spend within the given index, broken down by day for the last 30 days. - [Retrieve Display Ads](https://docs.constructor.com/reference/v2-display-ads-retrieve-display-ads.md): Retrieves ads for each of the given placements. Each placement maps to a typed response object. Banner placements return a single flattened ad; multi-banner placements return an array of ads ordered by auction rank. If no ad is available for a placement, the placement will be missing from the response. Placements are specified as repeated `placements` query parameters. Optionally, `num_results[{id}]=N` can be used to request a specific number of ads for a placement. When omitted, the placement's configured maximum is used. - [Retrieve Display Ads (Deprecated)](https://docs.constructor.com/reference/v1-display-ads-retrieve-display-ads.md): Retrieves an ad for each of the given placement IDs. If no ad is available for a placement ID, the placement ID will be missing from the response. - [Retrieve by intent](https://docs.constructor.com/reference/v1-asa-retrieve-intent.md): Retrieves AI powered product discovery suggestions based on conversational free-form text. Returns results in small batches using a real time [Server-sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) stream for a dynamic user experience. - [Retrieve questions](https://docs.constructor.com/reference/v1-asa-retrieve-item-questions.md): Retrieves AI powered list of frequently asked questions for the given item. - [Retrieves answers](https://docs.constructor.com/reference/v1-asa-retrieve-item-questions-answer.md): Retrieves AI powered answers to questions for a given item. If the client accepts [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) (text/event-stream content) response will be streamed back, otherwise complete response JSON is returned. - [Introduction](https://docs.constructor.com/reference/catalog-management-introduction.md) - [Catalog](https://docs.constructor.com/reference/catalog-management-catalog.md) - [Create or replace catalog](https://docs.constructor.com/reference/v1-catalog-create-or-replace-catalog.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Replace the current catalog using one of two modes: **Full mode** (`mode=full`, default): Send full catalog files to replace the current catalog. You may upload up to three [files](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-catalog-file-upload-step-by-step-guide) in the form data under the following keys: `items`, `variations`, `item_groups`. If you do not wish to replace one of these types of resources then omit it from the request. Any records that already exist will be deleted and replaced with the records you provide in the files. **IDs mode** (`mode=ids`): Send files containing only the IDs of records to keep. Files should contain only an `id` column (CSV) or `id` field (JSONL). All records whose IDs are not present in the uploaded files will be deleted from the catalog. Returns an identifier for a background [task](https://docs.constructor.com/reference/v1-tasks-retrieve-task). - [Update catalog](https://docs.constructor.com/reference/v1-catalog-update-catalog.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Send delta catalog files to replace the current catalog. You may upload up to three [files](https://docs.constructor.com/docs/integrating-with-constructor-product-catalog-catalog-files-via-http-or-ftps-catalog-file-upload-step-by-step-guide) in the form data under the following keys: `items`, `variations`, `item_groups`. If you do not wish to replace one of these types of resources then omit it from the request. Any records that already exist will be deleted and replaced with the records you provide in the files. Returns an identifier for a background [task](https://docs.constructor.com/reference/v1-tasks-retrieve-task). - [Item groups](https://docs.constructor.com/reference/catalog-management-item-groups.md) - [Retrieve item group](https://docs.constructor.com/reference/v2-item-groups-retrieve-item-group.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve an item group. - [Retrieve item groups](https://docs.constructor.com/reference/v2-item-groups-retrieve-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve all items groups, optionally filtered by ids. - [Create or replace item groups](https://docs.constructor.com/reference/v2-item-groups-create-or-replace-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Create item groups or replace the data of existing item groups. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Update item groups](https://docs.constructor.com/reference/v2-item-groups-update-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Update existing item groups data. Data included in the request will be merged with data of the existing items groups. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Delete item groups](https://docs.constructor.com/reference/v2-item-groups-delete-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Delete item groups. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Retrieve item group (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-retrieve-item-group.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve an item group. - [Retrieve item groups (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-retrieve-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve all item groups. - [Create new item groups (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-create-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Create new item groups. If the item groups already exist, they will be skipped.. - [Create or replace item groups (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-create-or-replace-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Update item groups. If the item groups already exist, they will be updated. If not, they will be created. Existing item groups not sent in the request will be deleted. - [Create or update item group (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-create-or-update-item-group.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Create or update an item group. - [Create or update item groups (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-create-or-update-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Update item groups. If the item groups already exist, they will be updated. If not, they will be created. - [Delete item groups (Deprecated)](https://docs.constructor.com/reference/v1-item-groups-delete-item-groups.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Delete all item groups. - [Items](https://docs.constructor.com/reference/catalog-management-items.md) - [Retrieve items](https://docs.constructor.com/reference/v2-items-retrieve-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve all items, optionally filtered by id(s). - [Create or replace items](https://docs.constructor.com/reference/v2-items-create-or-replace-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Create items or replace the data of existing items. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Update items](https://docs.constructor.com/reference/v2-items-update-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Update existing item data. Data included in the request will be merged with data of the existing items. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Delete items](https://docs.constructor.com/reference/v2-items-delete-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Delete items. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Retrieve item](https://docs.constructor.com/reference/v2-items-retrieve-item.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve an item. - [Retrieve item field statistics](https://docs.constructor.com/reference/v1-items-fields-stats-retrieve-items-fields-stats.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve a list of statistics for all fields (such as `brand` or `size`). - [Retrieve item field statistic](https://docs.constructor.com/reference/v1-items-fields-stats-retrieve-item-field-stats.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve a list of statistics for a specific field (such as `brand` or `size`). - [Variations](https://docs.constructor.com/reference/catalog-management-variations.md) - [Retrieve variations](https://docs.constructor.com/reference/v2-variations-retrieve-variations.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve all item variations, optionally filtered by id(s). - [Create or replace variations](https://docs.constructor.com/reference/v2-variations-create-or-replace-variations.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Create item variations or replace the data of existing item variations. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Update variations](https://docs.constructor.com/reference/v2-variations-update-variations.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Update existing item variation data. Data included in the request will be merged with data of the existing item variations. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Delete variations](https://docs.constructor.com/reference/v2-variations-delete-variations.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`, `search_suggestions(w)`. Delete item variations. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task). - [Retrieve variation](https://docs.constructor.com/reference/v2-variations-retrieve-variation.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve an item variation. - [Tasks](https://docs.constructor.com/reference/catalog-management-tasks.md) - [Retrieve tasks](https://docs.constructor.com/reference/v1-tasks-retrieve-tasks.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve all tasks. - [Create task](https://docs.constructor.com/reference/v1-tasks-create-task.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Create a task. - [Update tasks](https://docs.constructor.com/reference/v1-tasks-update-tasks.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Update the status of a list of tasks to queue or cancel them. - [Retrieve task](https://docs.constructor.com/reference/v1-tasks-retrieve-task.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(r)`. Retrieve a task. - [Update task](https://docs.constructor.com/reference/v1-tasks-update-task.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `catalog(w)`. Update the status of a single task to queue or cancel it. - [Limitations](https://docs.constructor.com/reference/catalog-management-limitations.md) - [Retrieve item product details](https://docs.constructor.com/reference/v1-product-details-get-items.md): Retrieve product details for an item. - [Retrieve variation product details](https://docs.constructor.com/reference/v1-product-details-get-variations.md): Retrieve product details for variations of an item. - [Facets](https://docs.constructor.com/reference/configuration-facets.md) - [Retrieve facet configuration](https://docs.constructor.com/reference/v2-facets-retrieve-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve facet configuration with specified `facet_name`. - [Retrieve facet configurations](https://docs.constructor.com/reference/v2-facets-retrieve-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve all facet configurations. - [Create facet configuration](https://docs.constructor.com/reference/v2-facets-create-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Create facet configuration with specified `facet_name`. - [Create or replace facet configurations](https://docs.constructor.com/reference/v2-facets-create-or-replace-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Create or replace facet configurations. Replacing will overwrite all other configurations you may have defined for the facet group, resetting them to their defaults, except facet options - they will not be affected. - [Update facet configuration](https://docs.constructor.com/reference/v2-facets-update-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Partially update facet configuration with specified `facet_name`. - [Update facet configurations](https://docs.constructor.com/reference/v2-facets-update-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Update facet configurations. - [Replace facet configuration](https://docs.constructor.com/reference/v2-facets-replace-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Replace facet configuration with specified `facet_name`. This will overwrite all other configurations you may have defined for the facet group, resetting them to their defaults, except facet options - they will not be affected. - [Delete facet configuration](https://docs.constructor.com/reference/v2-facets-delete-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Delete facet configuration with specified `facet_name`. This does not delete the facet from items in your index you may have uploaded previously. Once a facet group's configuration is deleted, all configurations will return to their default values. This includes all facet option configurations (display name, position, etc) you may have defined for the facet group. - [Retrieve facet option](https://docs.constructor.com/reference/v1-facet-options-retrieve-facet-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve facet option with specified `facet_name` and `facet_option_value`. - [Retrieve facet options](https://docs.constructor.com/reference/v1-facet-options-retrieve-facet-options.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve facet options for the given `facet_name`. - [Create facet option](https://docs.constructor.com/reference/v1-facet-options-create-facet-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Create facet option for the given `facet_name`. - [Create or update facet options](https://docs.constructor.com/reference/v1-facet-options-create-or-update-facet-options.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Update a list of facet options with specified `value` for the given `facet_name`. If a facet option config with provided value already exists it is updated partially, otherwise it is created. - [Update facet option](https://docs.constructor.com/reference/v1-facet-options-update-facet-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Partially update facet option with specified `facet_name` and `facet_option_value`. - [Replace facet option](https://docs.constructor.com/reference/v1-facet-options-replace-facet-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Replace facet option with specified `facet_name` and `facet_option_value`. - [Delete facet option](https://docs.constructor.com/reference/v1-facet-options-delete-facet-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Delete facet option with specified `facet_name` and `facet_option_value`. Only do this if you want all configuration options for the facet option to go back to their default values. - [Retrieve facet configuration (Deprecated)](https://docs.constructor.com/reference/v1-facets-retrieve-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve facet configuration with specified `facet_name`. - [Retrieve facet configurations (Deprecated)](https://docs.constructor.com/reference/v1-facets-retrieve-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(r)`. Retrieve all facet configurations. - [Create facet configuration (Deprecated)](https://docs.constructor.com/reference/v1-facets-create-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Create facet configuration with specified `facet_name`. - [Create or replace facet configurations with options (Deprecated)](https://docs.constructor.com/reference/v1-facets-create-or-replace-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Create or replace facet configurations with their options. Replacing will delete the existing facet and recreate it with the provided data. - [Update facet configurations (Deprecated)](https://docs.constructor.com/reference/v1-facets-update-facets.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Update facet configurations with specified `facet_name`. - [Replace facet configuration (Deprecated)](https://docs.constructor.com/reference/v1-facets-replace-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Replace facet configuration with specified `facet_name`. This will overwrite all other configurations you may have defined for the facet group, resetting them to their defaults. This includes all facet option configurations you may have defined. - [Update facet configuration (Deprecated)](https://docs.constructor.com/reference/v1-facets-update-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Partially update facet configuration with specified `facet_name`. - [Delete facet configuration (Deprecated)](https://docs.constructor.com/reference/v1-facets-delete-facet.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets(w)`. Delete facet configuration with specified `facet_name`. This does not delete the facet from items in your index you may have uploaded previously. Once a facet group's configuration is deleted, all configurations will return to their default values. This includes all facet option configurations (display name, position, etc) you may have defined for the facet group. - [Synonyms](https://docs.constructor.com/reference/configuration-synonyms.md) - [Retrieve one-way synonym](https://docs.constructor.com/reference/v2-one-way-synonyms-retrieve-one-way-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(r)`. Retrieve one-way synonym with specified `parent_phrase`. - [Create one-way synonym](https://docs.constructor.com/reference/v2-one-way-synonyms-create-one-way-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Create one-way synonym with specified `parent_phrase`. - [Replace one-way synonym](https://docs.constructor.com/reference/v2-one-way-synonyms-replace-one-way-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Replace one-way synonym with specified `parent_phrase`. This will overwrite all child phrases with those provided in the `child_phrases` array. - [Delete one-way synonym](https://docs.constructor.com/reference/v2-one-way-synonyms-delete-one-way-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Delete one-way synonyms with specified `parent_phrase`. - [Retrieve one-way synonyms](https://docs.constructor.com/reference/v2-one-way-synonyms-retrieve-one-way-synonyms.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(r)`. Retrieve all one-way synonyms. - [Delete one-way synonyms](https://docs.constructor.com/reference/v2-one-way-synonyms-delete-one-way-synonyms.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Delete one-way synonyms. It is done asynchronously in a background task. - [Searchabilities](https://docs.constructor.com/reference/configuration-searchabilities.md) - [Retrieve searchability](https://docs.constructor.com/reference/v2-searchabilities-retrieve-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(r)`. Retrieve searchability with specified `name`. - [Retrieve searchabilities](https://docs.constructor.com/reference/v2-searchabilities-retrieve-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(r)`. Retrieve all searchabilities. - [Create or update searchability](https://docs.constructor.com/reference/v2-searchabilities-create-or-update-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Create or update searchability with specified `name`. - [Create or update searchabilities](https://docs.constructor.com/reference/v2-searchabilities-create-or-update-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Create or update searchabilities. - [Delete searchability](https://docs.constructor.com/reference/v2-searchabilities-delete-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Delete searchability with specified `name`. - [Delete searchabilities](https://docs.constructor.com/reference/v2-searchabilities-delete-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Delete searchabilities. - [Retrieve searchability (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-retrieve-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(r)`. Retrieve searchability with specified `name`. - [Retrieve searchabilities (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-retrieve-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(r)`. Retrieve all searchabilities. - [Create or update searchability (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-create-or-update-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Create or update searchability with specified `name`. - [Create or update searchabilities (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-create-or-update-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Create or update searchabilities. - [Delete searchability (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-delete-searchability.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Delete searchability with specified `name`. - [Delete searchabilities (Deprecated)](https://docs.constructor.com/reference/v1-searchabilities-delete-searchabilities.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchabilities(w)`. Delete searchabilities. - [Sort options](https://docs.constructor.com/reference/configuration-sort-options.md) - [Retrieve sort options](https://docs.constructor.com/reference/v1-sort-options-retrieve-sort-options.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(r)`. Retrieve all sort options, optionally filtered by `sort_by`. - [Create or replace sort options](https://docs.constructor.com/reference/v1-sort-options-create-or-replace-sort-options.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(w)`. Create or replace existing sort options. When providing sort options, every combination of `sort_by` and `sort_order` must be unique. For instance, there can only be one sort option that has a `sort_by` with value `price` and a `sort_order` with value `ascending`. - [Delete sort options](https://docs.constructor.com/reference/v1-sort-options-delete-sort-options.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(w)`. Delete sort option with specified `sort_by` and `sort_order`. - [Create a sort option](https://docs.constructor.com/reference/v1-sort-options-create-sort-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(w)`. Create a new sort option. Note that total number of sort options is limited, and every combination of `sort_by` and `sort_order` fields among the sort options must be unique. - [Replace a sort option](https://docs.constructor.com/reference/v1-sort-options-create-or-replace-sort-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(w)`. Replace a sort option. If the sort option already exists, it will be updated, if not it will be created. Note that total number of sort options is limited, and every combination of `sort_by` and `sort_order` fields among the sort options must be unique. - [Update a sort option](https://docs.constructor.com/reference/v1-sort-options-update-sort-option.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `sort_options(w)`. Update existing sort option. Note that total number of sort options is limited, and every combination of `sort_by` and `sort_order` fields among the sort options must be unique. - [Synonym groups](https://docs.constructor.com/reference/configuration-synonym-groups.md) - [Retrieve synonym group](https://docs.constructor.com/reference/v1-synonyms-retrieve-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(r)`. Retrieve synonym group by identifier. - [Update synonym group](https://docs.constructor.com/reference/v1-synonyms-update-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Update existing synonym group by identifier. Synonyms list inside the group will be replaced with a newly provided synonyms list. - [Delete synonym group](https://docs.constructor.com/reference/v1-synonyms-delete-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Delete synonyms group by identifier. - [Retrieve synonym groups](https://docs.constructor.com/reference/v1-synonyms-list-synonyms.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(r)`. Retrieve all synonyms, optionally filtered by phrase. - [Create synonym group](https://docs.constructor.com/reference/v1-synonyms-create-synonym.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Create synonym groups by providing list of the names for the synonyms. - [Delete synonym groups](https://docs.constructor.com/reference/v1-synonyms-delete-synonyms.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `synonyms(w)`. Delete all synonyms groups for the provided `key`. Starts a background [task](/reference/v1-tasks-retrieve-task). Returns message. - [Quizzes](https://docs.constructor.com/reference/configuration-quizzes.md) - [Retrieve quiz](https://docs.constructor.com/reference/v1-quizzes-retrieve-quiz.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `quizzes(r)`. Retrieve a quiz. - [Create or replace quiz](https://docs.constructor.com/reference/v1-quizzes-create-or-replace-quiz.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `quizzes(w)`. Create or replace an existing quiz. - [Update quiz](https://docs.constructor.com/reference/v1-quizzes-update-quiz.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `quizzes(w)`. Update a quiz. Data sent through the request body will be merged with existing quiz. Full validation (e.g. logic) will be performed over the merged quiz. - [Delete quiz](https://docs.constructor.com/reference/v1-quizzes-delete-quiz.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `quizzes(w)`. Delete a quiz. - [Collections](https://docs.constructor.com/reference/configuration-collections.md) - [Retrieve collection](https://docs.constructor.com/reference/v1-collections-retrieve-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(r)`. Retrieve a collection. - [Replace collection](https://docs.constructor.com/reference/v1-collections-replace-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Replace collection. - [Update collection](https://docs.constructor.com/reference/v1-collections-update-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Update a collection. Data sent through the request body will be merged with existing collection. Validation will be performed over the merged collection. - [Delete collection](https://docs.constructor.com/reference/v1-collections-delete-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Delete a collection. - [Retrieve collections](https://docs.constructor.com/reference/v1-collections-retrieve-collections.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(r)`. Retrieve all collections. By default, only base collections (collections with no `overridden_collection_id`) are returned. Use the `overridden_collection_id` query parameter to retrieve overriding collections for a specific base collection. - [Create collection](https://docs.constructor.com/reference/v1-collections-create-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Create a collection. - [Delete item from a collection](https://docs.constructor.com/reference/v1-collections-delete-collection-item.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Delete an item from a collection. - [Retrieve collection items](https://docs.constructor.com/reference/v1-collections-retrieve-collection-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(r)`. Retrieve all items of a collection, optionally filtered by `type`, i.e. method of addition to the collection. - [Add or update items in a collection](https://docs.constructor.com/reference/v1-collections-create-or-ignore-collection-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Add items to a collection, or update existing items. Items already in the collection are updated, others are added. Note that the total number of items per collection is limited, and the request will fail if adding items would exceed this limit. - [Delete items from a collection](https://docs.constructor.com/reference/v1-collections-delete-collection-items.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `collections(w)`. Delete items from a collection. If no items are provided, all items in the given collection will be deleted. Invalid items and items that are not part of the given collection will be ignored. - [Redirect rules](https://docs.constructor.com/reference/configuration-redirect-rules.md) - [Retrieve redirect rule](https://docs.constructor.com/reference/v1-redirects-retrieve-redirect-rule.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(r)`. Retrieve a redirect rule - [Replace redirect rule](https://docs.constructor.com/reference/v1-redirects-replace-redirect-rule.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(w)`. Replace a redirect rule - [Update redirect rule](https://docs.constructor.com/reference/v1-redirects-update-redirect-rule.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(w)`. Update a redirect rule - [Delete redirect rule](https://docs.constructor.com/reference/v1-redirects-delete-redirect-rule.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(w)`. Delete a redirect rule - [Retrieve redirect rules](https://docs.constructor.com/reference/v1-redirects-retrieve-redirect-rules.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(r)`. Retrieve all redirect rules - [Create redirect rule](https://docs.constructor.com/reference/v1-redirects-create-redirect-rule.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `redirects(w)`. Create a redirect rule - [Metadata overrides](https://docs.constructor.com/reference/configuration-metadata-overrides.md) - [Get metadata overrides for the specified autocomplete ID and](https://docs.constructor.com/reference/metadata-overrides-get-metadata-overrides.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `metadata_overrides(r)`. optionally query via field name and/or active. - [Create a new metadata override rule for the specified field name.](https://docs.constructor.com/reference/metadata-overrides-post-metadata-override.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `metadata_overrides(w)`. - [Patch an existing metadata override rule for the specified field name.](https://docs.constructor.com/reference/metadata-overrides-patch-metadata-override.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `metadata_overrides(w)`. - [Delete an existing metadata override rule for the specified field name.](https://docs.constructor.com/reference/metadata-overrides-delete-metadata-override.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `metadata_overrides(w)`. - [Limitations](https://docs.constructor.com/reference/configuration-metadata-overrides-limitations.md) - [Facets and Searchabilities v2 migration guide](https://docs.constructor.com/reference/configuration-facets-and-searchabilities-v2-migration-guide.md) - [Searchandising for Browse](https://docs.constructor.com/reference/searchandising-searchandising-for-browse.md) - [Retrieve refined filters](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-filters.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(r)`, `searchandising.refined_filters(r)`. Retrieve all refined filters. - [Retrieve refined filter](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-filter.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(r)`, `searchandising.refined_filters(r)`. Retrieve a refined filter. - [Create or replace refined filter](https://docs.constructor.com/reference/v1-searchandising-create-or-replace-refined-filter.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_filters(w)`, `facets.refined_filters(w)`. Create or replace a refined filter. It will replace all existing rules associated with the specified `filter_name` and `filter_value` if there are any. It will also flip `allow_automatic_rules` to `true` (which is default) if attribute's value isn't submitted in the request. - [Update refined filter](https://docs.constructor.com/reference/v1-searchandising-update-refined-filter.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_filters(w)`. Update a refined filter. It will update only the fields that are present in the request. - [Delete refined filter](https://docs.constructor.com/reference/v1-searchandising-delete-refined-filter.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_filters(w)`. Delete a refined filter. - [Retrieve refined filter rules](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-filter-rules.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_filters(r)`. Retrieve all refined filter rules. - [Delete refined filter rules](https://docs.constructor.com/reference/v1-searchandising-delete-refined-filter-rules.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(w)`, `searchandising.refined_filters(w)`. Delete all refined filter rules. - [Searchandising for Collections](https://docs.constructor.com/reference/searchandising-searchandising-for-collections.md) - [Retrieve refined collections](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-collections.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_collections(r)`. Retrieve all refined collections. - [Retrieve refined collection](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_collections(r)`. Retrieve a refined collection. - [Create or replace refined collection](https://docs.constructor.com/reference/v1-searchandising-create-or-replace-refined-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_collections(w)`. Create or replace a refined collection. It will replace all existing rules associated with the collection if there are any. It will also flip `allow_automatic_rules` to `true` (which is default) if attribute's value isn't submitted in the request. - [Update refined collection](https://docs.constructor.com/reference/v1-searchandising-update-refined-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_collections(w)`. Update a refined collection. It will update only the fields that are present in the request. - [Delete refined collection](https://docs.constructor.com/reference/v1-searchandising-delete-refined-collection.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_collections(w)`. Delete a refined collection. - [Searchandising for Search](https://docs.constructor.com/reference/searchandising-searchandising-for-search.md) - [Retrieve refined queries](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-queries.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_queries(r)`, `searchandising.refined_queries(r)`. Retrieve all refined queries. - [Create refined query](https://docs.constructor.com/reference/v1-searchandising-create-refined-query.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_queries(w)`, `facets.refined_queries(w)`. Create a new refined query. - [Retrieve refined query](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-query.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_queries(r)`, `searchandising.refined_queries(r)`. Retrieve a refined query. - [Replace refined query](https://docs.constructor.com/reference/v1-searchandising-replace-refined-query.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_queries(w)`, `facets.refined_queries(w)`. Replace a refined query. It will replace all existing rules associated with the specified refined query if there are any. It will also flip `allow_automatic_rules` to `true` (which is default) if attribute's value isn't submitted in the request. - [Update refined query](https://docs.constructor.com/reference/v1-searchandising-update-refined-query.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_queries(w)`. Update a refined query. It will update only the fields that are present in the request. - [Delete refined query](https://docs.constructor.com/reference/v1-searchandising-delete-refined-query.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_queries(w)`. Delete a refined query. - [Searchandising by User Request Data](https://docs.constructor.com/reference/searchandising-searchandising-by-user-request-data.md) - [Retrieve refined tag](https://docs.constructor.com/reference/v1-searchandising-retrieve-refined-tag.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_tags(r)`. Retrieve a refined tag. - [Create or replace refined tag](https://docs.constructor.com/reference/v1-searchandising-create-or-replace-refined-tag.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_tags(w)`. Create or replace a refined tag. It will replace all existing rules associated with the specified `tag_name` and `tag_value` if there are any. It will also flip `allow_automatic_rules` to `true` (which is default) if attribute's value isn't submitted in the request. - [Update refined tag](https://docs.constructor.com/reference/v1-searchandising-update-refined-tag.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_tags(w)`. Update a refined tag. It will update only the fields that are present in the request. - [Delete refined tag](https://docs.constructor.com/reference/v1-searchandising-delete-refined-tag.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_tags(w)`. Delete a refined tag. - [Retrieve refined tags](https://docs.constructor.com/reference/v1-searchandising-retreive-refined-tags.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.refined_tags(r)`. Retrieve all refined tags - [Retrieve campaigns](https://docs.constructor.com/reference/v1-searchandising-retrieve-campaigns.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.campaigns(r)`, `searchandising.recommendations(r)`. Retrieve campaigns. - [Create campaign](https://docs.constructor.com/reference/v1-searchandising-create-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.campaigns(w)`, `searchandising.recommendations(w)`. Create a campaign. - [Retrieve campaign](https://docs.constructor.com/reference/v1-searchandising-retrieve-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.campaigns(r)`, `searchandising.recommendations(r)`. Retrieve a campaign by id. - [Update campaign](https://docs.constructor.com/reference/v1-searchandising-update-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.campaigns(w)`, `searchandising.recommendations(w)`. Update a campaign. It will update only the fields that are present in the request. - [Delete campaign](https://docs.constructor.com/reference/v1-searchandising-delete-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `searchandising.campaigns(w)`, `searchandising.recommendations(w)`. Delete a campaign by id. - [Retrieve facet campaigns](https://docs.constructor.com/reference/v1-searchandising-retrieve-facet-rule-campaigns.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(r)`, `facets.refined_queries(r)`. Retrieve facet campaigns. - [Create facet campaign](https://docs.constructor.com/reference/v1-searchandising-create-facet-rule-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(w)`, `facets.refined_queries(w)`. Create a facet campaign - [Retrieve facet campaign](https://docs.constructor.com/reference/v1-searchandising-get-facet-rule-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(r)`, `facets.refined_queries(r)`. Retrieve a facet campaign by id. - [Update facet campaign](https://docs.constructor.com/reference/v1-searchandising-update-facet-rule-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(w)`, `facets.refined_queries(w)`. Update a facet campaign. It will update only the fields that are present in the request. - [Delete facet campaign](https://docs.constructor.com/reference/v1-searchandising-delete-facet-rule-campaign.md): **๐Ÿ” This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).** For authenticating with Bearer token, required scopes are: `facets.refined_filters(w)`, `facets.refined_queries(w)`. Delete a facet campaign by id. - [Post a list of offline behavioral actions](https://docs.constructor.com/reference/v1-offline-behavioral-actions-create-actions.md): **๐Ÿ” This endpoint requires [HTTP Basic authentication](https://docs.constructor.com/reference/main-authentication#basic-authentication).** Send list of behavioral actions (purchase,return) performed by your users offline. - [User preferences](https://docs.constructor.com/reference/user-profile-user-preferences.md) - [Create user preferences](https://docs.constructor.com/reference/v1-user-profile-create-preferences.md): **๐Ÿ” This endpoint requires [HTTP Bearer authentication](https://docs.constructor.com/reference/main-authentication#bearer-authentication).** For authenticating with Bearer token, required scopes are: `user_profile.user_preferences(w)`. Send user preferences for both individual and batch operations.